XGetSubImage(获取子图像)
语法
X图像*XGet子图像(显示,d日,x个,年,宽度,高度,平面_任务,格式,目标映像(_I),目标x,目标(_y))显示器*显示;可提取d日;整数x个,年;无符号整型宽度,高度;无符号长平面_任务;整数格式;X图像*目标映像(_I);整数目标x,目标(_y);
论据
显示
| 指定到X服务器的连接。 |
d日
| 指定可绘制的图形。 |
x个
年
| 指定相对于可绘制图形原点的x和y坐标,并定义矩形的左上角。 |
宽度
高度
| 指定子图像的宽度和高度,用于定义矩形的尺寸。 |
平面_任务
| 指定平面遮罩。 |
格式
| 指定图像的格式。你可以通过XY像素映射或ZPixmap地图. |
目标映像(_I)
| 指定目标图像。 |
目标x
目标(_y)
| 指定相对于目标矩形原点的x和y坐标,指定其左上角,并确定子图像在目标图像中的位置。 |
描述
这个XGetSubImage()函数使用指定的子映像更新dest_image,方法与获取图像(). 如果格式参数为XY像素映射,该图像仅包含传递给planemask参数的位平面。如果格式参数为ZPixmap地图,XGetSubImage()将所有平面中的位返回为零在planemask参数中指定。该函数不对plane_mask中的值执行范围检查,并忽略多余的比特。为了方便起见,XGetSubImage()返回指向相同对象的指针X图像由dest_image指定的结构。目的地的深度X图像结构必须与拉拔件的结构相同。如果指定的子图像不适合指定的位置在目标图像上,右边缘和下边缘被剪裁。如果绘图是一个像素映射,给定的矩形必须完全包含在像素映射中,或aBadMatch(错误匹配)错误结果。如果抽屉是窗户,窗口必须可见,如果没有低级或重叠的窗户,窗口的指定矩形将在屏幕上完全可见并且完全包含在窗口的外边缘内,或aBadMatch(错误匹配)错误结果。如果窗口有后台存储,然后返回窗口区域的后台存储内容被不低级的窗户遮住的。如果窗口没有后台存储,此类模糊区域的返回内容未定义。下级可见区域的返回内容与指定窗口的深度不同的深度也未定义。如果出现问题,XGetSubImage()返回NULL。
XGetSubImage()可以生成不良可提取,BadGC公司,BadMatch(错误匹配),和BadValue(错误值)错误。
诊断
不良可提取
| Drawable参数的值未命名定义的窗口或像素映射。 |
BadGC公司
| 的值G上下文参数未命名已定义的G上下文. |
BadMatch(错误匹配)
| 安仅输入窗口用作Drawable。 |
BadMatch(错误匹配)
| 某些参数或参数对具有正确的类型和范围,但失败以请求所需的其他方式匹配。 |
BadValue(错误值)
| 某些数值超出了请求接受的值范围。除非为参数指定了特定范围,否则定义的完整范围参数的类型被接受。定义为一组的任何参数替代方案可能会产生此错误。 |
另请参见
XAddPixel(),X创建图像(),XDestroyImage()(X雌激素图像),获取像素(),XInitImage(),X输出图像(),X像素(),"在客户端和服务器之间传输图像".
克里斯托弗·特隆奇,ch@tronche.com(中文)