load-file

   

Loads a bitmap from a file or resource.

• (send a-wx:bitmap load-file name flags) -> boolean
      name : string
      flags = wx:const-bitmap-type-default : small integer

  The meaning of name is determined by the flags parameter. The flags argument can be a bitwise combination of  wx:const-bitmap-discard-colourmap (meaning the colourmap read, if any, should be thrown away) and one of:

  • wx:const-bitmap-type-gif -- load a GIF bitmap file (X Windows, Windows, MacOS)
  • wx:const-bitmap-type-xbm -- load an X bitmap file (X Windows, MacOS)
  • wx:const-bitmap-type-xpm -- load an XPM bitmap file (X Windows, Windows, MacOS)
  • wx:const-bitmap-type-bmp -- load a Windows bitmap file (X Windows, Windows, MacOS)
  • wx:const-bitmap-type-bmp-resource -- load a Windows bitmap from the resource database (Windows)
  • wx:const-bitmap-type-pict -- load a PICT bitmap file (MacOS)
  • wx:const-bitmap-type-pict-resource -- load a PICT resource (MacOS)

  The value of wx:const-bitmap-type-default is plaform-sepcific:

  • X Windows: (bitwise-or wx:const-bitmap-type-xbm wx:const-bitmap-discard-colourmap)
  • Windows: (bitwise-or wx:const-bitmap-type-bmp wx:const-bitmap-discard-colourmap)
  • MacOS: (bitwise-or wx:const-bitmap-type-pict wx:const-bitmap-discard-colourmap)

  A colourmap may be associated with the bitmap if one exists (especially for colour Windows bitmaps), and if the code supports it. You can check if one has been created by using the get-colour-map member.