set clopts

This command controls the look of the contour labels drawn on contour lines.


set clopts color <thickness <size>>


Usage Notes

This setting 'sticks' until changed by issuing another set clopts command, or when a reset or reinit command is issued.

If you want to change only the size setting, you must include a color and thickness setting as well; use default values of -1.

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 contour labels approximately one pixel wide; a thickness between 6 and 11 will result in contour labels two pixels wide, and a thickness of 12 will give contour labels approximately three pixels wide. For the vector graphics output (e.g. PostScript and Encapsulated PostScript) the contour label thickness will increase with each increment in the thickness value.

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

Contour labels drawn with Cairo fonts will not be affected by the set clopts thickness setting. Please read the documentation page on Font Control in GrADS for more information about using fonts in GrADS version 2.1.

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 will depend on the surface being drawn to (pixels or points). 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.


set clopts -1 -1 0.12