SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Staff SED Projects SED Products and Publications Search SED Pages
Dataplot Vol 1 Vol 2

ARROW COLOR

Name:
    ARROW ... COLOR
Type:
    Plot Control Command
Purpose:
    Specifies the colors for arrows to appear on subsequent plots (as specified via the ARROW ... COORDINATES command) or arrows generated by the ARROW command. Up to 100 arrows can be specified with the ARROW COORDINATES command.
Description:
    Dataplot provides two methods for specifying colors.

    1. Colors can be defined by name (or by the corresponding index). Dataplot adopted it's named colors from the X11 project. Currently, 162 named colors and 100 levels of grayscale are supported. Grayscale can be specified with either G0, G1, ..., G100 (or -1, -2, ..., -100). Many older devices support only a limited number of colors. For these devices, unsupported colors will be mapped to one of the available colors. To specify a named color, see Syntax 1.

    2. Most modern graphics devices support full RGB (RedBlueGreen) color. You can alternatively specify RGB colors by entering three integer values to represent the Red, Green and Blue components, respectively. These values should be in the range 0 to 255.

    When setting the arrow color, Dataplot first checks if the device supports RGB colors. If not, the named color will be used. If the device does support RGB color, Dataplot will check if an RGB color has been specified. If yes, then that RGB color is used. If not, the named color will be used.

    To see the list of supported named colors (with the associated index number), see

    https://www.itl.nist.gov/div898/software/dataplot/refman1/ch11/homepage.htm

Syntax 1:
    ARROW <id> COLOR <color>
    where <id> is an arrow identifier (an integer number or parameter) in the integer range 1 to 100;
    and where <color> is the desired color.
Syntax 2:
    ARROW <id> RGB COLORS <red-1> <green-1> <blue-1>
    where <id> is an arrow identifier (an integer number or parameter) in the integer range 1 to 100;
    and     <red-1>, <green-1>, <blue-1> is a list of integer values that specifies the desired RGB arrow color.

    Up to 100 such triplets of color values can be specified.

    To turn off the RGB color, set the values to -1 (any negative value will work). Values greater than 255 will be set to 255.

Examples:
    ARROW 1 COLOR BLUE
    ARROW 2 COLOR GREEN
    ARROW 1 RGB COLOR 220 109 88
Note:
    Arrows can be generated in two ways. You can use the ARROW COORDINATES command to place arrows on subsequent plots or you can use the ARROW command to generate one arrow immediately. The ARROW COLOR command is used to specify the color in either case. When the ARROW command is used, the color is set to the color of the first arrow (i.e., is 1).
Note:
    An ARROW ... COLOR command with no arguments sets the arrow color to default; thus ARROW 1 COLOR with no arguments sets the color for arrow 1 to default. An ARROW ... COLOR command with no <id> refers to all 100 arrows; thus ARROW COLOR GREEN assigns the color green to all 100 arrows. Note also that ARROW COLOR with no <id> and no arguments sets the color to default for all 100 arrows.
Default:
    All arrows are drawn with black lines.
Synonyms:
    None
Related Commands: Applications:
    Presentation Graphics
Implementation Date:
    Pre-1987
    2020/11: Support for RGB colors
Program 1:
     
    LET X = DATA 1 2 3 4 5 6 7 8 9 10
    LET Y = DATA 2 4 60 7 9 12 14 15 18 20
    .
    XLIMITS 1 10
    XTIC OFFSET 1 1
    YLIMITS 0 60
    YTIC OFFSET 0 5
    .
    ARROW 1 COORDINATES 45 87 36 85
    ARROW 1 COLOR BLACK
    ARROW 2 COORDINATES 71 46 78 45
    ARROW 2 COLOR G50
    LEGEND 1 COLOR BLACK
    LEGEND 2 COLOR G50
    .
    LEGEND 1 OUTLIER
    LEGEND 2 LAST POINT
    LEGEND 1 COORDINATES 47 86
    LEGEND 2 COORDINATES 69 45
    LEGEND 2 JUSTIFICATION RIGHT
    .
    PLOT Y X
        
    plot generated by sample program
    .
    LEGEND 1 RGB COLOR 175 238 238
    LEGEND 2 RGB COLOR 220 20 60
    ARROW 1 RGB COLOR 175 238 238
    ARROW 2 RGB COLOR 220 20 60
    .
    PLOT Y X
        
    plot generated by sample program
Date created: 05/06/2021
Last updated: 12/11/2023

Please email comments on this WWW page to alan.heckert@nist.gov.