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

====== 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:
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/contrib_themill.bas|contrib_themill.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/defines_screen_01.bas|defines_screen_01.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/images_load_05.bas|images_load_05.bas]]''


==== ABBREVIATION ====
   PuIm


==== AVAILABLE ON ====
  * 
  * 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


==== 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 [[https://github.com/spotlessmind1975/ugbasic/issues/new?title=ISSUE ON PUT IMAGE|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

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