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).


Table 1: Valid Color Names

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.