NAME

       DASHDC - Defines a dash pattern with labels.  If DASHDC is called when the "quick" version of Dashline is
       used, an error exit results.

SYNOPSIS

       CALL DASHDC (IPAT,JCRT,JSIZE)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_dashdc (char *ipat, int jcrt, int jsize)

DESCRIPTION

       IPAT        (an  input  constant  or  variable  of type CHARACTER) specifies the dash pattern to be used.
                   Although IPAT is of arbitrary length, 60 characters seems to  be  a  practical  limit.   This
                   pattern is repeated for successive line segments until the full line is drawn.  A dollar sign
                   in  IPAT indicates solid; an apostrophe indicates a gap; blanks are ignored. Any character in
                   IPAT which is not a dollar sign, apostrophe, or blank is considered to  be  part  of  a  line
                   label.  Each  line  label  can  be at most 15 characters in length. Sufficient white space is
                   reserved in the dashed line for writing line labels.

       JCRT        (an input expression of type INTEGER) specifies that  the  length  to  be  assigned  to  each
                   increment  of  the  line  pattern is (JCRT/1023.) NDCs (Normalized Device Coordinates).  Each
                   increment is either a gap  (represented  by  a  dollar  sign  in  IPAT)  or  a  line  segment
                   (represented by an apostrophe in IPAT).  JCRT must be greater than or equal to 1.

       JSIZE       (an  input  expression  of  type  INTEGER)  specifies the width of the plotted characters, as
                   follows:

                    0  .0078 NDCs

                    1  .0117 NDCs

                    2  .0156 NDCs

                    3  .0234 NDCs

                   >3  JSIZE/1023. NDCs

C-BINDING DESCRIPTION

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

EXAMPLES

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

USAGE

       DASHDC may be called to define a dash pattern for any of the four versions of Dashline except the "quick"
       version; if you call it when the "quick" version is in use, an error exit will result.

       A dash pattern defined by a call to DASHDC will supersede one defined by an earlier  call  to  DASHDB  or
       DASHDC.

ACCESS

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

SEE ALSO

       Online: dashline, dashline_params, curved, dashdb, frstd, lastd, lined, reset, vectd, ncarg_cbind

       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version; User's
       Guide for NCAR GKS-0A Graphics

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                     DASHDC(3NCARG)