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