PATR(3g) — Subroutines
Name
PATR − Specifies a reference point for the annotated text in world and defines an annotated offset.
Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element
Syntax
PATR (RPX, RPY, APX, APY, 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
CHARS Character ∗(∗) Read Text string
---------------------------------------------------------------------------
Description
PATR specifies a reference point for the 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 annotation text relative element.
The 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
PATR3
PQANF
PQTXX
PRES
PSANS
PSATAL
PSATCH
PSATCU
PSATP
PSCHXP
PSCHSP
PSDCI
PSHRID
PSIASF
PSTXAL
PSTXC
PSTXCI
PSTXFN
PSTXI
PSTXPR
PSVWI