CreateDIBitmap

更新时间:2024-01-01 14:43

CreateDIBitmap函数由与设备无关的位图DIB)创建与设备有关的位图(DDB),并且有选择地为位图置位。

函数原型

HBITMAP CreateDIBitmap(HDC hdc,CONST BITMAPINFOHEADER *lpbmih,DWORD fdwlnit,CONST VOID *lpblnit,CONST BITMAPINFO *lpbmi,UINT fuUsage);

参数:

hdc:设备环境句柄。

lpbmih:指向位图信息头结构的指针,它可以是下列操作系统位图信息头之一:

Windows NT 3.51和早期:BITMAPINFOHEADER;Windows NT 4.0和Windows 95:BITMAPV4HEADER;

Windows NT 5.0和Windows 98:BITMAPV5HEADER。

如果fdwlnit是CBM_INIT,那么函数使用位图信息头结构来获取位图所需的宽度、高度以及其他信息。

注意高度若是正数,那么表示是自底向上DIB,而负数表示为自顶向下DIB,这种情况与CreateDIBitmap函数兼容。

Fdwlnit:位标识集。它指定系统如何对位图的位进行初始化。

标志

下面是定义的位标志常量

CBM_INIT:如果设置了该标志,那么系统将使用lpblnit和lpbmi两个参数指向的数据来对位图中的位进行初始化。如果没有该标志,那么表示上述两个参数指向的数据无效。如果fdwlnit为0,那么系统不会对位图的位进行初始化。

lpblnit:该指针指向包含初始的位图数据的字节类型数组。数据格式与参数lpbmi指向的BITMAPINFO结构中的成员biBitCount有关。

lpbmi:指向BITMAPINFO结构的指针。该结构描述了参数lpbmi指向的数组的维数和颜色格式。

fuUsage:表示BITMAPINFO结构的成员bmiColors是否初始化过,并且如果是,那么bmiColors是否包含明确的红、绿、蓝(RGB)值或调色板索引。参数fuUsage必须取下列值中的一个,这些值的含义为:

DIB_PAL_COLORS:表示提供一个颜色表,并且该表由该位图要选入的设备环境的逻辑调色板的16位索引值数组组成。

DIB_RGB_COLORS:表示提供一个颜色表,并且表中包含了原义的RGB值。

返回值:如果函数执行成功,返回值则是创建的位图的句柄;如果函数执行失败,那么返回值为NULL,若想获取更多错误信息,请调用GetLastError函数。

备注:用于fdwlnit参数的CBM_CREATDIB标志不再被支持。当不再需要该位图时,可调用DeleteObject函数删除它。

ICM:参数fuUsage用来指定参数lpbmi指向的BITMAPINFO结构中的成员bmiColors是否包含颜色信息。如果bmiColors不包含颜色信息,那么不能进行位图的颜色管理。BITMAPINFO中的bmiColors成员必须包含BITMAPV4HEADER或BITMAPV5HEADER,以便能够进行颜色管理。在创建完位图之后,产生的位图的内容颜色不匹配。

速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;头文件:wingdi.h;库文件:gdi32.lib。

示例

从一个文件中读取DDB数据然后用进行转换

HBITMAP LoadBitmapEx(LPCTSTR lpszFile)

{

if(lpszFile == NULL)

return NULL;

HBITMAP hBitmap;

HANDLE hf;

BITMAPFILEHEADER* pbmfh;

DWORD dwBytesRead, dwFileSize, dwFileSizeHigh;

BOOL bSuccess;

// 打开一个bmp文件

hf = CreateFile(lpszFile, GENERIC_READ, FILE_SHARE_READ,

NULL, OPEN_EXISTING, FILE_FLAG_SEQUENTIAL_SCAN, NULL);

if( hf == INVALID_HANDLE_VALUE)

{

return NULL;

}

// 得到这个文件大小

dwFileSize = GetFileSize(hf, &dwFileSizeHigh);

if( dwFileSizeHigh )

{

CloseHandle(hf);

return NULL;

}

// 分配内存,大小为该文件的大小

pbmfh = (BITMAPFILEHEADER*)malloc(dwFileSize);

if( !pbmfh )

{

CloseHandle(hf);

return NULL;

}

// 读取数据

bSuccess = ReadFile(hf, pbmfh, dwFileSize, &dwBytesRead, NULL);

CloseHandle(hf);

// 效验文件大小和文件格式

if( !bSuccess || dwFileSize != dwBytesRead

|| pbmfh->bfType != 0x4D42 || pbmfh->bfSize != dwFileSize)

{

free((void*)pbmfh);

return NULL;

}

// 进行DIB转换

hBitmap = CreateDIBitmap(

GetWindowDC(NULL),

(BITMAPINFOHEADER*)(pbmfh + 1),

CBM_INIT,

(BYTE*)pbmfh + pbmfh->bfOffBits,

(BITMAPINFO*)(pbmfh + 1),

DIB_RGB_COLORS);

free((void*)pbmfh);

return hBitmap;

}

免责声明
隐私政策
用户协议
目录 22
0{{catalogNumber[index]}}. {{item.title}}
{{item.title}}