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

NAME

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

SYNOPSIS

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

DESCRIPTION

13       XPOS        (an input expression of type REAL) is the X coordinate of a
14                   point relative to which the text string is to be
15                   positioned.
16
17       YPOS        (an input expression of type REAL) is the Y coordinate of a
18                   point relative to which the text string is to be
19                   positioned.
20
21       CHRS        (an input expression of type CHARACTER) is the text string
22                   to be drawn.
23
24       NCHS        (an input expression of type INTEGER) is the length of CHRS
25                   - the number of characters in the text string.
26
27       ISIZ        (an input expression of type INTEGER) specifies the size of
28                   the characters to be used. The values 0, 1, 2, and 3 imply
29                   character widths of 8, 12, 16, and 24 plotter units,
30                   respectively. Larger values specify the character width
31                   directly.
32
33       IORI        (an input expression of type INTEGER) is the orientation
34                   angle of the text string, measured in degrees counter-
35                   clockwise from a vector which is horizontal and pointing to
36                   the right.
37
38       ICEN        (an input expression of type INTEGER) is the centering
39                   option. The value "-1" implies that the text is to be
40                   written with (XPOS,YPOS) in the center of the left edge of
41                   the leftmost character, the value "0" that (XPOS,YPOS) is
42                   to be in the center of the entire string, and the value
43                   "+1" that (XPOS,YPOS) is to be in the center of the right
44                   edge of the rightmost character.
45

USAGE

47       This routine is not called by the user program, but by Autograph
48       itself, to draw a numeric label or an informational label on the graph.
49       The default version just calls the plot-package routine PWRIT. The user
50       may supply a replacement version.
51
52       Note:  A user version of AGPWRT should not call any other Autograph
53       routine.
54

ACCESS

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

SEE ALSO

60       Online: autograph, agback, agbnch, agchax, agchcu, agchil, agchnl,
61       agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agrstr, agsave,
62       agsetc, agsetf, agseti, agsetp, agsetr, agstup, agutol, anotat, displa,
63       ezmxy, ezmy, ezxy, ezy
64
65       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
66

68       Copyright (C) 1987-2007
69       University Corporation for Atmospheric Research
70
71       This documentation is free software; you can redistribute it and/or
72       modify it under the terms of the GNU General Public License as
73       published by the Free Software Foundation; either version 2 of the
74       License, or (at your option) any later version.
75
76       This software is distributed in the hope that it will be useful, but
77       WITHOUT ANY WARRANTY; without even the implied warranty of
78       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
79       General Public License for more details.
80
81       You should have received a copy of the GNU General Public License along
82       with this software; if not, write to the Free Software Foundation,
83       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
84
85
86
87UNIX                              March 1993                    AGPWRT(3NCARG)
Impressum