DASHDC(3NCARG)

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.