ugBASIC User Manual

   = IMAGE LOAD([filename]{,[mode]})
   = IMAGE LOAD([filename] AS [alias]{,[mode]})

The IMAGE LOAD command allows you to load an image and to convert it into an IMAGE. The second parameter is the mode to use to convert the given data (by default, it is equal to current mode)

The command support a set of modern image format, like:

• JPEG baseline & progressive
• PNG 1/2/4/8/16-bit-per-channel
• TGA
• BMP (non-1bpp, non-RLE)
• PSD (composited view only, no extra channels, 8/16 bit-per-channel)
• GIF
• HDR (radiance rgbE format)
• PIC (Softimage PIC)
• PNM (PPM and PGM binary only)

The image will be converted into a way that can be efficiently drawn on the screen. It could be converted into indexed palette, and can be rescaled as well.

Since it is possible to load only one file of the same type at a time, it is necessary to be able to indicate an “alias” with which to exceed this limit. In this regard, there is also the AS syntax, which allows you to load the same file several times but with different names.

  starship = IMAGE LOAD("starship.png")
  starship2 = IMAGE LOAD("starship.png" AS "starship2")
  alienAt11 = IMAGE LOAD("alien.jpg",11)
  alien2 = IMAGE LOAD("alien.jpg" AS "alien2",11)

See also the following example files:

• image_loading_01.bas

 Im Ld

• Commodore 64
• ZX Spectrum 48K
• Commodore PLUS/4
• Atari (400/800/XL)
• Dragon 32
• Dragon 64
• PC128 Olivetti Prodest
• Thomson MO5
• Commodore VIC-20
• MSX 1
• ColecoVision

If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please open an issue for this keyword on GitHub. Thank you!