ncl_gridall man page

Gridall — Allows one to draw backgrounds for X/Y plots. Included are routines for drawing grids, perimeters, and pairs of axes. Internal parameters of Gridall control such things as the color indices and line width scale factors used to draw various parts of the background, the formats to be used for labels, the sizes of the characters to be used for labels, the amount by which labels are to be offset from the axes, and the routine to be called to draw the labels (the SPPS routine WTSTR or the Plotchar routine PLCHHQ).

Synopsis

Each of the routines GRID, GRIDL, HALFAX, PERIM, PERIML, and GRIDAL draws a background of some sort within the part of the plotter frame occupied by the current GKS viewport, as follows:

C-Binding Synopsis

c_grid
c_gridl
c_halfax
c_perim
c_periml
c_gridal
c_gagetc
c_gageti
c_gagetr
c_gasetc
c_gaseti
c_gasetr
c_gacolr
c_labmod
c_ticks
c_tick4

User-Modifiable Internal Routines

None.

Access

To use Gridall C or Fortran routines, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.  

Messages

Various error conditions can occur in Gridall.  Each of these results in a call to the error-handling routine SETER, with a final argument indicating that the error is recoverable; by default, an error message is printed and execution is terminated, but, if you turn on error recovery (as described in the "man" page for "error_handling"), you can get control back.

The error messages are as follows; all should be more or less self-explanatory.

GACOLR - UNCLEARED PRIOR ERROR
GAGETC - UNCLEARED PRIOR ERROR
GAGETC - UNRECOGNIZED PARAMETER NAME
GAGETI - UNCLEARED PRIOR ERROR
GAGETR - UNCLEARED PRIOR ERROR
GAGETR - UNRECOGNIZED PARAMETER NAME
GASETC - UNCLEARED PRIOR ERROR
GASETC - UNRECOGNIZED PARAMETER NAME
GASETI - UNCLEARED PRIOR ERROR
GASETR - UNCLEARED PRIOR ERROR
GASETR - UNRECOGNIZED PARAMETER NAME
GRID - UNCLEARED PRIOR ERROR
GRIDAL - ERROR EXIT FROM GQCLIP
GRIDAL - ERROR EXIT FROM GQLWSC
GRIDAL - ERROR EXIT FROM GQPLCI
GRIDAL - ERROR EXIT FROM GQTXCI
GRIDAL - UNCLEARED PRIOR ERROR
GRIDL - UNCLEARED PRIOR ERROR
HALFAX - UNCLEARED PRIOR ERROR
LABMOD - UNCLEARED PRIOR ERROR
PERIM - UNCLEARED PRIOR ERROR
PERIML - UNCLEARED PRIOR ERROR
TICK4 - UNCLEARED PRIOR ERROR
TICKS - UNCLEARED PRIOR ERROR

See Also

Online: gridall_params, gacolr, gagetc, gageti, gagetr, gasetc, gaseti, gasetr, grid, gridal, gridl, halfax, labmod, perim, periml, tick4, ticks, ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

Info

March 1993 UNIX NCAR GRAPHICS