IG_image_DIB

This function exports the contents of hIGear into a buffer, provided by the application, using Windows DIB or ImageGear AT_DIB format.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_image_DIB_export( const HIGEAR hIGear, AT_VOID* lpBuffer, AT_INT BufferSize, const AT_DIB_EXPORT_OPTIONS* lpOptions );

Arguments:

Name	Type	Description
hIGear	const HIGEAR	HIGEAR handle of image from which to export DIB.
lpBuffer	AT_VOID*	Memory buffer where DIB will be exported.
BufferSize	AT_INT	Size of memory buffer - use IG_image_DIB_export_size_calc to determine what to use for this.
lpOptions	const AT_DIB_EXPORT_OPTIONS*	Export options.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

Indexed RGB - 1...8 bpp;
Grayscale - 8...16 bpp;
RGB - 24 bpp;
CMYK - 32 bpp.

Sample:

Filters, Image Util

Example:

	Copy Code
AT_ERRCOUNT nErrcount; // Number of errors on stack HIGEAR hIGear; // Handle of image AT_INT nDibSize; // Exported DIB size AT_DIB_EXPORT_OPTIONS Options; // Options for DIB export LPAT_DIB lpDIBBuffer; // Buffer to export DIB // Load image file "picture.bmp" from working directory nErrcount = IG_load_file("picture.bmp", &hIGear); if(nErrcount == 0) { // Get exported DIB size, allocate memory buffer and export DIB memset(&Options, 0, sizeof(AT_DIB_EXPORT_OPTIONS)); Options.Format = IG_DIB_EXPORT_FORMAT_IG_LEGACY; Options.UseAlpha = FALSE; IG_image_DIB_export_size_calc(hIGear, &nDibSize, &Options); lpDIBBuffer = (LPAT_DIB)malloc(nDibSize); nErrcount = IG_image_DIB_export(hIGear, lpDIBBuffer, nDibSize, &Options); // ... // Delete memory free(lpDIBBuffer); // Destroy the image IG_image_delete(hIGear); }

Copy Code

AT_ERRCOUNT nErrcount;  // Number of errors on stack
HIGEAR hIGear;          // Handle of image
AT_INT nDibSize;        // Exported DIB size
AT_DIB_EXPORT_OPTIONS Options; // Options for DIB export
LPAT_DIB lpDIBBuffer;    // Buffer to export DIB

// Load image file "picture.bmp" from working directory
nErrcount = IG_load_file("picture.bmp", &hIGear);
if(nErrcount == 0)
{
    // Get exported DIB size, allocate memory buffer and export DIB
    memset(&Options, 0, sizeof(AT_DIB_EXPORT_OPTIONS));
    Options.Format = IG_DIB_EXPORT_FORMAT_IG_LEGACY;
    Options.UseAlpha = FALSE;
    IG_image_DIB_export_size_calc(hIGear, &nDibSize, &Options);
    lpDIBBuffer = (LPAT_DIB)malloc(nDibSize);
    nErrcount = IG_image_DIB_export(hIGear, lpDIBBuffer, nDibSize, &Options);
    // ...
    // Delete memory
    free(lpDIBBuffer);
    // Destroy the image
    IG_image_delete(hIGear);
}

Remarks:

hIGear remains valid after calling this function.