整理MFC中StretchDIBits()函数

函数声明:

int StretchDIBits(HDC hdc, int XDest , int YDest , int nDestWidth, int nDestHeight, int XSrc, int Ysrc, int nSrcWidth, int nSrcHeight, CONST VOID *lpBits, CONST BITMAPINFO * lpBitsInfo, UINT iUsage, DWORD dwRop)

形参说明:

  hdc:指向目标设备环境的句柄。 
  XDest:指定目标矩形左上角位置的X轴坐标,按逻辑单位来表示坐标。 
  YDest:指定目标矩形左上角的Y轴坐标,按逻辑单位表示坐标。 
  nDestWidth:指定目标矩形的宽度。为正时绘制区域在XDest的右边,绘制方向从左到右;为负时向绘制区域在XDest的左边,绘制方向从右到左。
  nDestHeight:指定目标矩形的高度。为正时绘制区域在YDest的下方,但是绘制方向从下到上;为负时绘制区域在YDest的上方,但是绘制方向从上到下。

  XSrc:指定DIB中源矩形(左上角)的X轴坐标(不管biHeight为正或负),坐标以像素点表示。 

  YSrc:指定DIB中源矩形(左上角)的Y轴坐标(不管biHeight为正或负),坐标以像素点表示。

  nSrcWidth:按像素点指定DIB中源矩形的宽度,为正时选择区域在XSrc的右边,扫描方向从左到右;为负时选择区域在XSrc的左边,扫描方向从右到左。
  nSrcHeight:按像素点指定DIB中源矩形的高度,为正时选择区域在YSrc的上方,扫描方向从下到上;为负时选择区域在YSrc的下方,扫描方向从上到下。

  先扫描行,后扫描列。
  lpBits:指向DIB位的指针,这些位的值按字节类型数组存储:bitmap bits。

  lpBitsInfo:指向BITMAPINFO结构的指针,该结构包含有关DIB方面的信息。 
  iUsage:表示是否提供了BITMAPINFO结构中的成员bmiColors,如果提供了,那么该bmiColors是否包含了明确的RGB值或索引。参数iUsage必须取下列值,这些值的含义如下:
  DIB_PAL_COLOR:表示该数组包含对源设备环境的逻辑调色板进行索引的16位索引值。 
  DIB_RGB_COLORS:表示该颜色表包含原义的KGB值,若想了解更多的信息,请参考下面备注一节。 
  dwRop:指定源像素点、目标设备环境的当前刷子和目标像素点是如何组合形成新的图像。

dwRop:指定光栅操作代码。这些代码将定义源矩形区域的颜色数据,如何与目标矩形区域的颜色数据组合以完成最后的颜色。

下面列出了一些常见的光栅操作代码: 


  BLACKNESS:表示使用与物理调色板的索引0相关的色彩来填充目标矩形区域,(对缺省的物理调色板而言,该颜色为黑色)。 
  DSTINVERT:表示使目标矩形区域颜色取反。 
  MERGECOPY:表示使用布尔型的AND(与)操作符将源矩形区域的颜色与特定模式组合一起。 
  MERGEPAINT:通过使用布尔型的OR(或)操作符将反向的源矩形区域的颜色与目标矩形区域的颜色合并。 
  NOTSRCCOPY:将源矩形区域颜色取反,于拷贝到目标矩形区域。 
  NOTSRCERASE:使用布尔类型的OR(或)操作符组合源和目标矩形区域的颜色值,然后将合成的颜色取反。 
  PATCOPY:将特定的模式拷贝到目标位图上。 
  PATPAINT:通过使用布尔OR(或)操作符将源矩形区域取反后的颜色值与特定模式的颜色合并。然后使用OR(或)操作符将该操作的结果与目标矩形区域内的颜色合并。
  PATINVERT:通过使用XOR(异或)操作符将源和目标矩形区域内的颜色合并。 
  SRCAND:通过使用AND(与)操作符来将源和目标矩形区域内的颜色合并。 
  SRCCOPY:将源矩形区域直接拷贝到目标矩形区域。 
  SRCERASE:通过使用AND(与)操作符将目标矩形区域颜色取反后与源矩形区域的颜色值合并。 
  SRCINVERT:通过使用布尔型的XOR(异或)操作符将源和目标矩形区域的颜色合并。 
  SRCPAINT:通过使用布尔型的OR(或)操作符将源和目标矩形区域的颜色合并。 
  WHITENESS:使用与物理调色板中索引1有关的颜色填充目标矩形区域。(对于缺省物理调色板来说,这个颜色就是白色)。

  返回值:如果函数执行成功,那么返回值是拷贝的扫描线数目,如果函数执行失败,那么返回值是GDI_ERROR。

转载:

猜你喜欢

转载自blog.csdn.net/lbc2100/article/details/81223357
今日推荐