set line

This command sets current line attributes.

Syntax

set line color <style <thickness>>

The color argument may be one of the 16 GrADS default colors or a new color defined with set rgb.

Options for style are:
     1 - solid
     2 - long dash
     3 - short dash
     4 - long dash, short dash
     5 - dotted
     6 - dot dash
     7 - dot dot dash

The thickness option must be an integer in the range of 1 to 12 (or 256 for version 2.1 and later.)

Usage Notes

The default line color is 1, the default style is 1, and the default thickness is 3.

Changes to the line characteristics 'stick' until reset by a new execution of set line, or when a reset or reinit command is issued.

When using GrADS version 2.0.2 and earlier, for the X window display and the image output (e.g. PNG), a thickness setting between 1 and 5 will result in lines approximately one pixel wide; a thickness between 6 and 11 will result in lines two pixels wide, and a thickness of 12 will give lines approximately three pixels wide. For the vector graphics output (e.g. PostScript and Encapsulated PostScript) the line thickness will increase with each increment in the thickness value.

If using GrADS version 2.1 and later with the Cairo graphics library enabled, then each thickness setting will increment the line thickness, for the X window display and all hardcopy output formats.

The default line widths for thickness settings between 1 and 12 are: 0.6, 0.8, 1.0, 1.25, 1.5, 1.75, 2.0, 2.2, 2.4, 2.6, 2.8, 3.0. The units (pixels or points) will depend on the surface being drawn to. In GrADS version 2.1 and later, there is a new command, set lwid, that allows the user to define a new line thickness setting if the 12 default widths are unsatisfactory.

Example

set line 2 3 5