graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

TEXT 3 (PHOP,,STOP,)

Purpose

Use Text 3 to insert a three-dimensional, geometric text element into the open structure following the element pointer or replace the element pointed at by the element pointer with a Text 3 structure element, depending on the current edit mode.

This structure element specifies a string of geometric text that the graPHIGS API draws on the plane defined by the specified text position and reference vectors.

Two vector definitions orient a local coordinate system, within which the text is positioned. The two reference vectors and the text position define the plane in which the text is drawn. The first vector defines the xaxis of the local coordinate system. The second reference vector defines the half plane of the text in which the positive yaxis lies. The directions specified by Character Up Vector and Text Path attributes are relative to this coordinate system.

If the direction vectors fail to define a local coordinate system (i.e., one of the vectors is zero in length or the vectors are parallel), then the graPHIGS API stores the values (1,0,0) and (0,1,0) in the element.

The graPHIGS API treats control characters in a character string as undefined characters and displays the default for the character set. This default for the character set is the default character in the graPHIGS API character set file. For U.S. English, this is the hyphen character (EBCDIC X'60', ASCII X'2D').

Language Bindings

C

ptext3 (text_pos, text_dir, char_string)

Input Parameters

const Ppoint3 *text_pos

Text position in MC.

const Pvec3 text_dir[2]

Text direction vectors in MC.

const char *char_string

Character string to be displayed.

FORTRAN

PTX3 (px, py, pz, tdx, tdy, tdz, chars)

Input Parameters

real px

x coordinate of text position in MC.

real py

y coordinate of text position in MC.

real pz

z coordinate of text position in MC.

real tdx(2)

x coordinates of the text direction vectors in MC.

real tdy(2)

y coordinates of the text direction vectors in MC.

real tdz(2)

z coordinates of the text direction vectors in MC.

character*(*) chars

Character string to be displayed.

FORTRAN Subset

PTX3S (px, py, pztdx, tdy, tdz, lstr, chars)

Input Parameters

real px

x coordinate of text position in MC.

real py

y coordinate of text position in MC.

real pz

z coordinate of text position in MC.

real tdx(2)

x coordinates of the text direction vectors in MC.

real tdy(2)

y coordinates of the text direction vectors in MC.

real tdz(2)

z coordinates of the text direction vectors in MC.

integer lstr

Length of text string in bytes (>=0).

character*80 chars

Character string to be displayed.

Errors

5: Function Requires State (PHOP,*,STOP,*)

Related Subroutines

Inquire Text Facilities

Set Character Expansion Factor

Set Character Height

Set Character Spacing

Set Character Up Vector

Set Text Alignment

Set Text Color Index

Set Text Font

Set Text Index

Set Text Path

Set Text Precision

TEXT 3 (PHOP,*,STOP,*)

C

Input Parameters

FORTRAN

Input Parameters

FORTRAN Subset

Input Parameters

TEXT 3 (PHOP,,STOP,)