{{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.



The ''GET IMAGE'' instruction copies a portion of the screen into an image in memory,
which must be defined in advance. The dimensions of the image to be captured are 
defined by the variable where the image will be stored. The image is also captured 
with color components.



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


==== ABBREVIATION ====
   GeIm


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


==== 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 |}}]]