NAME

text − output a string of characters. 

SYNOPSIS

C SYNTAX

void append_text(fildes,string,xform,more);
int fildes,xform,more;
char *string;
 
void text2d(fildes,x,y,string,xform,more);
int fildes,xform,more;
float x,y;
char *string;
 
void text3d(fildes,x,y,z,string,xform,more);
int fildes,xform,more;
float x,y,x;
char *string;
 
void dctext(fildes,dcx,dcy,string);
int fildes,dcx,dcy;
char *string;

FORTRAN77 SYNTAX

subroutine append_text(fildes,string,xform,more)
integer*4 fildes,xform,more
character*(*) string
 
subroutine text2d(fildes,x,y,string,xform,more)
integer*4 fildes,xform,more
real x,y
character*(*) string
 
subroutine text3d(fildes,x,y,z,string,xform,more)
integer*4 fildes,xform,more
real x,y,x
character*(*) string
 
subroutine dctext(fildes,dcx,dcy,string)
integer*4 fildes,dcx,dcy
character*(*) string;

PASCAL SYNTAX

procedure append_text(fildes:integer;string:string255;xform,more:integer);
 
procedure text2d(fildes:integer;x,y:real;string:string255;xform,more :integer);
 
procedure text3d(fildes:integer;x,y,z:real;string:string255; xform,more:integer);
 
procedure dctext(fildes,dcx,dcy:integer;string:string255);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: ANSI Computer Graphics Interface

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphics device is opened. 
x, y, z
starting coordinate for the string in current units.
dcx, dcy
starting coordinate for the string in device units.
string
an ASCII string of characters terminated with a null character.
xform
an enumerated value specifying the type of transformation to perform on the font coordinates:
        VDC_TEXT = vdc
        WORLD_COORDINATE_TEXT = world coordinate
        TOS_TEXT = top of matrix stack
more
is set to TRUE (1) if more characters are to be buffered with the current text and FALSE (0) if no buffering is needed.

DISCUSSION

The text primitives draw characters starting at the Virtual Device Coordinate current position or the (x,y) or the (x,y,z) coordinate specified.  If more is non-zero, then the characters are buffered waiting more text before the text alignment and drawing are accomplished. If more is zero then the alignment and drawing are done immediately.  xform specifies the type of transformation to apply to the font coordinates. 
 
If xform equals VDC_TEXT (zero) then the current font transformation ( character_height , character_width , etc.) is pre-concatenated with the vdc to device coordinate transformation and used as the font to device coordinate transformation. 
 
If xform equals WORLD_COORDINATE_TEXT (one) then the current font transformation is pre-concatenated with the transformation matrix on top of the matrix stack and used as the font to device coordinate transformation. 
 
If xform equals TOS_TEXT (two) then the top of the matrix stack is used as the font to device coordinate transformation matrix. 
 
The Device Coordinate text procedure draws characters starting at the device coordinate specified and only with character path right.  All control characters are ignored except for space (octal 40).
 
Only the dc character attributes ( dccharacter_height, dccharacter_width ) are used in drawing DC text. 

Hewlett-Packard Company  —  May 11, 2021