Save method (Main Control)

Visual Basic example
Visual C++ 4.0 example
Visual J++ example

Syntax short Save (BSTR pszName, short iFormat, short iBitsPerPixel, short iQuality, short iModify);

Overview: Refer to Saving a Bitmap to a File.

Remarks

Saves the bitmap to a file in any of the supported compressed or uncompressed formats.

Support for 12 and 16-bit grayscale images is available only in the Document/Medical toolkits .

If the bitmap is 8 bits per pixel or greater, use the LEAD CMP format or one of the JPEG (JTIF or JFIF) formats to save disk space. You can set the ProgressivePasses property if you want to save a CMP or JFIF file as a progressive file.

If the bitmap is 1-bit per pixel, use the LEAD 1-bit format or a CCITT Group 3 or 4 format to save disk space.

For CCITT Group 3 and 4 formats, the first RGBQUAD structure in the bitmap's palette determines the white component of the image. If the rgbRed field is 0, then all 0 bits in the image are assumed to be black. Otherwise, all zero (0) bits in the image are assumed white.

If you save an animated GIF file, all bitmaps in the bitmap list are saved. Also, the following properties update global fields in the file:

AnimationPalette property

AnimationBackColor property

AnimationHeight property

AnimationWidth property

AnimationLoop property