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, NULL )

Provide the HIGEAR handle of the image to delete, and provide the addresses of the HBITMAP (CGImageRef) variables to receive the handle for the created DDB.

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 free() call to free this memory.

To delete a DDB being created with IG_dspl_DDB_create, use a CGImageRelease(hBitmap) call.