This function is called to determine if the HIGEAR variable hIGear contains a handle of a valid ImageGear image.

Declaration:

BOOL ACCUAPI IG_image_is_valid (HIGEAR hIGear);

Arguments:

Return Value:

This function returns TRUE if a hIGear contains a valid handle; FALSE otherwise.

Supported Raster Image Formats:

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

Example:

HIGEAR hIGear;     /* Contains HIGEAR handle of image   */
if ( IG_image_is_valid ( hIGear ) )
        { IG_save_file ( hIGear, "picture.bmp", IG_SAVE_BMP_UNCOMP ); }

Remarks:

Note that the return-type of the function is BOOL, not AT_ERRCOUNT. TRUE is returned if the handle is valid and may be used as the HIGEAR argument in calls to other ImageGear functions.