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

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

===== IMAGE  =====

===== SYNTAX =====
     = IMAGE( resource FRAME num )
     = IMAGE( resource SEQUENCE seq FRAME num )

==== PURPOSE ====

The ''IMAGE'' command allows you to extract an image from a collection of images 
stored in an ''IMAGES'' or ''SEQUENCE'' variable. Note that extraction occurs at compile 
time: therefore, no extra resources are allocated in the compiled program. This command 
is intended for all those commands that need an image to function, but want to exploit a
graphic resource already loaded and optimized.



==== EXAMPLE ====
    starship = IMAGE( LOAD IMAGES(("tiles.png") FRAME 1 )
    starship = IMAGE( LOAD SEQUENCE(("tiles.png") SEQUENCE 1 FRAME 2 )


==== ABBREVIATION ====
   Im


==== AVAILABLE ON ====
  * 
  * Atari (400/800)
  * Atari XL/XE
  * Commodore 128 (MOS 8502)
  * Commodore 128 (Zilog Z80)
  * Commodore 64
  * Commodore 64+REU
  * 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 [[https://github.com/spotlessmind1975/ugbasic/issues/new?title=ISSUE ON IMAGE|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

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