{{htmlmetatags>metatag-robots=()
metatag-title=(IMAGES LOAD | ugBASIC User Manual)
metatag-keywords=(ugBASIC,Commodore 64,Commodore PLUS/4,ZX Spectrum)
metatag-description=(Manual page for IMAGES LOAD)
metatag-media-og:image=(:ugbasic:logo-ugbasic-fb.png)
metatag-og:title=(IMAGES LOAD | ugBASIC User Manual) 
metatag-og:description=(Manual page for IMAGES LOAD)
}}

====== ugBASIC User Manual ======

===== IMAGES LOAD ✓ =====

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

==== PURPOSE ====


The ''IMAGES LOAD'' 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 = IMAGES LOAD("starship.png") FRAME SIZE (8,8)
    alienAt11 = IMAGES LOAD("alien.png") FRAME SIZE (16,16)
    alien2 = IMAGES LOAD("alien.png" AS "alien2") FRAME SIZE (16,16)


See also the following example files:
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/images_loading_01.bas|images_loading_01.bas]]''


==== ABBREVIATION ====
   Ims Ld


==== AVAILABLE ON ====
  * 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


==== ANY PROBLEM? ====
If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please [[https://github.com/spotlessmind1975/ugbasic/issues/new?title=ISSUE ON IMAGES LOAD|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

[[:ugbasic:user:index|{{ :ugbasic:user:logo-ugbasic.png?nolink&600 |}}]]