load-file in bitmap%

Loads a bitmap from a file. If the bitmap is in use by a bitmap-dc% object or a control, the bitmap file is not loaded.

• (send a-bitmap load-file name kind) -> boolean
     name : string
     kind = 'unknown : symbol in '(unknown gif jpeg xbm xpm bmp pict)

  The kind parameter specifies the file's format:

  • 'unknown -- examine the file to determine its format

  • 'gif -- load a GIF bitmap file (X, Windows, Mac OS)

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

  • 'xbm -- load an X bitmap file (X, Windows, Mac OS); creates a monochrome bitmap

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

  • 'bmp -- load a Windows bitmap file (X, Windows, Mac OS)

  • 'pict -- load a PICT bitmap file (Mac OS)

  An XBM image is always loaded as a monochrome bitmap. An image in any other format is always loaded as a bitmap that matches the depth of the screen.