ncl_reset man page

RESET — The "super" version of RESET zeroes the internal integer array used to detect crowded lines; other versions do nothing.



C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_reset()


The "super" version of the Dashline utility attempts to cull crowded lines from the output picture.  It does this using an internal integer array, ISCREN, in which each bit used represents a single pixel in a square array of 1024x1024 pixels of the picture.  Initially, all the bits must be set to zero by calling the routine RESET.  When a line segment is about to be drawn, an appropriate set of bits in ISCREN (representing the pixels through which the line segment passes) is examined; if any bit in that set is a 1, the line segment is not drawn. Then, the bits representing the pixels in the immediate vicinity of the line segment are set to 1, so as to prevent any subsequent line segment from being drawn through the area.

As each label is drawn, the bits in ISCREN representing the area occupied by the label are set to 1, as well, which prevents subsequent line segments from being drawn through the label.

This culling process has the following implications for the user of the "super" version of Dashline:


Use the ncargex command to see the following relevant examples:  tdashp,  fdlsmth.


To use RESET or c_reset, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.  

See Also

Online: dashline, dashline_params, curved, dashdb, dashdc, frstd, lastd, lined, vectd, ncarg_cbind

Hardcopy:   NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics