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 parame-
     ters 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

     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.

Related Information

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