Available on: d32 c128 sg1000 zx c64 vic20 atari msx1 plus4 d64 mo5 pc1403 sc3000 coleco coco3 coco
See also: GET BITMAP

GET IMAGE

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.



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.

SYNTAX

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


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

EXAMPLE

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


ABBREVIATION: GeIm

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:

GET IMAGE ↔ GeIm

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