This section provides information about Loading and Saving images and documents.

Loading

To load a file "picture.bmp" from the current directory, call IG_load_file. This creates a bitmap in memory, creates a unique ImageGear handle for it, and returns this handle to you in a HIGEAR object.

#include "gear.h"

HIGEAR image;
AT_ERRCOUNT errorCount;
errorCount = IG_load_file("picture.bmp", &image);   

To load from a file descriptor handle or from memory, see Loading.

Saving

To save an image to file, call IG_save_file[link to function]. It will write the content in the specified file format to the current working directory.

errorCount = IG_save_file(image, "picture.tif", IG_SAVE_TIF_UNCOMP);    

To save to a file descriptor handle, or to memory, see Saving.

Additional Considerations

Some formats are handled a little differently:

• For PDF: See Load and Save a PDF
• For multi-page TIFF files: See Load and Save Pages in a Multi-Page Document, or Save a TIFF File Using Tiles for a different way to save TIFF files
• For DICOM: See Load and Save DICOM Images
• For Digital Camera RAW: See Load Raw Images

For more control of loading and saving, use file filter control parameters, which are unique to each file format. See the "Getting Information about a Format Filter" and "Using File Filter Control Parameters" sections of Using File Format Filters

If it is important to minimize input/output operations, see Set the Buffer Size to Limit IO.

For loading files that use unicode symbols in the file name, see Working with File Names with Unicode Symbols.