XCopyPlane(X复制平面)

语法

XCopyPlane(X复制平面)(显示,型钢混凝土,目的地,气相色谱法,src_x公司,服务器(_y),宽度,高度,目标x,目标(_y),飞机)显示器*显示;可提取型钢混凝土,目的地;GC公司 气相色谱法;整数src_x公司,服务器(_y);无符号整型宽度,高度;整数目标x,目标(_y);无符号长飞机;

论据

显示 指定到X服务器的连接。
型钢混凝土 目的地 指定要组合的源矩形和目标矩形。
气相色谱法 指定GC。
src_x公司 服务器(_y) 指定x和y坐标,相对于源矩形的原点并指定其左上角。
宽度 高度 指定宽度和高度,这是源矩形和目标矩形的尺寸。
目标x 目标(_y) 指定相对于目标矩形原点的x和y坐标,并指定其左上角。
飞机 指定位平面。您必须将一位精确设置为1。

描述

这个XCopyPlane()函数使用指定源矩形的单个位平面与指定的GC组合以修改dest的指定矩形。拉拔件必须具有相同的根部,但不必具有相同的深度。如果抽屉没有相同的根BadMatch(错误匹配)错误结果。如果平面没有精确地将一个位设置为1,并且平面的值不小于%2%,其中n个是src的深度,aBadValue(错误值)错误结果。

实际上,XCopyPlane()形成与dest的矩形深度相同的像素映射,并使用源区域指定的大小。它使用GC中的前景/背景像素(前景src中的位平面包含设置为1的位的所有位置,src中位平面包含设置为0的位的所有位置的背景)和等效的复制区域使用所有相同的公开语义执行协议请求。也可以认为这是使用源的指定区域位平面作为点画填充样式属于填充不透明点缀用于填充目的地的矩形区域。

此函数使用以下GC组件:功能,飞机蒙皮,前景,背景,子窗口模式,图形-曝光,clip-x原点,clip-y原点,剪辑-掩码.

XCopyPlane()可以生成不良可提取,BadGC公司,BadMatch(错误匹配),BadValue(错误值)错误。

诊断

不良可提取 Drawable参数的值未命名定义的窗口或像素映射。
BadGC公司 的值G上下文参数未命名已定义的G上下文.
BadMatch(错误匹配) 仅输入窗口用作Drawable。
BadMatch(错误匹配) 某些参数或参数对具有正确的类型和范围,但失败以请求所需的其他方式匹配。
BadValue(错误值) 某些数值超出了请求接受的值范围。除非为参数指定了特定范围,否则定义的完整范围参数的类型被接受。定义为一组的任何参数替代方案可能会产生此错误。

另请参见

XCopyArea(),XClearArea(),"复制区域".
克里斯托弗·特隆奇,ch@tronche.com(中文)