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

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.

  PUT IMAGE airplane AT 10,10

See also the following example files:

• contrib_themill.bas
• defines_screen_01.bas
• images_load_05.bas

 PuIm

• 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

PUT BITMAP

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!