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

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

===== BAR ✓ =====

===== SYNTAX =====
     BAR [x1], [y1], [x2], [y2], [c]
     BAR [x1], [y1] TO [x2], [y2]
     BAR TO [x2], [y2][, c ]

==== PURPOSE ====


The ''BAR'' instruction will draw a filled rectangle on the screen, specifying the 
coordinates of its opposite corners. The ''x1'' and ''y1'' are the left top
coordinates, while the ''x2'' and ''y2'' are the right bottom coordinates.

The fill color could be the one predefined, or specified by additional parameter.
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.

Drawing (and filling) rectangles is a common operation in graphics. A dedicated command would 
make the code more concise and readable. Filled rectangles can be used to create buttons, 
text boxes, and other interface elements. The ''BAR'' command could be used as a basis 
for creating more complex shapes.



==== EXAMPLE ====
    BAR 10,10,100,100,WHITE
    BAR TO 100,100
    BAR ,10 TO ,100


See also the following example files:
  * ''[[https://github.com/spotlessmind1975/ugbasic/tree/main/examples/graphics_lines_03.bas|graphics_lines_03.bas]]''


==== ABBREVIATION ====
   Br


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

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