# Tokens

When they appear in commands, the tokens color, text, line, and range are shorthand designations for code blocks where there are multiple valid ways to supply the necessary keyword/value information for the command.

color Token

Command reference information for the color token is as follows.

color keyword

Note color appears as an option within line and text (described below). Each formulation of color begins with “color” (compare this with the text, where it is not necessary to prepend “text” before the keywords). The acceptable command formulations for a color token are as follows.

s

where s is a valid color name (see table below). In addition, any of the keywords defined in the list of SVG color keyword names (available online at http://www.w3.org/TR/SVG/types.html#ColorKeywords) may be used.

sCOLRRGGBB

specifies a color in RGB space where RR, GG, and BB are two-digit hex codes (for instance colFFFFFF is white and col000000 is black).

rgb ir ig ib

specifies a color in RGB space where ir ig ib are integers in the range of 0 to 255 (for instance rgb 0 0 0 is black and rgb 255 255 255 is white).

hsv ih is iv

specifies a color in HSV space where ih is an integer from 0 to 359, and is and iv are integers from 0 to 255 (for instance hsv 0 0 0 is black and hsv 0 0 255 is white).

 black darkgray gray lightgray white blue green cyan red pink purple orange yellow skyblue seagreen cardinal violet peach brown olive teal gold lightblue darkblue xlightpurple lightpurple darkpurple lightviolet darkviolet xlightpink lightpink darkpink xlightred lightred darkred lightorange darkorange lightpeach darkpeach xlightgold lightgold darkgold xlightyellow lightyellow darkyellow xlightgreen lightgreen darkgreen lightcyan darkcyan xlightskyblue lightskyblue darkskyblue xlightolive lightolive darkolive lightbrown darkbrown lightseagreen darkseagreen lightcardinal darkcardinal lightteal darkteal

line Token

Command reference information for the line token is as follows.

line keyword

In all cases (??) the line token is used by the PLOT command.

color color

Specifies the color of the line with a color token (see above).

active b

Turns on or off line rendering.

style keyword

Specifes the line style. The valid options are: none solid dash dot dashdot dashdotdot.

width i

Specifies the width of the line. This value must be between 0 and 10. A value of 0 indicates the smallest possible line (1 pixel).

text Token

Command reference information for the text keyword is as follows.

text keyword

The text token takes multiple keywords. One or more of these keywords may supplied when a text token is provided. However, not all of the keywords are available in all contexts.

color color

Specifies the color of the text with a color token (see above).

family s

Specifies the name of the font family (for instance, “Arial” or “Times New Roman”). (Note that underscores must be used in place of spaces in the name.)

active :lbool:b

Turns on or off rendering of text.

size i

Specifies the height of the text font used. This value is context-dependent.

style keyword

Specifies the font style. The valid options are: normal bold italic bolditalic.

text s

Specifies the text to use (in place of the default).

range Token

See here for the list of range keywords.