cl::sycl::image< kDimensions, AllocatorT > Class Template Reference
#include <image.h>
Public Member Functions | |
image (const image< kDimensions, AllocatorT > &)=default | |
Copy constructor. More... | |
image (image< kDimensions, AllocatorT > &&rhs)=default | |
Move Constructor. More... | |
image< kDimensions, AllocatorT > & | operator= (const image< kDimensions, AllocatorT > &rhs)=default |
Copy assignment.Copies the image descriptor of the original image. More... | |
image< kDimensions, AllocatorT > & | operator= (image< kDimensions, AllocatorT > &&rhs)=default |
Move Assignment. More... | |
image (cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with no host pointer, performing device side allocation of the buffer, this means that on destruction the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used. More... | |
image (cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, AllocatorT allocator, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with no host pointer, performing device side allocation of the buffer, this means that on destruction the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used. More... | |
template<COMPUTECPP_ENABLE_IF(kdims_t,(kDimensions > 1)) > | |
image (cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const pitch_range_t &pit, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with no host pointer, performing device side allocation of the buffer, this means that on destruction the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used. More... | |
template<COMPUTECPP_ENABLE_IF(kdims_t,(kDimensions > 1)) > | |
image (cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const pitch_range_t &pit, AllocatorT allocator, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with no host pointer, performing device side allocation of the buffer, this means that on destruction the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used. More... | |
image (void *hostPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with a raw host pointer to the image data. More... | |
image (void *hostPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, AllocatorT allocator, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with a raw host pointer to the image data. More... | |
image (const void *hostPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with a constant raw host pointer to the image data. More... | |
image (const void *hostPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, AllocatorT allocator, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with a raw host pointer to the image data. More... | |
template<COMPUTECPP_ENABLE_IF(kdims_t,(kDimensions > 1)) > | |
image (void *hostPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const pitch_range_t &pit, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type, range and pitch, with a raw host pointer to the image data. More... | |
template<COMPUTECPP_ENABLE_IF(kdims_t,(kDimensions > 1)) > | |
image (void *hostPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const pitch_range_t &pit, AllocatorT allocator, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type, range and pitch, with a raw host pointer to the image data. More... | |
image (shared_ptr_class< void > sharedPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with a shared host pointer to the image data. More... | |
image (shared_ptr_class< void > sharedPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, AllocatorT allocator, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type and range, with a shared host pointer to the image data. More... | |
template<COMPUTECPP_ENABLE_IF(kdims_t,(kDimensions > 1)) > | |
image (shared_ptr_class< void > sharedPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const pitch_range_t &pit, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type, range and pitch, with a shared host pointer to the image data. More... | |
template<COMPUTECPP_ENABLE_IF(kdims_t,(kDimensions > 1)) > | |
image (shared_ptr_class< void > sharedPtr, cl::sycl::image_channel_order order, cl::sycl::image_channel_type type, const range< kDimensions > &rng, const pitch_range_t &pit, AllocatorT allocator, const property_list &propList={}) | |
Construct an image of the specified channel_order and channel_type, range and pitch, with a shared host pointer to the image data. More... | |
image (cl_mem memObject, const context &syclContext, event availableEvent={}) | |
template<typename T , access::mode accessMode> | |
COMPUTECPP_SET_IGNORE_DEPRECATED_API accessor< T, kDimensions, accessMode, access::target::host_image > | get_access () |
Create an accessor to the image. More... | |
template<typename T , access::mode accessMode> | |
accessor< T, kDimensions, accessMode, access::target::image > | get_access (handler &cgh) |
Create an accessor to the image for command group handler. More... | |
template<int dims = kDimensions, class = typename std::enable_if<(2 == dims) || (3 == dims)>::type> | |
range< dims - 1 > | get_pitch () const |
Returns the pitch of the image object. More... | |
cl::sycl::range< kDimensions > | get_range () const |
template<typename propertyT > | |
bool | has_property () const noexcept |
Returns whether this SYCL image was constructed with the property specified by propertyT. More... | |
template<typename propertyT > | |
propertyT | get_property () const |
Returns a copy of the property of type propertyT that this SYCL image was constructed with. More... | |
AllocatorT | get_allocator () const |
Returns the allocator provided to the image. More... | |
Friends | |
bool | operator== (const image &lhs, const image &rhs) |
Determines if lhs and rhs are equal. More... | |
bool | operator!= (const image &lhs, const image &rhs) |
Determines if lhs and rhs are not equal. More... | |
Detailed Description
template<int kDimensions = 1, typename AllocatorT = image_allocator>
class cl::sycl::image< kDimensions, AllocatorT >
Constructor & Destructor Documentation
◆ image() [1/17]
|
default |
Copy constructor.
Copy the image descriptor of the original image. After the copy, both image object will point to the same underlying memory.
◆ image() [2/17]
|
default |
Move Constructor.
Moves the image descriptor of the original image. After the move, rhs will be invalid.
◆ image() [3/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with no host pointer, performing device side allocation of the buffer, this means that on destruction the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the allocator specified by AllocatorT.
- Parameters
-
order Image channel order. type Image channel type. rng Image range. propList List of image properties
◆ image() [4/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with no host pointer, performing device side allocation of the buffer, this means that on destruction the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the provided allocator.
- Parameters
-
order Image channel order. type Image channel type. rng Image range. allocator The allocator used to create internal storage propList List of image properties
◆ image() [5/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with no host pointer, performing device side allocation of the buffer, this means that on destruction the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the allocator specified by AllocatorT.
- Template Parameters
-
COMPUTECPP_ENABLE_IF Only enabled when kDimensions greater than 1
- Parameters
-
order Image channel order. type Image channel type. rng Image range. pit Image pitch. propList List of image properties
◆ image() [6/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with no host pointer, performing device side allocation of the buffer, this means that on destruction the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the provided allocator.
- Template Parameters
-
COMPUTECPP_ENABLE_IF Only enabled when kDimensions greater than 1
- Parameters
-
order Image channel order. type Image channel type. rng Image range. pit Image pitch. allocator The allocator used to create internal storage propList List of image properties
◆ image() [7/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with a raw host pointer to the image data.
On object destruction, the data will be copied to the specified host pointer unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the allocator specified by AllocatorT.
- Parameters
-
hostPtr Raw pointer to the image data. order Image channel order. type Image channel type. rng Image range. propList List of image properties
◆ image() [8/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with a raw host pointer to the image data.
On object destruction, the data will be copied to the specified host pointer unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the provided allocator.
- Parameters
-
hostPtr Raw pointer to the image data. order Image channel order. type Image channel type. rng Image range. allocator The allocator used to create internal storage propList List of image properties
◆ image() [9/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with a constant raw host pointer to the image data.
On object destruction, the data will not be copied back, unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the allocator specified by AllocatorT.
- Parameters
-
hostPtr Raw pointer to the image data. order Image channel order. type Image channel type. rng Image range. propList List of image properties
◆ image() [10/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with a raw host pointer to the image data.
On object destruction, the data will not be copied back unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the provided allocator.
- Parameters
-
hostPtr Raw pointer to the image data. order Image channel order. type Image channel type. rng Image range. allocator The allocator used to create internal storage propList List of image properties
◆ image() [11/17]
|
inline |
Construct an image of the specified channel_order and channel_type, range and pitch, with a raw host pointer to the image data.
On object destruction, the data will be copied to the specified host pointer unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the allocator specified by AllocatorT.
- Template Parameters
-
COMPUTECPP_ENABLE_IF Only enabled when kDimensions greater than 1
- Parameters
-
hostPtr Raw pointer to the image data. order Image channel order. type Image channel type. rng Image range. pit Image pitch. propList List of image properties
◆ image() [12/17]
|
inline |
Construct an image of the specified channel_order and channel_type, range and pitch, with a raw host pointer to the image data.
On object destruction, the data will be copied to the specified host pointer unless a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the provided allocator.
- Template Parameters
-
COMPUTECPP_ENABLE_IF Only enabled when kDimensions greater than 1
- Parameters
-
hostPtr Raw pointer to the image data. order Image channel order. type Image channel type. rng Image range. pit Image pitch. allocator The allocator used to create internal storage propList List of image properties
◆ image() [13/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with a shared host pointer to the image data.
The host pointer's ownership is shared and on destruction the data will be copied to the specified host pointer unless the runtime maintains the last reference to the shared_ptr or a final pointer is specified using set_final_data() in which case that specified pointer will be used. Any host side allocation of data will be performed using the allocator specified by AllocatorT.
- Parameters
-
sharedPtr shared pointer to the image data. order Image channel order. type Image channel type. rng Image range. allocator The allocator used to create internal storage propList List of image properties
◆ image() [14/17]
|
inline |
Construct an image of the specified channel_order and channel_type and range, with a shared host pointer to the image data.
The host pointer's ownership is shared and on destruction the data will be copied to the specified host pointer unless the runtime maintains the last reference to the shared_ptr or a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the provided allocator.
- Parameters
-
sharedPtr shared pointer to the image data. order Image channel order. type Image channel type. rng Image range. allocator The allocator used to create internal storage propList List of image properties
◆ image() [15/17]
|
inline |
Construct an image of the specified channel_order and channel_type, range and pitch, with a shared host pointer to the image data.
The host pointer's ownership is shared and on destruction the data will be copied to the specified host pointer unless the runtime maintains the last reference to the shared_ptr or a final pointer is specified using set_final_data() in which case that specified pointer will be used. Any host side allocation of data will be performed using the allocator specified by AllocatorT.
- Template Parameters
-
COMPUTECPP_ENABLE_IF Only enabled when kDimensions greater than 1
- Parameters
-
sharedPtr Shared pointer to the image data. order Image channel order. type Image channel type. rng Image range. pit Image pitch. propList List of image properties
◆ image() [16/17]
|
inline |
Construct an image of the specified channel_order and channel_type, range and pitch, with a shared host pointer to the image data.
The host pointer's ownership is shared and on destruction the data will be copied to the specified host pointer unless the runtime maintains the last reference to the shared_ptr or a final pointer is specified using set_final_data() in which case that specified pointer will be used.
Any host side allocation of data will be performed using the provided allocator.
- Template Parameters
-
COMPUTECPP_ENABLE_IF Only enabled when kDimensions greater than 1
- Parameters
-
sharedPtr Shared pointer to the image data. order Image channel order. type Image channel type. rng Image range. pit Image pitch. allocator The allocator used to create internal storage propList List of image properties
◆ image() [17/17]
|
inline |
Member Function Documentation
◆ get_access() [1/2]
|
inline |
◆ get_access() [2/2]
|
inline |
◆ get_allocator()
|
inline |
◆ get_pitch()
|
inline |
◆ get_property()
|
inline |
◆ get_range()
|
inline |
◆ has_property()
|
inlinenoexcept |
◆ operator=() [1/2]
|
default |
Copy assignment.Copies the image descriptor of the original image.
After the copy, both image object will point to the same underlying memory.
◆ operator=() [2/2]
|
default |
Move Assignment.
Moves the image descriptor of the original image. After the move, rhs will be invalid.
Friends And Related Function Documentation
◆ operator!=
◆ operator==
The documentation for this class was generated from the following file: