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

NAME

6       AGSETC - Allows a user program to (in effect) store a character string
7       as the value of a specified single parameter.
8

SYNOPSIS

10       CALL AGSETC (TPGN,CUSR)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_agsetc (char *tpgn, char *cusr)
16

DESCRIPTION

18       TPGN        (an input expression of type CHARACTER) is a parameter
19                   identifier, as described for AGSETP, above. The specified
20                   parameter must be one of those which intrinsically have
21                   values of type character: 'LINE/END.', 'LABEL/NAME.',
22                   'LINE/ TEXT.', or 'DASH/PATTERN/n.'
23
24       CUSR        (an input expression of type CHARACTER) is the desired
25                   character string.
26
27                   ·      If 'LINE/END.' is being set, only the first
28                          character of CUSR will be used.
29
30                   ·      If 'LABEL/NAME.' is being set, the length of the
31                          string CUSR will be taken to be "MAX(1,LEN(CUSR))".
32
33                   ·      If the text of a label is being set, CUSR must
34                          either be of the exact length specified by
35                          'LINE/MAXIMUM.' (40 characters, by default) or
36                          shorter; if shorter, it must be terminated by the
37                          character defined by 'LINE/END.'  (default: a '$').
38
39                   ·      If a dash pattern is being set, the length of CUSR
40                          will be taken to be the minimum of "LEN(CUSR)" and
41                          the value specified by 'DASH/LENGTH.'.
42

C-BINDING DESCRIPTION

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

USAGE

48       This routine allows you to set the current value of Autograph
49       parameters.  For a complete list of parameters available in this
50       utility, see the autograph_params man page.
51

EXAMPLES

53       Use the ncargex command to see the following relevant examples: agex05,
54       agex06, agex07, agex08, agex09, agex13, tagupw, tautog, fagaxlbl,
55       fagovrvw.
56

ACCESS

58       To use AGSETC or c_agsetc, load the NCAR Graphics libraries ncarg,
59       ncarg_gks, and ncarg_c, preferably in that order.  To get smoother
60       curves, drawn using spline interpolation, also load libdashsmth.o.  Or,
61       you can use the ncargf77 command to compile your program and load the
62       above libraries, then, to get smoother curves, use the -dashsmth
63       option.
64

MESSAGES

66       See the autograph man page for a description of all Autograph error
67       messages and/or informational messages.
68

SEE ALSO

70       Online: autograph, autograph_params, agback, agbnch, agchax, agchcu,
71       agchil, agchnl, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr,
72       agpwrt, agrstr, agsave, agsetf, agseti, agsetp, agsetr, agstup, agutol,
73       anotat, displa, ezmxy, ezmy, ezxy, ezy
74
75       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
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                    AGSETC(3NCARG)
Impressum