User Tools

Site Tools


ugbasic:user:kw:load_images
Translations of this page:


ugBASIC User Manual

LOAD IMAGES ✓

SYNTAX

   = LOAD IMAGES(filename) FRAME SIZE (w,h)
   = LOAD IMAGES(filename AS alias) FRAME SIZE (w,h)

PURPOSE

The LOAD IMAGES command allows you to load an image and to convert in an array of images. Each image will be of [w]x[h] pixels. Offset will be calculated automatically on the base of the original image.

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.

EXAMPLE

  starship = LOAD IMAGES("starship.png") FRAME SIZE (8,8)
  alienAt11 = LOAD IMAGES("alien.png") FRAME SIZE (16,16)
  alien2 = LOAD IMAGES("alien.png" AS "alien2") FRAME SIZE (16,16)

See also the following example files:

ABBREVIATION

 Ld Ims

AVAILABLE ON

  • Atari (400/800)
  • Atari XL/XE
  • Commodore 128 (MOS 8502)
  • Commodore 128 (Zilog Z80)
  • Commodore 64
  • TRS-80 Color Computer
  • TRS-80 Color Computer 3
  • ColecoVision
  • Amstrad CPC 664
  • Dragon 32
  • Dragon 64
  • Thomson MO5
  • Thomson MO5
  • Olivetti Prodest PC128
  • Commodore PLUS/4
  • SEGA SC-3000
  • SEGA SG-1000
  • VG-5000
  • Commodore VIC-20
  • ZX Spectrum 48

ANY PROBLEM?

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!

POWERED BY