1AGCHNL(3NCARG) NCAR GRAPHICS AGCHNL(3NCARG)
2
6 AGCHNL - Provides a way for the user to substitute arbitrary character
7 strings for the numeric labels generated by Autograph.
8
10 SUBROUTINE AGCHNL (IAXS,VILS,CHRM,MCIM,NCIM,IPXM,
11 + CHRE,MCIE,NCIE)
12
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 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 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 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 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 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 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 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 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
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 Note: A user version of AGCHNL should not call any other Autograph
62 routine.
63
65 To use AGCHNL, load the NCAR Graphics libraries ncarg, ncarg_gks, and
66 ncarg_c, preferably in that order.
67
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 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
75
77 Copyright (C) 1987-2007
78 University Corporation for Atmospheric Research
79 This documentation is free software; you can redistribute it and/or
81 modify it under the terms of the GNU General Public License as
82 published by the Free Software Foundation; either version 2 of the
83 License, or (at your option) any later version.
84 This software is distributed in the hope that it will be useful, but
86 WITHOUT ANY WARRANTY; without even the implied warranty of
87 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
88 General Public License for more details.
89 You should have received a copy of the GNU General Public License along
91 with this software; if not, write to the Free Software Foundation,
92 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
93UNIX March 1993 AGCHNL(3NCARG)