append_text(3G)

NAME

append_text − output a string of characters.

SYNOPSIS

C Syntax:

void append_text(fildes,string,xform,more);
int fildes,xform,more;
char *string;

FORTRAN77 Syntax:

subroutine append_text(fildes,string,xform,more)
integer*4 fildes,xform,more
character*(*) string

Pascal Syntax:

procedure append_text(fildes:integer;string:string255;xform,more:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

string ASCII string of characters terminated with a null character.

xform 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 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 append_text primitive draws characters starting at the current VDC or WC position. If more is non-zero, characters are buffered, awaiting more text before text alignment and drawing are performed. This allows changing of text color, current font, and other such calls between append_text and text calls. If more is zero, alignment and drawing are done immediately. Xform specifies the type of transformation to be applied to the font coordinates.

If xform equals VDC_TEXT (zero), 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), 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), the top of the matrix stack is used as the font-to-device coordinate transformation matrix.

Museum

Related Articles