GSTATT(3g,L) AIX Technical Reference GSTATT(3g,L)
-------------------------------------------------------------------------------
gstatt
PURPOSE
Sets the text attributes for annotated text.
C SYNTAX
int gstatt_ (color, page, baseline, font, name)
int *color, *page, *baseline, *font;
char *name;
FORTRAN SYNTAX
INTEGER function gstatt (color, page, baseline, font, name)
INTEGER color, page, baseline, font
CHARACTER*n name
PASCAL SYNTAX
FUNCTION gstatt_ (
VAR color, page, baseline, font: INTEGER;
VAR name: ARRAY [0..k] of CHAR
): INTEGER [PUBLIC];
DESCRIPTION
The gstatt subroutine defines the attributes for the class of text drawing
functions.
Parameters
color Specifies a text color entry in the color map. If it is -1,
the attribute is unchanged.
page Specifies the code page of a font for the display to use.
The valid values for IBM supplied fonts are 0, 1, and 2 for
code pages P0, P1, and P2, respectively. The value -1
indicates no change.
For printers and plotters, the page parameter is a font value
specification. Again, the value -1 indicates no change.
baseline Determines the direction of the text drawing. The valid
values are:
Processed November 7, 1990 GSTATT(3g,L) 1
GSTATT(3g,L) AIX Technical Reference GSTATT(3g,L)
-1 Attribute remains unchanged.
0 Specifies 0 degrees, or left to right in the viewer's
terms.
1 Specifies 90 degrees, or up in the viewer's terms.
2 Specifies 180 degrees, or right to left in the viewer's
terms.
Note: The characters appear upside down.
3 For 270 degrees, or down in the viewer's terms.
If the baseline is other than 0 degrees and the font index is
0, then the font named by the name parameter must be a
pre-rotated font. When a baseline change is made, another
font path name is required.
font Specifies, for displays, the font to use for text output
operations. For printers and plotters, the font parameter
specifies the vertical height of the font in pixels.
If the font index is -1, no change is made. If the font
index is 0, then gstatt uses the font specified by the name
parameter. If the font index is a value from 1 to 14, the
GSL uses one of the following predefined fonts:
Processed November 7, 1990 GSTATT(3g,L) 2
GSTATT(3g,L) AIX Technical Reference GSTATT(3g,L)
+--+------------+----------------+-----------+-----------+
| | Font Index | Width x Height | Style | Filename |
| | | (in pixels) | | |
+--+------------+----------------+-----------+-----------+
| | | | | |
+--+------------+----------------+-----------+-----------+
| | 1 | 9 x 20 | Normal | nrm1.9x20 |
+--+------------+----------------+-----------+-----------+
| | 2 | 9 x 20 | Italic | itl1.9x20 |
+--+------------+----------------+-----------+-----------+
| | 3 | 9 x 20 | Bold | bld1.9x20 |
+--+------------+----------------+-----------+-----------+
| | 4 | 8 x 14 | Normal | nrm1.8x14 |
+--+------------+----------------+-----------+-----------+
| | 5 | 4 x 8 | Normal | nrm1.4x8 |
+--+------------+----------------+-----------+-----------+
| | 6 | 18 x 40 | Normal | nrm1.18x40|
+--+------------+----------------+-----------+-----------+
| | 7 | 12 x 30 | Normal | nrm1.12x30|
+--+------------+----------------+-----------+-----------+
| | 8 | 9 x 20 | Ergonomic | erg1.9x20 |
+--+------------+----------------+-----------+-----------+
| | 9 | 6 x 9 | Normal | nrm1.6x9 |
+--+------------+----------------+-----------+-----------+
| | 10 | 6 x 11 | Normal | nrm1.6x11 |
+--+------------+----------------+-----------+-----------+
| | 11 | 7 x 15 | Normal | nrm1.7x15 |
+--+------------+----------------+-----------+-----------+
| | 12 | 7 x 22 | Normal | nrm1.7x22 |
+--+------------+----------------+-----------+-----------+
| | 13 | 11 x 23 | Normal | nrm1.11x23|
+--+------------+----------------+-----------+-----------+
| | 14 | 11 x 23 | Bold | bld1.11x23|
+--+------------+----------------+-----------+-----------+
All annotated text fonts are stored in the /usr/lpp/gsl/fonts
directory. Many of the fonts are supplied with rotated
versions.
name Contains the null-terminated full path name of the file used
when the font attribute is specified as user. See "fonts"
for the format of this file.
If a single-shift control is outstanding and gstatt is called to change the
code page or the font, then the single-shift control is ignored.
For Pascal, the application must declare the arrays passed as being fixed
length and declare the routine as accepting arrays of that length. The k in
the routine declaration must be a constant.
RETURN VALUE
Processed November 7, 1990 GSTATT(3g,L) 3
GSTATT(3g,L) AIX Technical Reference GSTATT(3g,L)
GS_SUCC Successful.
GS_COLI Invalid color index.
GS_CPID Invalid code page identifier.
GS_BASL Invalid baseline direction.
GS_FNTI Invalid font index.
GS_FNTN Invalid file name.
RELATED INFORMATION
In this book: "fonts."
Processed November 7, 1990 GSTATT(3g,L) 4