This function is called to determine if the HIGEAR variable hIGear contains a handle of a valid ImageGear image.
Declaration:
 Copy Code |
|
|---|---|
BOOL ACCUAPI IG_image_is_valid ( HIGEAR hIGear ); |
|
Arguments:
| hIGear | HIGEAR handle of image. |
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 Professional.
Sample:
ASCII, Clipboard, Color, Display, GUI Windows, Image Processing, Image Util, IOSET, JPEG, Magnify, Medical, Memory IO, MFC, Page, Palette Edit, Panning, Pixel Access, Thumbnail, TWAIN, Wipes, MFC Threads, Annotation, GUI Scan, Vector, Filters, FlashPix, ImageClean, Multimedia
Example:
| Copy Code |
|
|---|---|
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.