X创建图像

语法

X图像*X创建图像(显示,视觉的,深度,格式,抵消,数据,宽度,高度,位图pad,字节行)显示器*显示；视觉*视觉的；无符号整型深度；整数格式；整数抵消；字符*数据；无符号整型宽度；无符号整型高度；整数位图pad；整数字节行；

论据

显示	指定到X服务器的连接。
视觉的	指定视觉结构。
深度	指定图像的深度。
格式	指定图像的格式。你可以通过XY位图,XY像素映射,或ZPixmap地图.
抵消	指定扫描线开始处要忽略的像素数。
数据	指定图像数据。
宽度	指定图像的宽度（以像素为单位）。
高度	指定图像的高度（以像素为单位）。
位图pad	指定扫描线的量子（8、16或32）。换句话说，一条扫描线的开始在客户机内存中与下一条扫描线的开始是这许多位的整数倍。
字节行	指定客户端映像中介于一条扫描线的开始和下一条的开始。

描述

这个X创建图像（）函数分配X图像的结构指定的显示，但不为图像本身分配空间。相反，它初始化结构字节顺序、位顺序和位图单元值，并返回指向X图像结构。红色、绿色和蓝色遮罩值仅为Z格式图像定义和派生自视觉传入的结构。其他值也会传入。偏移允许快速显示图像，而无需每个扫描线移动到位。如果在bytes_per_line中传递零值，Xlib假设扫描线是连续的并计算字节perline本身的值。

请注意，当使用创建图像时X创建图像（）,获取图像（）,或XSubImage（）,the destroy procedure that theX破坏图像（）函数调用释放图像结构以及图像结构所指向的数据。

另请参见

XAddPixel（）,XDestroyImage（）（X雌激素图像）,获取像素（）,X像素（）,XSubImage（）,"操作图像".

克里斯托弗·特隆奇,ch@tronche.com（中文）