ncl_dashline(3)

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

NAME

6       Dashline - A set of line-drawing routines that can be used to generate
7       various dashed line patterns (including solid), can add labels to the
8       lines, can smooth the lines, and can suppress crowding of lines.  There
9       are four different versions of Dashline: "normal", "quick", "smooth",
10       and "super".  See the ACCESS Section for details on how to invoke the
11       various versions.
12

SYNOPSIS

14       DASHDB -  Defines a dash pattern without labels.
15
16       DASHDC -  Defines a dash pattern with labels.  If DASHDC is called when
17                 the "quick" version of Dashline is used, an error exit
18                 results.
19
20       FRSTD  -  Defines the first of a sequence of points through which a
21                 curve is to be drawn.
22
23       VECTD  -  Defines the second and following of a sequence of points
24                 through which a curve is to be drawn.
25
26       LASTD  -  Terminates a sequence of calls to draw a curve (a call to
27                 FRSTD followed by one or more calls to VECTD).
28
29       LINED  -  Draws a straight line segment between two points.
30
31       CURVED -  Draws a curve through a sequence of points.
32
33       RESET  -  The "super" version of RESET zeroes the internal integer
34                 array used to detect crowded lines; other versions do
35                 nothing.
36

C-BINDING SYNOPSIS

38       #include <ncarg/ncargC.h>
39
40       c_dashdb
41       c_dashdc
42       c_frstd
43       c_vectd
44       c_lastd
45       c_lined
46       c_curved
47       c_reset
48

USAGE

50       The Dashline utility allows you to draw various kinds of lines.  In all
51       four versions of it (quick, normal, smooth and super), you can specify
52       an arbitrary dash pattern for the lines (including a solid line).  In
53       all but the quick version, you can also add interspersed labels to the
54       lines for purposes such as naming lines in an XY plot or assigning
55       contour levels to contour lines.  In the smooth and super versions, the
56       lines can also be smoothed using splines under tension.
57
58       Warning:  You must be careful when using the smoothing option.
59                 Allowing a high degree of smoothing may have serious side
60                 effects, such as XY curves with multiple valued loops and
61                 contours which cross over other contours.
62
63       The super version additionally allows for the culling of crowded lines.
64       In order for the culling process to work properly, the routine RESET
65       must be called at the beginning of each picture; when using other
66       versions of Dashline, the calls to RESET may be left in, as they then
67       do nothing.
68

ACCESS

70       To use the normal version of the Dashline utility, load the NCAR
71       Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that
72       order.  Other optional libraries to create the quick, smooth, and super
73       versions of Dashline are automatically linked in by the ncargf77
74       command.  If you need to know the names of these libraries for a
75       particular version of Dashline, execute an "ncargf77" command with the
76       appropriate option and a dummy input file and examine the resulting
77       command line that is echoed and executed.
78
79       To run a code called mycode.f which has one or more calls to Dashline
80       entries, issue one of the commands:
81
82
83       NORMAL    Command:  "ncargf77 mycode.f"
84
85                 The lines will be drawn as unsmoothed dashed or solid lines.
86                 DASHDC may be called to define a dash pattern with labels.
87
88
89
90       QUICK     Command:  "ncargf77 -quick mycode.f"
91
92                 The lines will be drawn as unsmoothed dashed or solid lines.
93                 The dash pattern may not include labels.  If DASHDC is
94                 called, an error exit will result; DASHDB must be used
95                 instead.
96
97
98
99       SMOOTH    Command:  "ncargf77 -smooth mycode.f"
100
101                 The lines will be drawn as dashed or solid lines, smoothed
102                 using splines under tension.  DASHDC may be called to define
103                 a dash pattern with labels.
104
105
106
107       SUPER     Command:  "ncargf77 -super mycode.f"
108
109                 The lines will be drawn as dashed or solid lines, smoothed
110                 using splines under tension.  DASHDC may be called to define
111                 a dash pattern with labels.  Crowded lines will be thinned;
112                 in order for this to work properly, you must remember to call
113                 RESET at the beginning of each picture.
114

MESSAGES

116       When error conditions are detected, the support routine SETER is called
117       in such a way that it writes a message to the standard error file (as
118       defined by I1MACH(4)) and then terminates execution. The possible error
119       messages are as follows:
120
121       CFVLD  -- VECTD CALL OCCURS BEFORE A CALL TO FRSTD
122              You must call FRSTD before the first call to VECTD.
123
124       DASHDB -- BLOCKDATA DASHBD APPARENTLY NOT LOADED CORRECTLY
125              If you have used the ncargf77 command options as discussed in
126              the ACCESS Section, see your system administrator.
127
128       DASHDC -- BLOCKDATA DASHBD APPARENTLY NOT LOADED CORRECTLY
129              You have called DASHDC when using the "quick" version of
130              Dashline.  This is not allowed.
131
132       FDVDLD -- VECTD CALL OCCURS BEFORE A CALL TO FRSTD
133              You must call FRSTD before the first call to VECTD.
134

COPYRIGHT

143       Copyright (C) 1987-2009
144       University Corporation for Atmospheric Research
145       The use of this Software is governed by a License Agreement.
146
147
148
149UNIX                              March 1993                  Dashline(3NCARG)