load-file in image-snip%

Loads a new bitmap into the snip.

• (send an-image-snip load-file filename kind relative-path? inline?) -> void
     filename : string or #f
   kind = 'unknown : symbol in '(unknown unknown/mask gif gif/mask jpeg png png/mask xbm xpm bmp pict)
   relative-path? = #f : boolean
     inline? = #t : boolean

  Loads the file by passing filename and kind to load-file If a bitmap had previously been specified with set-bitmap, that bitmap (and mask) will no longer be used. If filename is #f, then the current image is cleared.

  When 'unknown/mask, 'gif/mask, or 'png/mask is specified and the loaded bitmap object includes a mask (see get-loaded-mask), the mask is used for drawing the bitmap (see draw-bitmap).

  If relative-path? is not #f and filename is a relative path, then the file will be read using the path of the owning editor's filename. If the image is not inlined, it will be saved as a relative pathname.

  If inline? is not #f, the image data will be saved directly to the file or clipboard when the image is saved or copied (preserving the bitmap's mask, if any). The source filename and kind is no longer relevant.