Name

DATX − Specifies text formats other than 8-bit formats. 

Operating States: PHOP, ∗, STOP, ∗
Digital PHIGS extension function
Creates a structure element

Syntax

DATX (PX, PY, TXTYPE, CHARS)

Argument   Data Type       Access   Description
---------------------------------------------------------------------------
PX, PY     Real            Read     Reference point, in modeling
                                    coordinates
TXTYPE     Integer         Read     Type of text
CHARS      Character ∗(∗)  Read     Text string
---------------------------------------------------------------------------

Constants

Defined Argument   Constant   Description
---------------------------------------------------------------------------
TXTYPE             DTT8       8-bit text
                   DTT16L     16-bit text with low byte first
                   DTT16H     16-bit text with high byte first
                   DTTKJ      DEC KANJI (not supported on PEX workstations)
---------------------------------------------------------------------------

Description

DATX allows you to specify text formats other than 8-bit formats.  Digital PHIGS supports alternative text only in STROKE precision. 

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new alternative text element. 

The DATX function specifies the two-dimensional (x and y) form of the text primitive.  Its z-coordinate is set to 0.  A call to this function has the following effects during structure traversal:

•Digital PHIGS generates a character string in the text position on a text plane. 

The text plane and the local coordinate system, in which all geometric text attributes are measured on that plane, are defined by a point and two vectors contained in the definition of the primitive.  This point is the text position.  The two vectors are the first direction vector and the second direction vector.  To illustrate the use of the local coordinate system, assume the following:

•P is the text position. 

•U and V are the first and second text direction vectors. 

•T is a vector perpendicular to U and in the text plane. 

The text plane is the plane that contains P and is perpendicular to UxV.  The origin of the local coordinate system is at the point P.  The positive x-axis of the local coordinate system is parallel to U.  If the dot product of TxV is positive, the positive y-axis is parallel to T.  Otherwise, the positive y-axis is opposite T. 

•Digital PHIGS binds the current values of the text attributes, as defined in the PHIGS traversal state list, to the text primitive. 

The text precision attribute affects text clipping. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See Also

PADS
DATX3
PQTXX
PQTXF
PRES
PSCHXP
PSCHH
PSCHSP
PSCHUP
PSDCI
PSHRID
PSIASF
PSPKID
PSTXAL
PSTXC
PSTXCI
PSTXFN
PSTXI
PSTXP
PSTXPR
PSVWI