GSGTXT(3g,L)                AIX Technical Reference                GSGTXT(3g,L)



-------------------------------------------------------------------------------
gsgtxt



PURPOSE

Writes geometric text.

C SYNTAX

int gsgtxt_ (x, y, number, text)

int *x, *y, *number;
char *text;

FORTRAN SYNTAX

INTEGER function gsgtxt (x, y, number, text)

INTEGER x, y, number
CHARACTER*n text

PASCAL SYNTAX

FUNCTION gsgtxt_ (

VAR x, y, number: INTEGER;
VAR text: ARRAY [1..k] of CHAR
): INTEGER [PUBLIC];

DESCRIPTION

The gsgtxt subroutine writes geometric characters starting at the baseline
position defined by the parameters and writes the number of characters
indicated by the parameters according to the relevant attributes.

The relevant attributes are:

  o Color map
  o Plane mask
  o Font
  o Text color index
  o Character expansion factor
  o Character spacing
  o Character height
  o Character up vector
  o Character alignment
  o Baseline direction.

Parameters




Processed November 7, 1990       GSGTXT(3g,L)                                 1

GSGTXT(3g,L)                AIX Technical Reference                GSGTXT(3g,L)



x, y              Define the coordinates of the baseline position for writing
                  geometric text.

number            Indicates the number of bytes to write from the text string.
                  The maximum number of characters allowed is 1024 for single
                  byte fonts and 512 for two-byte fonts, which is determined by
                  the display and font in use.

text              Contains the N-bit ASCII codes for the characters to write,
                  as an array.

RETURN VALUE

GS_SUCC  Successful.
GS_CORD  Invalid coordinate.
GS_FBUF  Frame buffer overflow.
GS_INAC  Virtual terminal inactive.
GS_NOFT  Font not loaded.
GS_NOAT  Text attribute not set.

RELATED INFORMATION

In this book:  "fonts,"  "Geometric Text Font Format," "gsgtat," and  "gsqgtx."
































Processed November 7, 1990       GSGTXT(3g,L)                                 2