This function flushes the DIB if it uses a memory mapped file for storing pixels.

Declaration:

AT_ERRCOUNT ACCUAPI IG_DIB_flush(HIGEAR hIGear);

Arguments:

Return Value:

Returns 0 if successful. Otherwise, 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++, except:

• Indexed RGB - 1 bpp;
• Grayscale - 1 bpp.

Remarks:

Call this function periodically to flush the DIB if the application accesses individual pixels or rasters of an image, or accesses pixel data directly by the image or raster pointer, and the DIB uses a memory mapped file for storing pixels. Usually, it is sufficient to flush the DIB after accessing of 100 - 200 Mb of pixel data.

If memory mapping is not used for the DIB, the function does nothing.

See Also:

Accessing Pixels of a Gigabyte-Sized Image