AGCHNL(3NCARG) NCAR GRAPHICS AGCHNL(3NCARG)
AGCHNL - Provides a way for the user to substitute arbitrary character strings for the
numeric labels generated by Autograph.
SUBROUTINE AGCHNL (IAXS,VILS,CHRM,MCIM,NCIM,IPXM,
IAXS (an input expression of type INTEGER) is the number of the axis being drawn.
The values 1, 2, 3, and 4 imply the left, right, bottom, and top axes,
VILS (an input expression of type REAL) is the value to be represented by the
numeric label, in the label system for the axis. The value of VILS must not be
CHRM (an input variable of type CHARACTER), on entry, contains the mantissa of the
numeric label, as it will appear if AGCHNL makes no changes. If the numeric
label includes a "times" symbol, it is represented by a blank in CHRM. (See
IPXM, below.) CHRM may be modified.
MCIM (an input expression of type INTEGER) is the length of CHRM - the maximum
number of characters that it will hold. The value of MCIM must not be
NCIM (an input variable of type INTEGER), on entry, is the number of meaningful
characters in CHRM. If CHRM is changed, NCIM should be changed accordingly.
IPXM (an input variable of type INTEGER), on entry, is zero if there is no "times"
symbol in CHRM; if it is non-zero, it is the index of a character position in
CHRM. If AGCHNL changes the position of the "times" symbol in CHRM, removes
it, or adds it, the value of IPXM must be changed.
CHRE (an input variable of type CHARACTER), on entry, contains the exponent of the
numeric label, as it will appear if AGCHNL makes no changes. CHRE may be
MCIE (an input expression of type INTEGER) is the length of CHRE - the maximum
number of characters that it will hold. The value of MCIE must not be
NCIE (an input variable of type INTEGER), on entry, is the number of meaningful
characters in CHRE. If CHRE is changed, NCIE should be changed accordingly.
This routine is not called by the user program, but by Autograph itself, just after the
character string representing each numeric label has been generated and just before it is
written on the graph. The user may change the character string in any desired way. Axes
may thereby be labeled using the names of the months, Roman numerals, etc.
Note: A user version of AGCHNL should not call any other Autograph routine.
To use AGCHNL, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably
in that order.
Online: autograph, agback, agbnch, agchax, agchcu, agchil, agcurv, agdshn, aggetc, aggetf,
aggeti, aggetp, aggetr, agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr,
agstup, agutol, anotat, displa, ezmxy, ezmy, ezxy, ezy
Hardcopy: NCAR Graphics Fundamentals, UNIX Version
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
UNIX March 1993 AGCHNL(3NCARG)