FRAME COLOR

...FRAME COLOR

Plot Control Command

Specifies the color of the plot frame on subsequent plots.

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

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

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

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

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.

Normally all frame lines are set to the same color, so the most common form of this command is FRAME COLOR with no prefix.

All frame lines are black.

None

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.

Presentation Graphics

Pre-1987
2020/11: Support for RGB colors

 
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
    

 
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