Available on: all targets

LOAD IMAGE

The LOAD IMAGE 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.

syntax example abbreviation back to keywords

SYNTAX

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


Legend
  • id : identifier
  • type : datatype
  • v : value
  • "..." : string
  • [...] : optional

EXAMPLE

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


Used in:

ABBREVIATION: Ld Im

Join BASIC 10Liner Contest with ugBASIC!

An interesting competition is held at the beginning of each year: the BASIC 10Liner Contest. It is possible to use ugBASIC to participate in the next "BASIC10Liner" competition, in the following categories:

  • PUR-120 - A game in 10 lines of max 120 characters (w/abbrev.)
  • EXTREME-256 - A game in 10 lines of max 256 characters (w/abbrev.)
  • SCHAU - Any program in 10 lines of max 256 characters (w/abbrev.)
In order to reduce space you can use this abbreviation for this instruction: 

LOAD IMAGE ↔ Ld Im

Any problem?

If you have found a problem with this keyword, if you think there is a bug or, more simply, you would like it to be improved, open an issue for this example on GitHub.
Thank you!

open an issue BACK TO KEYWORDS