| 术语 | plgblt |
| 释义 | PlgBlt 语法： BOOL PlgBlt( __in HDC hdcDest, __in const POINT *lpPoint, __in HDC hdcSrc, __in int nXSrc, __in int nYSrc, __in int nWidth, __in int nHeight, __in HBITMAP hbmMask, __in int xMask, __in int yMask ); PlgBlt功能 该PlgBlt函数执行从源设备环境中指定矩形的目标设备环境的指定平行四边形1位块的颜色数据传输的比特。如果给定的位掩码处理确定了有效的单色位图，使用此功能来掩盖位图从源矩形的颜色数据位。 参数 hdcDest [in] 句柄到目标设备上下文。 lpPoint [in] 阿为3分，逻辑空间的数组指针，确定三个目标平行四边形的角落。左上角源矩形角映射在这个数组的第一点，右上角的第二点在这个数组，而左下角的第三点。较低源矩形右下角映射到隐第四点的平行四边形。 hdcSrc [in] 句柄到源设备上下文。 nXSrc [in] 的x坐标，按逻辑单位，对源矩形的左上角。 nYSrc [in] 在y坐标，按逻辑单位，对源矩形的左上角。 nWidth [in] 宽度，按逻辑单位，源矩形。 nHeight [in] 的高度，以逻辑单位，源矩形。 hbmMask [in] 一个句柄，可选单色位图，用来掩盖源矩形的颜色。 xMask [in] 的x坐标，按逻辑单位，对单色位图的左上角。 yMask [in] 在y坐标，按逻辑单位，对单色位图的左上角。 返回值 如果函数成功，返回值为非零。 如果函数失败，返回值是零。 备注 该PlgBlt功能可与设备相关的位图。 在平行四边形(d)第四顶点定义为治疗前3分，向量(甲，乙，丙)，电脑，?=乙+的CA。 如果该位掩码存在，是在掩盖一个值表示源像素的颜色应该复制到目的地。一个零掩码值表示目标像素的颜色是不能改变的。如果遮罩矩形比源和目标矩形小，功能复制面具模式。 缩放，翻译和反射变换允许在源设备环境，然而，旋转和剪切变换不是。如果掩码位图是不是一个单色位图，就会出现错误。对于目标设备环境的拉伸模式用于决定如何拉长或压缩的像素，如果这是必要的。 当一个增强型图元文件都已经被记录，如果发生错误的源设备环境标识一个增强型图元文件设备上下文。 目标坐标转换根据目标设备的范围内;源坐标转换根据源设备上下文。如果源变化有一个旋转或剪切，返回一个错误。 如果目标和源矩形没有相同的颜色格式，PlgBlt源矩形转换以匹配目标矩形。 并非所有设备都支持PlgBlt功能。有关详细信息，请参阅在GetDeviceCaps函数RC_BITBLT光栅能力的描述。 如果源和目标设备不兼容的设备上下文代表，PlgBlt返回一个错误。 当用在多个监控系统，无论hdcSrc和hdcDest必须引用相同的设备或功能将失败。要为不同的设备转移，转换通过调用GetDIBits内存的DIB位图数据之间的区议会。要显示DIB的第二个设备，电话SetDIBits或StretchDIBits函数。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderWingdi.h(头文件：winuser.h) LibraryGdi32.lib DLLGdi32.dll 参见 位图概述 位图功能 BitBLT等 GetDeviceCaps GetDIBits MaskBlt SetDIBits SetStretchBltMode StretchBlt StretchDIBits函数 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月11日 ＝＝英文原文＝＝PlgBlt Function The PlgBlt function performs a bit-block transfer of the bits of color data from the specified rectangle in the source device context to the specified parallelogram in the destination device context. If the given bitmask handle identifies a valid monochrome bitmap, the function uses this bitmap to mask the bits of color data from the source rectangle. Syntax BOOL PlgBlt( __in HDC hdcDest, __in const POINT *lpPoint, __in HDC hdcSrc, __in int nXSrc, __in int nYSrc, __in int nWidth, __in int nHeight, __in HBITMAP hbmMask, __in int xMask, __in int yMask ); Parameters hdcDest [in] A handle to the destination device context. lpPoint [in] A pointer to an array of three points in logical space that identify three corners of the destination parallelogram. The upper-left corner of the source rectangle is mapped to the first point in this array, the upper-right corner to the second point in this array, and the lower-left corner to the third point. The lower-right corner of the source rectangle is mapped to the implicit fourth point in the parallelogram. hdcSrc [in] A handle to the source device context. nXSrc [in] The x-coordinate, in logical units, of the upper-left corner of the source rectangle. nYSrc [in] The y-coordinate, in logical units, of the upper-left corner of the source rectangle. nWidth [in] The width, in logical units, of the source rectangle. nHeight [in] The height, in logical units, of the source rectangle. hbmMask [in] A handle to an optional monochrome bitmap that is used to mask the colors of the source rectangle. xMask [in] The x-coordinate, in logical units, of the upper-left corner of the monochrome bitmap. yMask [in] The y-coordinate, in logical units, of the upper-left corner of the monochrome bitmap. Return Value If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. Remarks The PlgBlt function works with device-dependent bitmaps. The fourth vertex of the parallelogram (D) is defined by treating the first three points (A, B, and C ) as vectors and computing D = B +CA. If the bitmask exists, a value of one in the mask indicates that the source pixel color should be copied to the destination. A value of zero in the mask indicates that the destination pixel color is not to be changed. If the mask rectangle is smaller than the source and destination rectangles, the function replicates the mask pattern. Scaling, translation, and reflection transformations are allowed in the source device context; however, rotation and shear transformations are not. If the mask bitmap is not a monochrome bitmap, an error occurs. The stretching mode for the destination device context is used to determine how to stretch or compress the pixels, if that is necessary. When an enhanced metafile is being recorded, an error occurs if the source device context identifies an enhanced-metafile device context. The destination coordinates are transformed according to the destination device context; the source coordinates are transformed according to the source device context. If the source transformation has a rotation or shear, an error is returned. If the destination and source rectangles do not have the same color format, PlgBlt converts the source rectangle to match the destination rectangle. Not all devices support the PlgBlt function. For more information, see the description of the RC_BITBLT raster capability in the GetDeviceCaps function. If the source and destination device contexts represent incompatible devices, PlgBlt returns an error. When used in a multiple monitor system, both hdcSrc and hdcDest must refer to the same device or the function will fail. To transfer data between DCs for different devices, convert the memory bitmap to a DIB by calling GetDIBits . To display the DIB to the second device, call SetDIBits or StretchDIBits . Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWingdi.h (include Windows.h) LibraryGdi32.lib DLLGdi32.dll See Also Bitmaps Overview Bitmap Functions BitBlt GetDeviceCaps GetDIBits MaskBlt SetDIBits SetStretchBltMode StretchBlt StretchDIBits Send comments about this topic to Microsoft Build date: 7/11/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/dd162804(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。