===== Color (Statement) =====

==== Format ====

**color** color\\
**color** ( color )\\
**color** pen_color, brush_color\\
**color** ( pen_color, brush_color )

==== Description ====

Sets the current drawing color to //colorname// or to an ARGB value where ((a * 256 + r) * 256 + g) * 256 + b.  If a single color is specified both the pen and the brush will be set to the same color.  There are several ways to define a color in BASIC256:

  - one of the defined color constants (see table below);
  - an integer to define the color where ((a * 256 + r) * 256 + g) * 256 + b,
    * a - transparency 0 = transparent to 255 = opaque
    * r - red 0 = off to 255 = full on
    * g - green 0 = off to 255 = full on
    * b - blue 0 = off to 255 = full on
  - the [[rgb|rgb]] function passing it 3 or 4 numbers from 0-255,
  - using an svg color name as a string [[https://www.w3.org/TR/SVG11/types.html#ColorKeywords|as defined by the W3C]],
  - or using a string with a "#" followed by 6 or 8 hexadecimal digits ("#ff0000", "#a0ffffff")


When drawing solid shapes ([[Chord|Chord]],[[Circle|Circle]],[[Pie|Pie]],[[Poly|Poly]],[[Rect|Rect]], and [[Stamp|Stamp]]) the border of the shape will be drawn with the pen color and the shape itself will be filled with the brush color.  A brush color of CLEAR is used to not fill a closed shape.

If the current pen and brush are both set to CLEAR the pixels or shapes drawn will clear the pixels of the graphics output area and make them transparent.  This is especially useful when creating sprites using the Spriteslice command.\\

{{page>en:colorconstants}}

==== Deprecated Form ====
In version 0.9.9.26 the statement form "**color** //red//, //blue//, //green//" or "**color** ( //red//, //blue//, //green// )" was deprecated and a warning will be displayed when it is encountered.  It should be replaced with "**color** **rgb** ( //red//, //blue//, //green// )".

==== Example ====

<code>
clg
color rgb(128,128,128)
rect 0,0,graphwidth, graphheight

penwidth 5
color green,red
circle 100,100,50

penwidth 1
color rgb(255,160,160)
circle 100,100,25

penwidth 5
color "firebrick","#fab856"
rect 150,150,100,100

color "papayawhip", "clear"
rect 175,175,100,100
</code>
Will draw the following:\\
{{:color2.png|Color}}


==== See Also ====
{{page>en:start#Graphics - Colors&noheader}}

==== History ==== 
|0.9.5m|added "COLOR r,g,b" form and numeric representation of color names|
|0.9.9.26|Added brush color and deprecated the "COLOR r,g,b".|
|0.9.9.28|Changed color values to include Alpha (transparency) and changed color constants to new ARGB values.|
|0.9.9.45|changed values to positive numbers following formula as documented.|
|2.0.99.4|Added ability to use string names and hex values for colors.|