Class CLImageDesc
- All Implemented Interfaces:
AutoCloseable,org.lwjgl.system.NativeResource,org.lwjgl.system.Pointer
Layout
struct cl_image_desc {
cl_mem_object_type image_type();
size_t image_width();
size_t image_height();
size_t image_depth();
size_t image_array_size();
size_t image_row_pitch();
size_t image_slice_pitch();
cl_uint num_mip_levels();
cl_uint num_samples();
union {
cl_mem buffer();
cl_mem mem_object();
};
}-
Nested Class Summary
Nested ClassesNested classes/interfaces inherited from class org.lwjgl.system.Struct
org.lwjgl.system.Struct.StructValidationNested classes/interfaces inherited from interface org.lwjgl.system.Pointer
org.lwjgl.system.Pointer.Default -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final intThe struct alignment in bytes.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct size in bytes.Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE -
Constructor Summary
ConstructorsConstructorDescriptionCLImageDesc(ByteBuffer container) Creates aCLImageDescinstance at the current position of the specifiedByteBuffercontainer. -
Method Summary
Modifier and TypeMethodDescriptionlongbuffer()alias formem_objectbuffer(long value) Sets the specified value to thebuffer()field.static CLImageDesccalloc()Returns a newCLImageDescinstance allocated withmemCalloc.static CLImageDesc.Buffercalloc(int capacity) Returns a newCLImageDesc.Bufferinstance allocated withmemCalloc.static CLImageDesc.Buffercalloc(int capacity, org.lwjgl.system.MemoryStack stack) Returns a newCLImageDesc.Bufferinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.static CLImageDesccalloc(org.lwjgl.system.MemoryStack stack) Returns a newCLImageDescinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.static CLImageDescDeprecated.static CLImageDesc.BuffercallocStack(int capacity) Deprecated.static CLImageDesc.BuffercallocStack(int capacity, org.lwjgl.system.MemoryStack stack) Deprecated.static CLImageDesccallocStack(org.lwjgl.system.MemoryStack stack) Deprecated.static CLImageDesccreate()Returns a newCLImageDescinstance allocated withBufferUtils.static CLImageDesc.Buffercreate(int capacity) Returns a newCLImageDesc.Bufferinstance allocated withBufferUtils.static CLImageDesccreate(long address) Returns a newCLImageDescinstance for the specified memory address.static CLImageDesc.Buffercreate(long address, int capacity) Create aCLImageDesc.Bufferinstance at the specified memory.static @Nullable CLImageDesccreateSafe(long address) static @Nullable CLImageDesc.BuffercreateSafe(long address, int capacity) longthe number of images in the image array.image_array_size(long value) Sets the specified value to theimage_array_size()field.longthe depth of the image in pixels.image_depth(long value) Sets the specified value to theimage_depth()field.longthe height of the image in pixels.image_height(long value) Sets the specified value to theimage_height()field.longthe scan-line pitch in bytes.image_row_pitch(long value) Sets the specified value to theimage_row_pitch()field.longthe size in bytes of each 2D slice in the 3D image or the size in bytes of each image in a 1D or 2D image array.image_slice_pitch(long value) Sets the specified value to theimage_slice_pitch()field.intdescribes the image typeimage_type(int value) Sets the specified value to theimage_type()field.longthe width of the image in pixels.image_width(long value) Sets the specified value to theimage_width()field.static CLImageDescmalloc()Returns a newCLImageDescinstance allocated withmemAlloc.static CLImageDesc.Buffermalloc(int capacity) Returns a newCLImageDesc.Bufferinstance allocated withmemAlloc.static CLImageDesc.Buffermalloc(int capacity, org.lwjgl.system.MemoryStack stack) Returns a newCLImageDesc.Bufferinstance allocated on the specifiedMemoryStack.static CLImageDescmalloc(org.lwjgl.system.MemoryStack stack) Returns a newCLImageDescinstance allocated on the specifiedMemoryStack.static CLImageDescDeprecated.static CLImageDesc.BuffermallocStack(int capacity) Deprecated.static CLImageDesc.BuffermallocStack(int capacity, org.lwjgl.system.MemoryStack stack) Deprecated.static CLImageDescmallocStack(org.lwjgl.system.MemoryStack stack) Deprecated.longrefers to a valid buffer or image memory object.mem_object(long value) Sets the specified value to themem_object()field.static longnbuffer(long struct) Unsafe version ofbuffer().static voidnbuffer(long struct, long value) Unsafe version ofbuffer.static longnimage_array_size(long struct) Unsafe version ofimage_array_size().static voidnimage_array_size(long struct, long value) Unsafe version ofimage_array_size.static longnimage_depth(long struct) Unsafe version ofimage_depth().static voidnimage_depth(long struct, long value) Unsafe version ofimage_depth.static longnimage_height(long struct) Unsafe version ofimage_height().static voidnimage_height(long struct, long value) Unsafe version ofimage_height.static longnimage_row_pitch(long struct) Unsafe version ofimage_row_pitch().static voidnimage_row_pitch(long struct, long value) Unsafe version ofimage_row_pitch.static longnimage_slice_pitch(long struct) Unsafe version ofimage_slice_pitch().static voidnimage_slice_pitch(long struct, long value) Unsafe version ofimage_slice_pitch.static intnimage_type(long struct) Unsafe version ofimage_type().static voidnimage_type(long struct, int value) Unsafe version ofimage_type.static longnimage_width(long struct) Unsafe version ofimage_width().static voidnimage_width(long struct, long value) Unsafe version ofimage_width.static longnmem_object(long struct) Unsafe version ofmem_object().static voidnmem_object(long struct, long value) Unsafe version ofmem_object.static intnnum_mip_levels(long struct) Unsafe version ofnum_mip_levels().static voidnnum_mip_levels(long struct, int value) Unsafe version ofnum_mip_levels.static intnnum_samples(long struct) Unsafe version ofnum_samples().static voidnnum_samples(long struct, int value) Unsafe version ofnum_samples.intmust be 0num_mip_levels(int value) Sets the specified value to thenum_mip_levels()field.intmust be 0num_samples(int value) Sets the specified value to thenum_samples()field.set(CLImageDesc src) Copies the specified struct data to this struct.intsizeof()Methods inherited from class org.lwjgl.system.Struct
clear, free, isNull, validate, validateMethods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toStringMethods inherited from interface org.lwjgl.system.NativeResource
close, free
-
Field Details
-
SIZEOF
public static final int SIZEOFThe struct size in bytes. -
ALIGNOF
public static final int ALIGNOFThe struct alignment in bytes. -
IMAGE_TYPE
public static final int IMAGE_TYPEThe struct member offsets. -
IMAGE_WIDTH
public static final int IMAGE_WIDTHThe struct member offsets. -
IMAGE_HEIGHT
public static final int IMAGE_HEIGHTThe struct member offsets. -
IMAGE_DEPTH
public static final int IMAGE_DEPTHThe struct member offsets. -
IMAGE_ARRAY_SIZE
public static final int IMAGE_ARRAY_SIZEThe struct member offsets. -
IMAGE_ROW_PITCH
public static final int IMAGE_ROW_PITCHThe struct member offsets. -
IMAGE_SLICE_PITCH
public static final int IMAGE_SLICE_PITCHThe struct member offsets. -
NUM_MIP_LEVELS
public static final int NUM_MIP_LEVELSThe struct member offsets. -
NUM_SAMPLES
public static final int NUM_SAMPLESThe struct member offsets. -
BUFFER
public static final int BUFFERThe struct member offsets. -
MEM_OBJECT
public static final int MEM_OBJECTThe struct member offsets.
-
-
Constructor Details
-
CLImageDesc
Creates aCLImageDescinstance at the current position of the specifiedByteBuffercontainer. Changes to the buffer's content will be visible to the struct instance and vice versa.The created instance holds a strong reference to the container object.
-
-
Method Details
-
sizeof
public int sizeof()- Specified by:
sizeofin classorg.lwjgl.system.Struct<CLImageDesc>
-
image_type
public int image_type()describes the image type -
image_width
public long image_width()the width of the image in pixels. For a 2D image and image array, the image width must be ≤DEVICE_IMAGE2D_MAX_WIDTH. For a 3D image, the image width must be ≤DEVICE_IMAGE3D_MAX_WIDTH. For a 1D image buffer, the image width must be ≤DEVICE_IMAGE_MAX_BUFFER_SIZE. For a 1D image and 1D image array, the image width must be ≤DEVICE_IMAGE2D_MAX_WIDTH. -
image_height
public long image_height()the height of the image in pixels. This is only used if the image is a 2D, 3D or 2D image array. For a 2D image or image array, the image height must be ≤DEVICE_IMAGE2D_MAX_HEIGHT. For a 3D image, the image height must be ≤DEVICE_IMAGE3D_MAX_HEIGHT. -
image_depth
public long image_depth()the depth of the image in pixels. This is only used if the image is a 3D image and must be a value ≥ 1 and ≤DEVICE_IMAGE3D_MAX_DEPTH. -
image_array_size
public long image_array_size()the number of images in the image array. This is only used if the image is a 1D or 2D image array. The values forimage_array_size, if specified, must be a value ≥ 1 and ≤DEVICE_IMAGE_MAX_ARRAY_SIZE.Note that reading and writing 2D image arrays from a kernel with
image_array_size = 1may be lower performance than 2D images. -
image_row_pitch
public long image_row_pitch()the scan-line pitch in bytes. This must be 0 ifhost_ptrisNULLand can be either 0 or ≥image_width * sizeof element in bytes ifhost_ptris notNULL. Ifhost_ptris notNULLandimage_row_pitch = 0,image_row_pitchis calculated asimage_width * sizeof element in bytes. Ifimage_row_pitchis not 0, it must be a multiple of the image element size in bytes. -
image_slice_pitch
public long image_slice_pitch()the size in bytes of each 2D slice in the 3D image or the size in bytes of each image in a 1D or 2D image array. This must be 0 ifhost_ptrisNULL. Ifhost_ptris notNULL,image_slice_pitchcan be either 0 or ≥image_row_pitch * image_heightfor a 2D image array or 3D image and can be either 0 or ≥image_row_pitchfor a 1D image array. Ifhost_ptris notNULLandimage_slice_pitch = 0,image_slice_pitchis calculated asimage_row_pitch * image_heightfor a 2D image array or 3D image andimage_row_pitchfor a 1D image array. Ifimage_slice_pitchis not 0, it must be a multiple of theimage_row_pitch. -
num_mip_levels
public int num_mip_levels()must be 0 -
num_samples
public int num_samples()must be 0 -
buffer
public long buffer()alias formem_object -
mem_object
public long mem_object()refers to a valid buffer or image memory object.mem_objectcan be a buffer memory object ifimage_typeisMEM_OBJECT_IMAGE1D_BUFFERorMEM_OBJECT_IMAGE2D.mem_objectcan be an image object ifimage_typeisMEM_OBJECT_IMAGE2D. Otherwise it must beNULL. The image pixels are taken from the memory object’s data store. When the contents of the specified memory object’s data store are modified, those changes are reflected in the contents of the image object and vice-versa at corresponding sychronization points. For a 1D image buffer object, theimage_width * sizeof element in bytes must be ≤ size of buffer object data store. For a 2D image created from a buffer, theimage_row_pitch * image_heightmust be ≤ size of buffer object data store. For an image object created from another image object, the values specified in the image descriptor except formem_objectmust match the image descriptor information associated withmem_object. -
image_type
Sets the specified value to theimage_type()field. -
image_width
Sets the specified value to theimage_width()field. -
image_height
Sets the specified value to theimage_height()field. -
image_depth
Sets the specified value to theimage_depth()field. -
image_array_size
Sets the specified value to theimage_array_size()field. -
image_row_pitch
Sets the specified value to theimage_row_pitch()field. -
image_slice_pitch
Sets the specified value to theimage_slice_pitch()field. -
num_mip_levels
Sets the specified value to thenum_mip_levels()field. -
num_samples
Sets the specified value to thenum_samples()field. -
buffer
Sets the specified value to thebuffer()field. -
mem_object
Sets the specified value to themem_object()field. -
set
Copies the specified struct data to this struct.- Parameters:
src- the source struct- Returns:
- this struct
-
malloc
Returns a newCLImageDescinstance allocated withmemAlloc. The instance must be explicitly freed. -
calloc
Returns a newCLImageDescinstance allocated withmemCalloc. The instance must be explicitly freed. -
create
Returns a newCLImageDescinstance allocated withBufferUtils. -
create
Returns a newCLImageDescinstance for the specified memory address. -
createSafe
-
malloc
Returns a newCLImageDesc.Bufferinstance allocated withmemAlloc. The instance must be explicitly freed.- Parameters:
capacity- the buffer capacity
-
calloc
Returns a newCLImageDesc.Bufferinstance allocated withmemCalloc. The instance must be explicitly freed.- Parameters:
capacity- the buffer capacity
-
create
Returns a newCLImageDesc.Bufferinstance allocated withBufferUtils.- Parameters:
capacity- the buffer capacity
-
create
Create aCLImageDesc.Bufferinstance at the specified memory.- Parameters:
address- the memory addresscapacity- the buffer capacity
-
createSafe
-
mallocStack
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(MemoryStack)instead. -
callocStack
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(MemoryStack)instead. -
mallocStack
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(MemoryStack)instead. -
callocStack
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(MemoryStack)instead. -
mallocStack
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(int, MemoryStack)instead. -
callocStack
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(int, MemoryStack)instead. -
mallocStack
@Deprecated public static CLImageDesc.Buffer mallocStack(int capacity, org.lwjgl.system.MemoryStack stack) Deprecated.Deprecated for removal in 3.4.0. Usemalloc(int, MemoryStack)instead. -
callocStack
@Deprecated public static CLImageDesc.Buffer callocStack(int capacity, org.lwjgl.system.MemoryStack stack) Deprecated.Deprecated for removal in 3.4.0. Usecalloc(int, MemoryStack)instead. -
malloc
Returns a newCLImageDescinstance allocated on the specifiedMemoryStack.- Parameters:
stack- the stack from which to allocate
-
calloc
Returns a newCLImageDescinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.- Parameters:
stack- the stack from which to allocate
-
malloc
Returns a newCLImageDesc.Bufferinstance allocated on the specifiedMemoryStack.- Parameters:
capacity- the buffer capacitystack- the stack from which to allocate
-
calloc
Returns a newCLImageDesc.Bufferinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.- Parameters:
capacity- the buffer capacitystack- the stack from which to allocate
-
nimage_type
public static int nimage_type(long struct) Unsafe version ofimage_type(). -
nimage_width
public static long nimage_width(long struct) Unsafe version ofimage_width(). -
nimage_height
public static long nimage_height(long struct) Unsafe version ofimage_height(). -
nimage_depth
public static long nimage_depth(long struct) Unsafe version ofimage_depth(). -
nimage_array_size
public static long nimage_array_size(long struct) Unsafe version ofimage_array_size(). -
nimage_row_pitch
public static long nimage_row_pitch(long struct) Unsafe version ofimage_row_pitch(). -
nimage_slice_pitch
public static long nimage_slice_pitch(long struct) Unsafe version ofimage_slice_pitch(). -
nnum_mip_levels
public static int nnum_mip_levels(long struct) Unsafe version ofnum_mip_levels(). -
nnum_samples
public static int nnum_samples(long struct) Unsafe version ofnum_samples(). -
nbuffer
public static long nbuffer(long struct) Unsafe version ofbuffer(). -
nmem_object
public static long nmem_object(long struct) Unsafe version ofmem_object(). -
nimage_type
public static void nimage_type(long struct, int value) Unsafe version ofimage_type. -
nimage_width
public static void nimage_width(long struct, long value) Unsafe version ofimage_width. -
nimage_height
public static void nimage_height(long struct, long value) Unsafe version ofimage_height. -
nimage_depth
public static void nimage_depth(long struct, long value) Unsafe version ofimage_depth. -
nimage_array_size
public static void nimage_array_size(long struct, long value) Unsafe version ofimage_array_size. -
nimage_row_pitch
public static void nimage_row_pitch(long struct, long value) Unsafe version ofimage_row_pitch. -
nimage_slice_pitch
public static void nimage_slice_pitch(long struct, long value) Unsafe version ofimage_slice_pitch. -
nnum_mip_levels
public static void nnum_mip_levels(long struct, int value) Unsafe version ofnum_mip_levels. -
nnum_samples
public static void nnum_samples(long struct, int value) Unsafe version ofnum_samples. -
nbuffer
public static void nbuffer(long struct, long value) Unsafe version ofbuffer. -
nmem_object
public static void nmem_object(long struct, long value) Unsafe version ofmem_object.
-