set annot

This command controls the look of plot annotations: the frame around the plot, any additional axes that are drawn alongside the frame, the axis labels and tick marks, and the GrADS logo and date stamp at the bottom of the page.

Syntax

set annot color <thickness>

The color argument is a color number; it can range from 16 to 99 (or 255 or 2047 -- see Usage Notes below.)
The thickness option controls the thickness of the frame and axes, and must be an integer in the range of 1 to 12 (or 256 for version 2.1 and later.)

Usage Notes

For GrADS version 2.0.a5 and earlier, the color number must be between 16 and 99 -- 0 to 15 are predefined.
For GrADS versions 2.0.a6 through 2.0.2, the maximum number of colors increased from 99 to 255.
Starting with version 2.1, the maximum number of colors is 2047.

The default color is the foregroud color, which is white by default. If you change the background color to white, then black becomes the forground color and annotations will be drawn in black. The thickness of the axis labels and tic marks are controlled with the set xlopts and set ylopts commands, which have a default thickness value of 4. The color controls in the axis labeling commands override the color setting in set annot.

For GrADS version 2.0.2 and earlier, the default thickness is 6. The GrADS logo and datestamp are drawn at the specified thickness minus 3.

Note that for the X window display and the image output (e.g. PNG) in version 2.0.2 and earlier, 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 contour line thickness, for the X window display and all hardcopy output formats. The default thickness is 5 for the frame and axes, and the thickness of the GrADS logo and date stamp have a fixed value of 4 and are no longer controlled by the user. The defaults for axis labels and tic marks are unchanged.

Example

set annot 15 5