Virtual Developer Workshop: Containerized Development with Docker

A device-dependent bitmap (DDB) is structured in such a way that it matches very closely the form in which the bitmap is finally displayed by the device driver. For this reason the DDB is unlikely to be compatible with other display devices. A device-independent bitmap (DIB) on the other hand has a logical layout and can be decifered by any device driver. The disadvantage with DIB though is that it is much slower to render onto the device as compared to a DDB.

One situation where we need to convert a DDB to a DIB is when we want to save the bitmap to a file. The BMP files are infact just composed of a short header followed by information in a DIB.

The steps involved in creating the DIB are:

  1. Initialize a BITMAPINFOHEADER data structure. We use information in the bitmap to determine the widht, height and the bit count. The compression field is set based on the argument passed into the function. It's best to use the BI_RGB compression for greater portability and faster rendering.
  2. Select and realize the logical palette associated with the bitmap. This is passed in as the last argument to the function. If a palette is not provided use the default palette.
  3. Determine the number of bytes required for the bitmap bits. First allocate enough memory for BITMAPINFOHEADER and the color table and then call GetDIBits() to size. Supplying a NULL for the lpBits parameter instructs GetDIBits() to biSizeImage field in the bitmapinfoheader. Sometimes, this does not work (depending on the device driver) in which case we make our own estimate. We can compute this since we already know the width, height, the number of bits per pixel and the fact that each row of pixels will occupy a multiple of 4 bytes (32 bits).
  4. Given the final size of the bitmap bits, reallocate the memory block to hold the bitmapinfoheader, the color table and the bitmap bits.
  5. Finally call the GetDIBits() again to get the bitmap bits.
// DDBToDIB		- Creates a DIB from a DDB
// bitmap		- Device dependent bitmap
// dwCompression	- Type of compression - see BITMAPINFOHEADER
// pPal			- Logical palette
HANDLE DDBToDIB( CBitmap& bitmap, DWORD dwCompression, CPalette* pPal ) 
	BITMAP			bm;
	DWORD			dwLen;
	HANDLE			handle;
	HDC 			hDC;

	ASSERT( bitmap.GetSafeHandle() );

	// The function has no arg for bitfields
	if( dwCompression == BI_BITFIELDS )
		return NULL;

	// If a palette has not been supplied use defaul palette
	hPal = (HPALETTE) pPal->GetSafeHandle();
	if (hPal==NULL)
		hPal = (HPALETTE) GetStockObject(DEFAULT_PALETTE);

	// Get bitmap information

	// Initialize the bitmapinfoheader
	bi.biSize		= sizeof(BITMAPINFOHEADER);
	bi.biWidth		= bm.bmWidth;
	bi.biHeight 		= bm.bmHeight;
	bi.biPlanes 		= 1;
	bi.biBitCount		= bm.bmPlanes * bm.bmBitsPixel;
	bi.biCompression	= dwCompression;
	bi.biSizeImage		= 0;
	bi.biXPelsPerMeter	= 0;
	bi.biYPelsPerMeter	= 0;
	bi.biClrUsed		= 0;
	bi.biClrImportant	= 0;

	// Compute the size of the  infoheader and the color table
	int nColors = (1 << bi.biBitCount);
	if( nColors > 256 ) 
		nColors = 0;
	dwLen  = bi.biSize + nColors * sizeof(RGBQUAD);

	// We need a device context to get the DIB from
	hDC = GetDC(NULL);
	hPal = SelectPalette(hDC,hPal,FALSE);

	// Allocate enough memory to hold bitmapinfoheader and color table
	hDIB = GlobalAlloc(GMEM_FIXED,dwLen);

	if (!hDIB){
		return NULL;


	*lpbi = bi;

	// Call GetDIBits with a NULL lpBits param, so the device driver 
	// will calculate the biSizeImage field 
	GetDIBits(hDC, (HBITMAP)bitmap.GetSafeHandle(), 0L, (DWORD)bi.biHeight,

	bi = *lpbi;

	// If the driver did not fill in the biSizeImage field, then compute it
	// Each scan line of the image is aligned on a DWORD (32bit) boundary
	if (bi.biSizeImage == 0){
		bi.biSizeImage = ((((bi.biWidth * bi.biBitCount) + 31) & ~31) / 8) 
						* bi.biHeight;

		// If a compression scheme is used the result may infact be larger
		// Increase the size to account for this.
		if (dwCompression != BI_RGB)
			bi.biSizeImage = (bi.biSizeImage * 3) / 2;

	// Realloc the buffer so that it can hold all the bits
	dwLen += bi.biSizeImage;
	if (handle = GlobalReAlloc(hDIB, dwLen, GMEM_MOVEABLE))
		hDIB = handle;

		// Reselect the original palette
		return NULL;

	// Get the bitmap bits

	// FINALLY get the DIB
	BOOL bGotBits = GetDIBits( hDC, (HBITMAP)bitmap.GetSafeHandle(),
				0L,				// Start scan line
				(DWORD)bi.biHeight,		// # of scan lines
				(LPBYTE)lpbi 			// address for bitmap bits
				+ (bi.biSize + nColors * sizeof(RGBQUAD)),
				(LPBITMAPINFO)lpbi,		// address of bitmapinfo
				(DWORD)DIB_RGB_COLORS);		// Use RGB for color table

	if( !bGotBits )
		return NULL;

	return hDIB;


  • A bug near 'nColors'

    Posted by sswater on 05/15/2006 03:29am

    The 'nColors' may be not right if 'bi.biBitCount == 32': ------------------------------------------------------- int nColors = (1 << bi.biBitCount); if( nColors > 256 ) nColors = 0; ------------------------------------------------------- If 'bi.biBitCount == 32', the 'nColors' is '1' again. But the 'nColors' should be '0'. It should be: 'if( nColors > 256 )' => 'if( bi.biBitCount > 8 )', isn't it?

    • A bug near 'nColors'

      Posted by sswater on 05/19/2006 09:35am

      The 'nColors' may be not right if 'bi.biBitCount == 32':
      	int nColors = (1 << bi.biBitCount);
      	if( nColors > 256 )
      		nColors = 0;
      If 'bi.biBitCount == 32', the 'nColors' is '1' again. But the 'nColors' should be '0'.
      It should be:
      'if( bi.biBitCount > 8 )' instead of 'if( nColors > 256 )',
      isn't it?

  • Bug with GMEM_MOVEABLE!!!

    Posted by luongomi on 04/05/2006 06:41pm

    After you reallocate the buffer to GMEM_MOVEABLE you cast it as if it is a fixed block of memory. After you reallocate it as moveable you should lock/unlock the memory to get a raw pointer. -Mike Luongo luongomi@ (big ten college "msu.edu") From msdn: If GlobalReAlloc reallocates a movable object, the return value is a handle to the memory object. To convert the handle to a pointer, use the GlobalLock function.

  • How to Get Bitmap informations from Bitmap handle in Win Ce?

    Posted by p_srini18 on 01/09/2006 01:12pm

    I have a Bitmap handle and I need access to the RGB data, I have the bitmap handle
    (HBITMAP) but I cannot work out how to get the pointer to the RGB data.
    I would normally use GetDIBits but it looks like its unsupported. I have to capture the screen od pocket pc..
    Pls give me any ideas?

  • Scan from top to bottom

    Posted by Fluxay2008 on 12/26/2005 07:50am

    Hi,this can scan a bitmap from bottom to top, and writes it out, but how to make it scan from top to bottom? I try to do as this :bi.biHeight = -bm.bmHeight; but failed, so can you help me ?

  • how to access a BMP file through C program

    Posted by Legacy on 02/12/2004 08:00am

    Originally posted by: saifi

    plz send me the code forto access a BMP file through C program

  • Wavelet Compression - how to proceed further?

    Posted by Legacy on 07/18/2003 07:00am

    Originally posted by: Jayam

    I have completed haar transform as the first step in the wavelet compression of gray level images. Will you please guide me what is the next step?

    • haar transform

      Posted by raedkingdom on 03/31/2005 04:06pm

      i would like to add haar transform to my project . would you send me haar transformation source code?

  • trying to save a DDB to DIB in vb.net CE

    Posted by Legacy on 06/24/2003 07:00am

    Originally posted by: Pete

    Hello everyone,

    this area is very interesting, I am
    looking to save an image drawn in a vb.net for CE
    application as a DIB so that it can be copied over to the
    PC. Idealy i would like to save it to the SQL CE database.
    Does anyone out there know how to do this. I can use C# to
    create a dll if I have to.

    Cheers Pete.

  • Why does GetDIBits() not work from C#???

    Posted by Legacy on 06/01/2003 07:00am

    Originally posted by: Sunil

    I am trying to call GetDIBits from my C# code and it simply returns me a 0, GetLastError() also returns a 0 i dont understand what is the problem. as of now i am trying to write a wrapper fr it in VC++ but the native API should resolve.
    Help me if you have done this....using C# is imortant and the operatin has t be time cretical as i am using it for a screen capture software i am writing..

    regards Sunil

  • 16 bit grayscale

    Posted by Legacy on 05/08/2003 07:00am

    Originally posted by: Trond78

    Hi i got a 16 bit grayscale DDB i want to make a DIB. I set the folowing parameters:

    bi.biPlanes = 1;
    bi.biBitCount = 16;

    What must hPal be??

  • GetDIBits Fails

    Posted by Legacy on 05/07/2003 07:00am

    Originally posted by: Tom Hanks

    Great looking function DDBToDIB, thanks to Zafir for providing it. But for me (and several of others) it is not working due a NULL return from GetDIBits().

    Actually GetDIBits does work if I am using a monchrome bitmap. Not good enough for me - but maybe a clue to someone knowledgable?

    bmp.CreateBitmap(w, h, 1, 8, NULL); // DDBToDIB fails in GetDIBits on 8 bit bmp
    bmp.CreateBitmap(w, h, 1, 24, NULL); // DDBToDIB fails in GetDIBits on 24 bit bmp
    bmp.CreateBitmap(w, h, 1, 1, NULL); // DDBToDIB *doesn't* fail in GetDIBits on 1 bit bmp

    My environment is XP and VC++6 (SP3)

  • Loading, Please Wait ...

  • You must have javascript enabled in order to post comments.

Leave a Comment
  • Your email address will not be published. All fields are required.

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date