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

====== ugBASIC User Manual ======

===== DRAW ✓ =====

===== SYNTAX =====
     DRAW [x1], [y1] TO x2, y2[, c]
     DRAW TO x2, y2[, c]
     DRAW (x1,y1) − (x2,y2)[,mode][,B|,BF]

==== PURPOSE ====


This instruction draws a line on the screen, starting from the coordinates ''(x1, y1)''
to arrive at the coordinates ''(x2, y2)'', using the color ''c''. The start or the final
coordinates can be omitted: in this case, ugBASIC will draw, respectively, starting from 
the last drawn position and arriving at the last drawn position. If the color is 
omitted, the last color selected with the ''INK'' or ''PEN'' command will be used. 
Finally, the default line style is full but a 16 bit bitmask can be set with the ''SET LINE''
command.

On the other syntax, you can select the ''mode'' that can be ''PSET'' or ''PRESET''. If 
''PSET'' is used the line is drawn in the current foreground colour. If ''PRESET'', the 
line is drawn in the background colour.

The last, if used, it is either ''B'' or ''BF''. If ''B'', a rectangle is
drawn instead of a line, the upper corner of the rectangle will be x1, y1, and
the lower right corner x2, y2. If ''BF'' is used, the rectangle is drawn and filled
with the current foreground colour.



==== EXAMPLE ====
    DRAW 10,10 TO 100,100,WHITE
    DRAW TO 100,100
    DRAW ,10 TO ,100


See also the following example files:
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/graphics_color_01.bas|graphics_color_01.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/graphics_lines_01.bas|graphics_lines_01.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/graphics_shapes_01.bas|graphics_shapes_01.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/graphics_shapes_02.bas|graphics_shapes_02.bas]]''
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/graphics_shapes_03.bas|graphics_shapes_03.bas]]''


==== ABBREVIATION ====
   Dr


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


==== 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 DRAW|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

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