Name

DAATR − Specifies a reference point for the alternative annotated text and defines an annotated offset. 

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

Syntax

DAATR (RPX, RPY, APX, APY, TXTYPE, CHARS)

Argument   Data Type       Access   Description
---------------------------------------------------------------------------
RPX, RPY   Real            Read     Reference point, in modeling
                                    coordinates
APX, APY   Real            Read     Annotation offset, in normalized
                                    projection 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

DAATR specifies a reference point for the alternative annotated text (text that must appear parallel to the viewing surface) in world coordinates, and then defines an annotated offset in normalized projection coordinates.  The annotation point is the point at which Digital PHIGS places the text, which Digital PHIGS computes by adding the value of the annotation offset argument to the transformed reference point. 

Depending on the text attribute source flag values, Digital PHIGS gathers the attributes -- text color, text precision, character expansion, character spacing, and text font -- from the current attribute text values or from the text bundle index attribute. 

Depending on the 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 annotation text relative element. 

The alternative annotation text relative element assumes that the z-coordinates of both the reference point and the annotation point are 0. 

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

See Also

PADS
DAATR3
PQANF
PQTXX
PRES
PSANS
PSATAL
PSATCH
PSATCU
PSATP
PSCHXP
PSCHSP
PSDCI
PSHRID
PSIASF
PSTXAL
PSTXC
PSTXCI
PSTXFN
PSTXI
PSTXPR
PSVWI