This function searches and returns the first free unused group identifier.

Declaration:

AT_ERRCOUNT   ACCUAPI  IG_dspl_free_grp_id_get(
        [IN] HIGEAR hIGear,
        [IN] DWORD dwMin,
        [OUT] LPDWORD lpdwFreeGrpId
);

Arguments:

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

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

Example:

HIGEAR hIGear;   /* HIGEAR handle of image   */ 
DWORD nGrpID;   /* display group identifier  */
 ...
IG_dspl_free_grp_id_get( hIGear, 0, &nGrpID );
 ...

Remarks:

This function also sets a flag so the returned group is marked as used and the next call to this function with the same parameters returns another group id. To mark a group as unused and reset it to the default values, call function IG_dspl_grp_reset().