OpenCL 图像描述符

在clCreateImage()函数中,参数image_desc指向cl_image_desc结构的指针。cl_image_desc图像描述符描述了图像或图像阵列的类型和位数。cl_image_desc结构定义如下:

typedef 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;
cl_mem mem_object;
} cl_image_desc;

image_type为图像类型,必须是图像格式描述符中列出的图像类型。

image_width为图像的宽度,单位为像素。对于2维图像和图像阵列,图像宽度必须小于CL_DEVICE_IMAGE2D_MAX_WIDTH。对于3维图像,图像宽度必须小于CL_DEVICE_IMAGE3D_MAX_WIDTH。对于1维图像缓冲,图像宽度必须小于CL_DEVICE_IMAGE_MAX_BUFFER_SIZE。对于1维图像和1维图像阵列,图像宽度必须小于CL_DEVICE_IMAGE2D_MAX_WIDTH。

image_height为图像高度,单位为像素。只对2维或3维图像,或2维图像阵列才有效。对于2维图像或图像阵列,图像高度必须小于CL_DEIVCE_IMAGE2D_MAX_HEIGHT。对于3维图像,图像高度必须小于CL_DEVICE_IMAGE3D_MAX_HEIGHT。

image_depth为图像深度,单位为像素。只有图像为3维图像时才有效,其值必须小于CL_DEVICE_IMAGE3D_MAX_DEPTH。

image_array_size为图像阵列中的图像个数。只有图像为1维或者2维图像时才有效。如果设置了image_array_size,其值必须小于CL_DEVICE_IMAGE_ARRAY_SIZE,大于等于1。

image_row_pitch为扫描列间隔,单位为字节。如果host_ptr为NULL,则其值必须是0,如果host_ptr不是NULL,则其值可以为0或者大于等于image_width乘以元素大小;如果host_ptr不是NULL,并且image_row_pitch=0,则用image_width乘以元素大小取代image_row_pitch。如果image_row_pitch不为0,则必须是图像像素所占字节数的整数倍。

image_slice_pitch为3维图像中每个2维平面的大小,或者1维、2维图像阵列中每个图像的大小,单位为字节。如果host_ptr为NULL,其值必须是0;如果host_ptr不是NULL,对于2维图像阵列或者3维图像,可以是0或者大于等于image_row_pitch*image_height;对于1维图像阵列,可以是0或者大于等于image_row_pitch。如果host_ptr不是NULL,并且image_slice_pitch=0,对于2维图像阵列或3维图像,则用image_row_pitch*image_height取代image_slice_pitch;对于1维图像阵列,则用image_row_pitch。如果image_slice_pitch不为0,则必须是image_row_pitch的整数倍。

num_mip_levels和num_samples必须为0。

mem_object为一个有效的缓冲区或图像存储器对象。如果图像类型为CL_MEM_OBJECT_IMAGE1D_BUFFER或CL_MEM_OBJECT_IMAGE2D(由一个缓冲区对象创建一个2维图像),则mem_object可以为一个缓冲存储器对象。如果图像类型为CL_MEM_OBJECT_IMAGE2D(由另一个图像对象创建一个图像对象),则mem_object可以为一个图像对象。对于其他情况,mem_object的值必须为NULL。

下图展示了一个3维图像对象。对于大部分图像,我们可以通过图像每行像素个数乘以像素元素大小来确定图像的行间距。但是为了在内存边界对齐,会在每行末尾填充位数,在这种情况下就没办法使用上述办法来计算图像行间距。所以在cl_image_desc结构体中有image_row_pitch成员,用来表示图像每一行的大小。类似地,在cl_image_desc结构体中有image_slice_pitch成员,用来表示每个2维平面的大小。

3维图像对象

如下代码展示了根据图像描述符和图像格式描述符创建一个2维图像:

//图像描述符
cl_image_desc desc;
memset(&desc, 0, sizeof(desc));
desc.image_type = CL_MEM_OBJECT_IMAGE2D;
desc.image_width = 100;
desc.image_height = 100;
//图像格式描述符
cl_image_format rgb_format;
rgb_format.image_channel_order = CL_RGB;
rgb_format.image_channel_data_type = CL_UNSIGNED_INT8;
cl_mem d_inputImage = clCreateImage(context, CL_MEM_READ_ONLY,
                                          &rgb_format, &desc, NULL, &status);

赞(0)
未经允许不得转载:极客笔记 » OpenCL 图像描述符

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
OpenCL 基本概念
OpenCL 是什么OpenCL 平台模型OpenCL 执行模型OpenCL 上下文简介OpenCL 命令队列简介OpenCL 在设备上执行内核OpenCL 存储器区域OpenCL 存储器对象OpenCL 共享虚拟存储器OpenCL 与OpenGL
OpenCL 基础教程
OpenCL 在Windows上搭建开发环境OpenCL 在Linux上搭建开发环境OpenCL 在OS X上搭建开发环境OpenCL 第一个程序OpenCL 平台OpenCL 设备OpenCL 创建上下文OpenCL 创建命令队列OpenCL 创建Program对象OpenCL 编译Program对象OpenCL 查询和管理Program对象OpenCL 创建内核对象OpenCL 设置内核参数OpenCL 查询和管理内核对象OpenCL 执行内核OpenCL 编写内核代码OpenCL 错误处理
OpenCL C特性
OpenCL 地址空间修饰符OpenCL 函数修饰符OpenCL 对象访问修饰符OpenCL 标量数据类型OpenCL 为什么要有矢量数据类型OpenCL 矢量初始化OpenCL 读取和修改矢量分量OpenCL 运算符OpenCL 维度和工作项OpenCL 工作组OpenCL 矢量数据拷贝OpenCL 异步拷贝和预取OpenCL 数学函数OpenCL 公共函数OpenCL 几何函数OpenCL 整数函数OpenCL 关系函数OpenCL 杂项矢量函数OpenCL 同步函数OpenCL 原子函数OpenCL 内建图像读函数OpenCL 内建无采样器图像读函数OpenCL 内建图像写函数OpenCL 内建图像查询函数OpenCL 工作组函数OpenCL 内建管道读/写函数OpenCL 内建工作组管道读/写函数OpenCL 内建管道查询函数OpenCL 设备队列OpenCL Blocks语法OpenCL 设备队列相关函数OpenCL 子内核存储器可见性OpenCL 设备队列的使用示例
OpenCL 存储器对象
OpenCL 存储器对象OpenCL 分配缓冲区对象OpenCL 创建子缓冲区对象OpenCL 图像对象和采样器对象OpenCL 图像对象OpenCL 图像格式描述符OpenCL 图像描述符OpenCL 图像对象查询OpenCL 采样器对象OpenCL 主机端采样器对象OpenCL 设备端采样器对象OpenCL 图像旋转示例OpenCL 管道OpenCL 创建管道对象OpenCL 管道对象查询OpenCL 主机与设备间数据传输OpenCL 图像对象主机与设备间数据拷贝OpenCL 缓冲区对象数据填充OpenCL 图像对象数据填充OpenCL 缓冲区对象间数据传输OpenCL 图像对象和缓冲区对象间数据拷贝OpenCL 缓冲区对象映射OpenCL 图像对象映射OpenCL 解映射OpenCL 共享虚拟存储器OpenCL SVM缓冲创建与释放OpenCL SVM缓冲映射与解映射OpenCL SVM缓冲填充与拷贝OpenCL SVM类型OpenCL SVM特性OpenCL 共享虚拟存储器示例OpenCL 存储器一致性模型OpenCL 存储器次序规则OpenCL 原子操作的存储器次序规则OpenCL 栅栏操作的存储器次序规则OpenCL 工作组函数的存储器次序规则OpenCL 主机端与设备端命令的存储器次序规则OpenCL 关于存储器次序在实际OpenCL计算设备中的实现
OpenCL 同步及事件机制
OpenCL 同步及事件机制OpenCL 主机端的OpenCL同步OpenCL OpenCL事件机制OpenCL 对OpenCL事件的标记和栅栏OpenCL 内核程序中的同步OpenCL 工作组内同步OpenCL 原子操作OpenCL 1.2中的原子操作OpenCL 2.0中的原子操作OpenCL 局部存储器与全局存储器间的异步拷贝OpenCL 工作组间同步
OpenCL 与OpenGL互操作
OpenCL 与OpenGL互操作OpenCL 从一个OpenGL上下文来创建OpenCL上下文OpenCL 使用OpenGL共享的缓存对象OpenCL 使用OpenGL纹理数据OpenCL 共享OpenGL渲染缓存OpenCL 从一个OpenCL存储器对象查询OpenGL对象信息OpenCL 访问共享对象的OpenCL与OpenGL之间的同步OpenCL AMD Cayman架构GPUOpenCL AMD GCN架构的GPUOpenCL NVIDIA CUDA兼容的GPUOpenCL NVIDIA GPU架构的执行模型OpenCL NVIDIA GPU的全局存储器OpenCL NVIDIA GPU的局部存储器OpenCL ARM Mali GPU硬件架构OpenCL ARM Mali GPU存储器层次OpenCL ARM Mali GPU OpenCL映射