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

NAME

6       AGCHNL - Provides a way for the user to substitute arbitrary character
7       strings for the numeric labels generated by Autograph.
8

SYNOPSIS

10        SUBROUTINE AGCHNL (IAXS,VILS,CHRM,MCIM,NCIM,IPXM,
11       + CHRE,MCIE,NCIE)
12

DESCRIPTION

14       IAXS        (an input expression of type INTEGER) is the number of the
15                   axis being drawn. The values 1, 2, 3, and 4 imply the left,
16                   right, bottom, and top axes, respectively.
17
18       VILS        (an input expression of type REAL) is the value to be
19                   represented by the numeric label, in the label system for
20                   the axis. The value of VILS must not be altered.
21
22       CHRM        (an input variable of type CHARACTER), on entry, contains
23                   the mantissa of the numeric label, as it will appear if
24                   AGCHNL makes no changes. If the numeric label includes a
25                   "times" symbol, it is represented by a blank in CHRM. (See
26                   IPXM, below.)  CHRM may be modified.
27
28       MCIM        (an input expression of type INTEGER) is the length of CHRM
29                   - the maximum number of characters that it will hold.  The
30                   value of MCIM must not be altered.
31
32       NCIM        (an input variable of type INTEGER), on entry, is the
33                   number of meaningful characters in CHRM. If CHRM is
34                   changed, NCIM should be changed accordingly.
35
36       IPXM        (an input variable of type INTEGER), on entry, is zero if
37                   there is no "times" symbol in CHRM; if it is non-zero, it
38                   is the index of a character position in CHRM. If AGCHNL
39                   changes the position of the "times" symbol in CHRM, removes
40                   it, or adds it, the value of IPXM must be changed.
41
42       CHRE        (an input variable of type CHARACTER), on entry, contains
43                   the exponent of the numeric label, as it will appear if
44                   AGCHNL makes no changes. CHRE may be modified.
45
46       MCIE        (an input expression of type INTEGER) is the length of CHRE
47                   - the maximum number of characters that it will hold.  The
48                   value of MCIE must not be altered.
49
50       NCIE        (an input variable of type INTEGER), on entry, is the
51                   number of meaningful characters in CHRE. If CHRE is
52                   changed, NCIE should be changed accordingly.
53

USAGE

55       This routine is not called by the user program, but by Autograph
56       itself, just after the character string representing each numeric label
57       has been generated and just before it is written on the graph. The user
58       may change the character string in any desired way. Axes may thereby be
59       labeled using the names of the months, Roman numerals, etc.
60
61       Note:  A user version of AGCHNL should not call any other Autograph
62       routine.
63

ACCESS

65       To use AGCHNL, load the NCAR Graphics libraries ncarg, ncarg_gks, and
66       ncarg_c, preferably in that order.
67

SEE ALSO

69       Online: autograph, agback, agbnch, agchax, agchcu, agchil, agcurv,
70       agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr, agsave,
71       agsetc, agsetf, agseti, agsetp, agsetr, agstup, agutol, anotat, displa,
72       ezmxy, ezmy, ezxy, ezy
73
74       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
75
77       Copyright (C) 1987-2009
78       University Corporation for Atmospheric Research
79       The use of this Software is governed by a License Agreement.
80
81
82
83UNIX                              March 1993                    AGCHNL(3NCARG)
Impressum