The CreateBitmap function creates a bitmap with the specified width, height, and color format (color planes and bits per pixel).
HBITMAP CreateBitmap(
int nWidth, |
// bitmap width, in pixels |
int nHeight, |
// bitmap height, in pixels |
UINT cPlanes, |
// number of color planes used by device |
UINT cBitsPerPel, |
// number of bits required to identify a color |
CONST VOID *lpvBits |
// pointer to array containing color data |
); |
If the function succeeds, the return value is a handle to a bitmap.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
After a bitmap is created, it can be selected into a device context by calling the SelectObject function.
While the CreateBitmap function can be used to create color bitmaps, for performance reasons applications should use CreateBitmap to create monochrome bitmaps and CreateCompatibleBitmap to create color bitmaps. When a color bitmap returned from CreateBitmap is selected into a device context, Windows must ensure that the bitmap matches the format of the device context it is being selected into. Since CreateCompatibleBitmap takes a device context, it returns a bitmap that has the same format as the specified device context. Because of this, subsequent calls to SelectObject are faster than with a color bitmap returned from CreateBitmap.
If the bitmap is monochrome, zeros represent the foreground color and ones represent the background color for the destination device context.
If an application sets the nWidth or nHeight parameters to zero, CreateBitmap returns the handle of a 1- by 1-pixel, monochrome bitmap.
When you no longer need the bitmap, call the DeleteObject function to delete it.
CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, DeleteObject, GetBitmapBits, SelectObject, SetBitmapBits
See:
file: /Techref/os/win/api/win32/func/src/f08_3.htm, 4KB, , updated: 2001/6/26 11:24, local time: 2024/8/23 14:20,
18.224.62.118:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://piclist.com/tecHREF/os/win/api/win32/func/src/f08_3.htm"> CreateBitmap</A> |
Did you find what you needed? |
![]() o List host: MIT, Site host massmind.org, Top posters @none found - Page Editors: James Newton, David Cary, and YOU! * Roman Black of Black Robotics donates from sales of Linistep stepper controller kits. * Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters. * Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated! * Contributors: Richard Seriani, Sr. |
Welcome to piclist.com! |
.