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-2009
69       University Corporation for Atmospheric Research
70       The use of this Software is governed by a License Agreement.
71
72
73
74UNIX                              March 1993                    AGPWRT(3NCARG)
Impressum