Table of Contents

ugBASIC User Manual

PUT IMAGE ✓

SYNTAX

   PUT IMAGE resource AT [x],[y]
   PUT IMAGE resource FRAME frame AT [x],[y]
   PUT IMAGE resource STRIP sequence FRAME frame AT [x],[y]
   PUT IMAGE resource [ AT [x],[y] ] [fl]
   PUT IMAGE resource FRAME f [ AT [x],[y] ] [fl]
   PUT IMAGE resource STRIP s FRAME f [ AT [x],[y] ] [fl]
     fl: [WITH TRANSPARENCY] [DOUBLE Y]
   PUT ([x1],[y1])-(x2,y2),resource[,fl2]
     fl2: PSET|PRESET|AND|OR|NOT

PURPOSE

This function draws an image at a specific position on the screen. The programmer can draw on the screen a single image (IMAGE), a frame of a series of images (IMAGES) or a frame of a pose of a sequence of images (SEQUENCES). In all cases the syntax changes slightly.

This function draws an image at a specific position on the screen. The programmer can draw on the screen a single image (IMAGE), a frame of a series of images (ATLAS) or a frame of a strip of a sequence of images (SEQUENCE). In all cases the syntax changes slightly.

Every PUT IMAGE can be followed by a flag that modify the wayt the image will be drawn on the screen. The WITH TRANSPARENCY will enable the transparency effect when the image is drawn, while DOUBLE Y will double the vertical size of the image. Both flags could be not available on all targerts and graphical modes.

Another syntax is more compatible with other BASICs, that requires that the PUT IMAGE is followed with the bounds to draw to. This is only a syntatic equivalence, there is no “clipping” around the bounds. Moreover, it is possible to give a flag that alter the default behaviour of PUT IMAGE. The PSET is the standard behaviour of PUT IMAGE, while PRESET will put only the bitmap part of the image (if possible). The AND and OR flags will activate the same logical operation between the image and the background. NOT is not currently supported.

EXAMPLE

  PUT IMAGE airplane AT 10,10

See also the following example files:

ABBREVIATION

 PuIm

AVAILABLE ON

SEE ALSO

PUT 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 open an issue for this keyword on GitHub. Thank you!

POWERED BY