SetStretchBltMode-WINDOWS API

SetStretchBltMode函数设置在指定设备内容中的伸展模式。

 

int SetStretchBltMode(

 

  HDC hdc,           // DC的HANDLE

 

  int iStretchMode   // 位图伸展模式

 

);

 

Hdc:输入，设备内容的HANDLE

 

iStretchMode:输入，指定的伸展模式，参数可以下面值之一：

 

值

 描述

 
BLACKONWHITE

 执行一个布尔AND操作在要删除的存在的图素上。如果位图是一个单色位图，这个模式保留黑色的像素为白色的像素。

 
COLORONCOLOR

 删除像素，这个模式删除所有待删除的像素行，而不保留他们的信息。

 
HALFTONE

 从源矩形映射像素到指定的目标矩形。目标和源矩形的平均颜色是相似的。

 

在设置HALFTON伸展模式之后，应用程序必须调用SetBrushOrgEx函数来设置刷源。如果该调用失败了，刷子将不对齐。

 

This option is not supported on Windows 95/98/Me.

 
STRETCH_ANDSCANS

 Same as BLACKONWHITE.

 
STRETCH_DELETESCANS

 Same as COLORONCOLOR.

 
STRETCH_HALFTONE

 Same as HALFTONE.

 
STRETCH_ORSCANS

 Same as WHITEONBLACK.

 
WHITEONBLACK

 执行一个布尔或操作，使用待删除的存在的像素的颜色。如果位图是一个单色的位图，这个模式将保留白色的像素为黑色像素。

 

返回值：

 

如果函数成功，返回先前的伸展模式

 

如果失败，返回0

 

WINDOWS NT/2000/XP：使用GetLastError可以得到更多的信息，下面是其中之一：

 

值

 意义

 
ERROR_INVALID_PARAMETER

 一到多个参数无效

 

 

备注：

 

伸展模式定义了程序调用StretchBlt函数的时候怎么样在显示设备上用存在的像素合并位图行或列。

 

BLACKONWHITE (STRETCH_ANDSCANS)和WHITEONBLACK (STRETCH_ORSCANS)典型的用来保留单色位图的前景像素。COLORONCOLOR (STRETCH_DELETESCANS)模式通常用来保留彩色位图中的颜色。

 

HALFTONE相对较慢，并要求更多的源图象处理，但提供较高的图像质量。同样SetBrushOrgEx也不惜是HALFTON模式以免刷子不对齐。

 

另外，伸展模式也依赖于设备驱动器的能力。

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/windcsn/archive/2005/09/28/491183.aspx