DOKK / manpages / debian 12 / libncarg-dev / dashdc.3ncarg.en
DASHDC(3NCARG) NCAR GRAPHICS DASHDC(3NCARG)

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

CALL DASHDC (IPAT,JCRT,JSIZE)

#include <ncarg/ncargC.h>

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

(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.
(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.
(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

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

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

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.

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

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 (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.

March 1993 UNIX