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

NAME

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

SYNOPSIS

10       CALL DASHDC (IPAT,JCRT,JSIZE)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_dashdc (char *ipat, int jcrt, int jsize)
16

DESCRIPTION

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
30       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
37       JSIZE       (an input expression of type INTEGER) specifies the width
38                   of the plotted characters, as follows:
39
40                    0  .0078 NDCs
41
42                    1  .0117 NDCs
43
44                    2  .0156 NDCs
45
46                    3  .0234 NDCs
47
48                   >3  JSIZE/1023. NDCs
49

C-BINDING DESCRIPTION

51       The C-binding argument descriptions are the same as the FORTRAN
52       argument descriptions.
53

EXAMPLES

55       Use the ncargex command to see the following relevant examples: tdashc,
56       tdashp, tdashs, fcoord1, fcoord2, fdldashc, fdldashd.
57

USAGE

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
63       A dash pattern defined by a call to DASHDC will supersede one defined
64       by an earlier call to DASHDB or DASHDC.
65

ACCESS

67       To use DASHDC or c_dashdc, load the NCAR Graphics libraries ncarg,
68       ncarg_gks, and ncarg_c, preferably in that order.
69

SEE ALSO

71       Online: dashline, dashline_params, curved, dashdb, frstd, lastd, lined,
72       reset, vectd, ncarg_cbind
73
74       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-2009
79       University Corporation for Atmospheric Research
80       The use of this Software is governed by a License Agreement.
81
82
83
84UNIX                              March 1993                    DASHDC(3NCARG)
Impressum