IG_DIB_info

This function creates a new DIB info object and initializes it to the given values.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_DIB_info_create( HIGDIBINFO* lphDIB, AT_DIMENSION width, AT_DIMENSION height, enumIGColorSpaceIDs colorspace, AT_INT channelCount, AT_INT* channelDepths );

Arguments:

Name	Type	Description
lphDIB	HIGDIBINFO*	Pointer to where created DIB info's handle will be stored.
width	AT_DIMENSION	Width of image in pixels.
height	AT_DIMENSION	Height of image in pixels.
colorspace	enumIGColorSpaceIDs	Color space of image.
channelCount	AT_INT	Number of channels in image.
channelDepths	AT_INT*	Array of channel depths.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Example:

	Copy Code
/* Create a DIB info object describing a 48-bit RGB image / AT_ERRCOUNT nErrcount; / Number of errors on stack / HIGDIBINFO hDIBInfo; / DIB info handle / AT_INT depths[3] = {16, 16, 16}; / Array of channel depths / nErrcount = IG_DIB_info_create(&hDIBInfo, 320, 240, IG_COLOR_SPACE_ID_RGB, 3, depths); / ... */ nErrcount = IG_DIB_info_delete(hDIBInfo);

Copy Code

/* Create a DIB info object describing a 48-bit RGB image */
AT_ERRCOUNT nErrcount;   /* Number of errors on stack */
HIGDIBINFO hDIBInfo;             /* DIB info handle */
AT_INT depths[3] = {16, 16, 16}; /* Array of channel depths */
nErrcount = IG_DIB_info_create(&hDIBInfo, 320, 240, IG_COLOR_SPACE_ID_RGB, 3, depths);
/* ... */
nErrcount = IG_DIB_info_delete(hDIBInfo);

Remarks:

The DIB info object must be deleted with IG_DIB_info_delete when it is finished being used.

This function does not allocate pixel data storage.