1Dashline(3NCARG) NCAR GRAPHICS Dashline(3NCARG)
2
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
14 DASHDB - Defines a dash pattern without labels.
15 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 FRSTD - Defines the first of a sequence of points through which a
21 curve is to be drawn.
22 VECTD - Defines the second and following of a sequence of points
24 through which a curve is to be drawn.
25 LASTD - Terminates a sequence of calls to draw a curve (a call to
27 FRSTD followed by one or more calls to VECTD).
28 LINED - Draws a straight line segment between two points.
30 CURVED - Draws a curve through a sequence of points.
32 RESET - The "super" version of RESET zeroes the internal integer
34 array used to detect crowded lines; other versions do
35 nothing.
36
38 #include <ncarg/ncargC.h>
39 c_dashdb
41 c_dashdc
42 c_frstd
43 c_vectd
44 c_lastd
45 c_lined
46 c_curved
47 c_reset
48
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 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 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
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 To run a code called mycode.f which has one or more calls to Dashline
80 entries, issue one of the commands:
81 NORMAL Command: "ncargf77 mycode.f"
84 The lines will be drawn as unsmoothed dashed or solid lines.
86 DASHDC may be called to define a dash pattern with labels.
87 QUICK Command: "ncargf77 -quick mycode.f"
91 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 SMOOTH Command: "ncargf77 -smooth mycode.f"
100 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 SUPER Command: "ncargf77 -super mycode.f"
108 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
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 CFVLD -- VECTD CALL OCCURS BEFORE A CALL TO FRSTD
122 You must call FRSTD before the first call to VECTD.
123 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 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 FDVDLD -- VECTD CALL OCCURS BEFORE A CALL TO FRSTD
133 You must call FRSTD before the first call to VECTD.
134
136 Online: dashline_params, curved, dashdb, dashdc, frstd, lastd, lined,
137 reset, vectd, ncarg_cbind
138 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
140 Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
141
143 Copyright (C) 1987-2007
144 University Corporation for Atmospheric Research
145 This documentation is free software; you can redistribute it and/or
147 modify it under the terms of the GNU General Public License as
148 published by the Free Software Foundation; either version 2 of the
149 License, or (at your option) any later version.
150 This software is distributed in the hope that it will be useful, but
152 WITHOUT ANY WARRANTY; without even the implied warranty of
153 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
154 General Public License for more details.
155 You should have received a copy of the GNU General Public License along
157 with this software; if not, write to the Free Software Foundation,
158 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
159UNIX March 1993 Dashline(3NCARG)