win32.graph.freeimage.FreeImage_Save

FreeImage_Save is available since version 1.0.

Prototype:

boolean FreeImage_Save(number format, number dib, string filename, number flags)

Description:

This function saves a previously loaded FIBITMAP to a file. The first parameter defines the type of the bitmap to be saved. For example, when FIF_BMP is passed, a BMP file is saved (an overview of possible FREE_IMAGE_FORMAT constants is available in Table 1). The second parameter is the name of the bitmap to be saved. If the file already exists it is overwritten. Note that some bitmap save plugins have restrictions on the bitmap types they can save. For example, the JPEG plugin can only save 24 bit and 8 bit greyscale bitmaps*. The last parameter is used to change the behaviour or enable a feature in the bitmap plugin. Each plugin has its own set of parameters.

Return value:

Returns true if succeeded, false if failed.