1RESET(3NCARG)                    NCAR GRAPHICS                   RESET(3NCARG)
2
3
4

NAME

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

SYNOPSIS

10       CALL RESET
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_reset()
16

USAGE

18       The "super" version of the Dashline utility attempts to cull crowded
19       lines from the output picture.  It does this using an internal integer
20       array, ISCREN, in which each bit used represents a single pixel in a
21       square array of 1024x1024 pixels of the picture.  Initially, all the
22       bits must be set to zero by calling the routine RESET.  When a line
23       segment is about to be drawn, an appropriate set of bits in ISCREN
24       (representing the pixels through which the line segment passes) is
25       examined; if any bit in that set is a 1, the line segment is not drawn.
26       Then, the bits representing the pixels in the immediate vicinity of the
27       line segment are set to 1, so as to prevent any subsequent line segment
28       from being drawn through the area.
29
30       As each label is drawn, the bits in ISCREN representing the area
31       occupied by the label are set to 1, as well, which prevents subsequent
32       line segments from being drawn through the label.
33
34       This culling process has the following implications for the user of the
35       "super" version of Dashline:
36
37       ·  The routine RESET should be called at the beginning of each new
38          picture.  If this is not done, each of a consecutive series of
39          pictures will have progressively more gaps where line segments have
40          been culled.
41
42       ·  More important lines should be drawn first, followed by less
43          important lines.  For example, the "super" version of the routine
44          CONREC draws labeled contour lines first, followed by the contour
45          lines halfway in between the labeled lines, followed by the rest of
46          the lines.
47
48       ·  Because each line segment is either drawn in its entirety or not at
49          all, long straight line segments are broken into shorter pieces.
50          The internal parameter MLLINE determines how small the resulting
51          pieces will be; you may wish to reduce its value so that smaller
52          pieces will be used.
53

EXAMPLES

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

ACCESS

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

SEE ALSO

63       Online: dashline, dashline_params, curved, dashdb, dashdc, frstd,
64       lastd, lined, vectd, ncarg_cbind
65
66       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
67       Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
68

70       Copyright (C) 1987-2007
71       University Corporation for Atmospheric Research
72
73       This documentation is free software; you can redistribute it and/or
74       modify it under the terms of the GNU General Public License as
75       published by the Free Software Foundation; either version 2 of the
76       License, or (at your option) any later version.
77
78       This software is distributed in the hope that it will be useful, but
79       WITHOUT ANY WARRANTY; without even the implied warranty of
80       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
81       General Public License for more details.
82
83       You should have received a copy of the GNU General Public License along
84       with this software; if not, write to the Free Software Foundation,
85       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
86
87
88
89UNIX                              March 1993                     RESET(3NCARG)
Impressum