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

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

===== GET IMAGE  =====

===== SYNTAX =====
     GET IMAGE var FROM [x], [y]
     GET (x1,y1) - (x2,y2), var[, G]

==== PURPOSE ====



The purpose of the ''GET IMAGE'' command is to store the contents of the screen 
in a variable. The first syntax is where the programmer provides the coordinates 
of the rectangle to be stored. This syntax will store only the bitmap of the
image. You need to give the ''G'' option if you want to store color component,
too.

The second, instead, only requires the point from which to start storing the image,
whose dimensions are implicitly obtained from the variable. The color component
is acquired implictly. The ''GET IMAGE'' syntax is the only one that supports 
''ATLAS'' and ''SEQUENCE'' version, so you can acquire a single frame from the screen.



==== EXAMPLE ====
    background = NEW IMAGE(16, 16)
    GET IMAGE background FROM 0, 0


==== ABBREVIATION ====
   GeIm


==== AVAILABLE ON ====
  * Dragon 32
  * Commodore 128 (MOS 8502)
  * SEGA SG-1000
  * ZX Spectrum 48
  * Commodore 64
  * Commodore VIC-20
  * Atari (400/800)
  * MSX
  * Commodore PLUS/4
  * Dragon 64
  * Thomson MO5
  * SEGA SC-3000
  * ColecoVision
  * TRS-80 Color Computer 3
  * TRS-80 Color Computer


==== SEE ALSO ====
[[GET BITMAP]] 

==== 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 GET IMAGE|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

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