NAME

       AGPWRT - Provides a way for the user to change the style of all text strings drawn by Autograph.

SYNOPSIS

       SUBROUTINE AGPWRT (XPOS,YPOS,CHRS,NCHS,ISIZ,IORI,ICEN)

DESCRIPTION

       XPOS        (an  input expression of type REAL) is the X coordinate of a point relative to which the text
                   string is to be positioned.

       YPOS        (an input expression of type REAL) is the Y coordinate of a point relative to which the  text
                   string is to be positioned.

       CHRS        (an input expression of type CHARACTER) is the text string to be drawn.

       NCHS        (an input expression of type INTEGER) is the length of CHRS - the number of characters in the
                   text string.

       ISIZ        (an  input  expression  of type INTEGER) specifies the size of the characters to be used. The
                   values 0, 1, 2,  and  3  imply  character  widths  of  8,  12,  16,  and  24  plotter  units,
                   respectively. Larger values specify the character width directly.

       IORI        (an  input  expression of type INTEGER) is the orientation angle of the text string, measured
                   in degrees counter-clockwise from a vector which is horizontal and pointing to the right.

       ICEN        (an input expression of type INTEGER) is the centering option. The value  "-1"  implies  that
                   the  text  is  to  be written with (XPOS,YPOS) in the center of the left edge of the leftmost
                   character, the value "0" that (XPOS,YPOS) is to be in the center of the  entire  string,  and
                   the  value  "+1"  that  (XPOS,YPOS) is to be in the center of the right edge of the rightmost
                   character.

USAGE

       This routine is not called by the user program, but by Autograph itself, to draw a numeric  label  or  an
       informational label on the graph. The default version just calls the plot-package routine PWRIT. The user
       may supply a replacement version.

       Note:  A user version of AGPWRT should not call any other Autograph routine.

ACCESS

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

SEE ALSO

       Online:  autograph,  agback,  agbnch,  agchax,  agchcu,  agchil,  agchnl, agcurv, agdshn, aggetc, aggetf,
       aggeti, aggetp, aggetr, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup,  agutol,  anotat,
       displa, ezmxy, ezmy, ezxy, ezy

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                     AGPWRT(3NCARG)