gsxtxt

Purpose

     Writes annotated text using the rtfont format.

C Syntax

     int gsxtxt_ (x, y, number, text)

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

FORTRAN Syntax

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

     INTEGER x, y, number
     CHARACTER*n text

Pascal Syntax

     FUNCTION gsxtxt_ (

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

Description

     The gsxtxt subroutine displays  the specified text string
     using  the rtfont  format.   Only those  full or  partial
     characters that fall within the clip box specified by the
     gsxtat  subroutine  are  displayed.  In  addition,  since
     there is  no default rtfont  defined for use by  the GSL,
     the gsxtat subroutine must be  called to set all relevant
     attributes  before the  first  call  to this  subroutine.
     (See "gsxtat" for additional information.)

     The relevant attributes are:

     o   xtext foreground color
     o   xtext background color
     o   xtext logical operation
     o   xtext clip box
     o   xtext current rtfont file
     o   plane mask
     o   color map

     Parameters

     x, y              Define   the   baseline  position   for
                       writing the text.

     number            Indicates the number  of bytes to write
                       from the text string.

     text              Contains the ASCII  codes for the char-
                       acters to write, as an array.

     For Pascal, the application must declare the array passed
     as  being  fixed  length   and  declare  the  routine  as
     accepting an array  of that length; the k  in the routine
     declaration must be a constant.

Return Value

     GS_SUCC   Successful.

     Since  the text  is either  displayed or  clipped in  any
     case, the gsxtxt subroutine  always completes with a suc-
     cessful return code.

File

     /usr/include/rtfont.h

Related Information

     In this book:  "fonts" and "gsxtat."

VOLUME II:  FILES AND DEVICE DRIVER INFORMATION

FILES AND DEVICE DRIVERS