Deleting DIBs and DDBs

This section provides information about how to delete DIBs and DDBs.

To delete the HIGEAR, but keep the DIB in existence (and obtain its address):

	Copy Code
IG_image_DIB_export( hIGear, lpDIB, DIBSize, &Options);

The DIB's address is returned in your LPAT_DIB variable lpDIB.

To delete the HIGEAR and the DIB, but produce a copy of the image in DDB format, use IG_dspl_DDB_create:

	Copy Code
IG_dspl_DDB_create( hIGear, IG_GRP_DEFAULT, hDC, nWidth, nHeight, TRUE, &hBitmap, &hPalette )

Provide the HIGEAR handle of the image to delete, and provide the addresses of the HBITMAP and HPALETTE variables to receive the handles for the created DDB and palette.

To delete a HIGEAR, including the DIB, when you are entirely done using it, use the following call to IG_image_delete:

	Copy Code
IG_image_delete ( hIGear );

Note that in all the above cases, ImageGear will not release memory that it did not allocate. For example, assume your application has allocated memory, created a DIB, and subsequently used an IG_image_DIB_import() call to give this DIB a HIGEAR handle. In this case, a later call to IG_image_delete() will delete the HIGEAR structure but will not free the DIB's memory. The owner of the DIB's memory (in this case, your application) would issue a Windows DeleteObject() call to free this memory.