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

FRAME COLOR

Name:
    ...FRAME COLOR
Type:
    Plot Control Command
Purpose:
    Specifies the color of the plot frame on subsequent plots.
Description:
    The frame is the 4-sided box which surrounds the usual 2-dimensional plot. The analyst can control the color of each or all of the sides of the frame by specifying the pre-fix in the command (see the SYNTAX section below).

    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 frame RGB 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:
    <prefix>FRAME COLOR <color>
    where <color> specifies the desired color;
    and     <prefix> is as follows:
      no prefix refers to all 4 sides
      the prefix X refers to both horizontal sides
      the prefix Y refers to both vertical sides
      the prefix X1 refers to the lower horizontal side
      the prefix X2 refers to the upper horizontal side
      the prefix Y1 refers to the left vertical side
      the prefix Y2 refers to the right vertical side.
Syntax 2:
    <prefix>FRAME RGB COLOR <red> <green> <blue>
    where <red> is an integer number or parameter that specifies the red component;
                <green> is an integer number or parameter that specifies the green component;
                <blue> is an integer number or parameter that specifies the blue component;
    and     <prefix> is as follows:
      no prefix refers to all 4 sides
      the prefix X refers to both horizontal sides
      the prefix Y refers to both vertical sides
      the prefix X1 refers to the lower horizontal side
      the prefix X2 refers to the upper horizontal side
      the prefix Y1 refers to the left vertical side
      the prefix Y2 refers to the right vertical side.

    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:
    FRAME COLOR YELLOW
    FRAME COLOR RED
    FRAME COLOR
    X2FRAME COLOR CYAN
    Y2FRAME COLOR MAGENTA
    FRAME RGB COLOR 220 109 88
    XFRAME RGB COLOR 175 238 238
Note:
    A ...FRAME COLOR command with no arguments reverts the setting to default. Thus X1FRAME COLOR with no arguments sets the bottom horizontal frame line color to black. A ...FRAME COLOR command with no prefix refer to all 4 sides. Thus FRAME COLOR GREEN sets the frame line color to green on all 4 sides. Note also that FRAME COLOR with no prefix and no arguments reverts the frame color settings on all 4 sides to default.
Note:
    Normally all frame lines are set to the same color, so the most common form of this command is FRAME COLOR with no prefix.
Default:
    All frame lines are black.
Synonyms:
    None
Related Commands:
    PLOT = Generates a data or function plot.
    FRAME = Sets the on/off switch for the plot frame.
    FRAME COORDINATES = Sets the location for the plot frame.
    MINIMUM = Sets the frame minima for subsequent plots.
    MAXIMUM = = Sets the frame maxima for subsequent plots.
    LIMITS = Sets the frame limits for subsequent plots.
    GRID = Sets the on/off switch for the plot grid.
    LOG = Sets the on/off switch for a log scale.
    TIC = Sets the on/off switch for the plot tics.
    MAJOR TIC NUMBER = Sets the number of major tics.
    TIC LABEL = Sets the on/off switch for plot tic labels.
    TIC LABEL DECIMALS = Sets the number of decimal places for plot tic mark labels.
    MARGIN COLOR = Sets the color for the plot margin.
    BACKGROUND COLOR = Sets the color for the plot background.
    TITLE = Sets the plot title.
    LABEL = Sets the plot labels.
    LEGEND = Sets the plot legends.
    LEGEND COORDINATES = Sets the locations for plot legends.
    BOX COORDINATES = Sets the locations for plot boxes.
    ARROW COORDINATES = Sets the locations for plot arrows.
    SEGMENT COORDINATES = Sets the locations for plot segments.
Applications:
    Presentation Graphics
Implementation Date:
    Pre-1987
    2020/11: Support for RGB colors
Program 1:
     
    SERIAL READ LEAD
    164 426 59 98 312 263 607 497 213 54 160 262 547 325 419 94 70
    END OF DATA
    SERIAL READ POT
    106 175 61 79 94 121 424 328 107 218 140 179 246 231 245 339 99
    END OF DATA
    .
    TITLE DEMONSTRATE FRAME COLOR COMMAND
    XFRAME COLOR RED
    YFRAME COLOR BLUE
    FRAME THICKNESS 0.5
    X1LABEL LEAD
    Y1LABEL POTASSIUM
    CHARACTER CIRCLE
    CHARACTER SIZE 1.5
    LINE BLANK ALL
    PLOT POT VS LEAD
        
    plot generated by sample program
Program 2:
     
    SERIAL READ LEAD
    164 426 59 98 312 263 607 497 213 54 160 262 547 325 419 94 70
    END OF DATA
    SERIAL READ POT
    106 175 61 79 94 121 424 328 107 218 140 179 246 231 245 339 99
    END OF DATA
    .
    TITLE DEMONSTRATE FRAME RGB COLOR COMMAND
    XFRAME COLOR RED
    YFRAME COLOR BLUE
    XFRAME RGB COLOR 220 109 88
    YFRAME RGB COLOR 175 238 238
    FRAME THICKNESS 0.5
    X1LABEL LEAD
    Y1LABEL POTASSIUM
    CHARACTER CIRCLE
    CHARACTER SIZE 1.5
    LINE BLANK ALL
    PLOT POT VS LEAD
        
    plot generated by sample program

Privacy Policy/Security Notice
Disclaimer | FOIA

NIST is an agency of the U.S. Commerce Department.

Date created: 05/13/2021
Last updated: 05/13/2021

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