1DASHDC(3NCARG) NCAR GRAPHICS DASHDC(3NCARG)
2
6 DASHDC - Defines a dash pattern with labels. If DASHDC is called when
7 the "quick" version of Dashline is used, an error exit results.
8
10 CALL DASHDC (IPAT,JCRT,JSIZE)
11
13 #include <ncarg/ncargC.h>
14 void c_dashdc (char *ipat, int jcrt, int jsize)
16
18 IPAT (an input constant or variable of type CHARACTER) specifies
19 the dash pattern to be used. Although IPAT is of arbitrary
20 length, 60 characters seems to be a practical limit. This
21 pattern is repeated for successive line segments until the
22 full line is drawn. A dollar sign in IPAT indicates solid;
23 an apostrophe indicates a gap; blanks are ignored. Any
24 character in IPAT which is not a dollar sign, apostrophe,
25 or blank is considered to be part of a line label. Each
26 line label can be at most 15 characters in length.
27 Sufficient white space is reserved in the dashed line for
28 writing line labels.
29 JCRT (an input expression of type INTEGER) specifies that the
31 length to be assigned to each increment of the line pattern
32 is (JCRT/1023.) NDCs (Normalized Device Coordinates). Each
33 increment is either a gap (represented by a dollar sign in
34 IPAT) or a line segment (represented by an apostrophe in
35 IPAT). JCRT must be greater than or equal to 1.
36 JSIZE (an input expression of type INTEGER) specifies the width
38 of the plotted characters, as follows:
39 0 .0078 NDCs
41 1 .0117 NDCs
43 2 .0156 NDCs
45 3 .0234 NDCs
47 >3 JSIZE/1023. NDCs
49
51 The C-binding argument descriptions are the same as the FORTRAN
52 argument descriptions.
53
55 Use the ncargex command to see the following relevant examples: tdashc,
56 tdashp, tdashs, fcoord1, fcoord2, fdldashc, fdldashd.
57
59 DASHDC may be called to define a dash pattern for any of the four
60 versions of Dashline except the "quick" version; if you call it when
61 the "quick" version is in use, an error exit will result.
62 A dash pattern defined by a call to DASHDC will supersede one defined
64 by an earlier call to DASHDB or DASHDC.
65
67 To use DASHDC or c_dashdc, load the NCAR Graphics libraries ncarg,
68 ncarg_gks, and ncarg_c, preferably in that order.
69
71 Online: dashline, dashline_params, curved, dashdb, frstd, lastd, lined,
72 reset, vectd, ncarg_cbind
73 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
75 Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
76
78 Copyright (C) 1987-2007
79 University Corporation for Atmospheric Research
80 This documentation is free software; you can redistribute it and/or
82 modify it under the terms of the GNU General Public License as
83 published by the Free Software Foundation; either version 2 of the
84 License, or (at your option) any later version.
85 This software is distributed in the hope that it will be useful, but
87 WITHOUT ANY WARRANTY; without even the implied warranty of
88 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
89 General Public License for more details.
90 You should have received a copy of the GNU General Public License along
92 with this software; if not, write to the Free Software Foundation,
93 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
94UNIX March 1993 DASHDC(3NCARG)