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').
|ptext3 (text_pos, text_dir, char_string)|
|PTX3 (px, py, pz, tdx, tdy, tdz, chars)|
|PTX3S (px, py, pztdx, tdy, tdz, lstr, chars)|