save-file in bitmap%

Saves a bitmap in the named file.

• (send a-bitmap save-file name kind quality) -> boolean
     name : path
     kind : symbol in '(png jpeg xbm xpm bmp)
   quality = 75 : exact integer in [0, 100]

  The kind argument determined the type of file that is created, one of:

  • 'png -- save a PNG file (X, Windows, Mac OS X)

  • 'jpeg -- save a JPEG file (X, Windows, Mac OS X)

  • 'xbm -- save an X bitmap file (X, Windows, Mac OS X)

  • 'xpm -- save an XPM bitmap file (X, Windows, Mac OS X)

  • 'bmp -- save a Windows bitmap file (Windows)

  The quality argument is used only for saving as 'jpeg, in which case it specifies the trade-off between image precision (high quality matches the content of the bitmap% object more precisely) and size (low quality is smaller).

  When saving as 'png, if get-loaded-mask returns a bitmap of the same size as this one, a grayscale version is included in the PNG file as the alpha channel.

  A monochrome bitmap saved as 'png without a mask bitmap produces a 1-bit grayscale PNG file (which , when read with load-file, creates a monochrome bitmap% object.)