Name

PQTXX − Returns text extent of a character string. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function
 

Syntax

PQTXX (WTYPE, FONT, CHXP, CHSP, CHH, TXP, TXALH, TXALV, STR, ERRIND,
TXEXRX, TXEXRY, COPX, COPY)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WTYPE             Integer        Read      Workstation type
FONT              Integer        Write     Text font
CHXP              Real           Write     Character expansion factor
CHSP              Real           Write     Character spacing
CHH               Real           Read      Character height
TXP               Integer        Read      Text path
TXALH             Integer        Read      Horizontal text alignment
TXALV             Integer        Read      Vertical text alignment
STR               Character ∗80  Read      Character string
ERRIND            Integer        Write     Error indicator
TXEXRX(2),        Array of       Write     Text extent rectangle, in the
TXEXRY(2)         reals                    order XMIN, XMAX, YMIN, YMAX
COPX, COPY        Real           Write     Concatenation offset
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
TXP                  PRIGHT       Text path right
                     PLEFT        Text path left
                     PUP          Text path up
                     PDOWN        Text path down
TXALH                PAHNOR       Normal horizontal alignment
                     PALEFT       Left horizontal alignment
                     PACENT       Center horizontal alignment
                     PARITE       Right horizontal alignment
TXALV                PAVNOR       Normal vertical alignment
                     PATOP        Top vertical alignment
                     PACAP        Cap vertical alignment
                     PAHALF       Half vertical alignment
                     PABASE       Base vertical alignment
                     PABOTT       Bottom vertical alignment
---------------------------------------------------------------------------

Description

PQTXX returns information about the text extent of a character string, including the text extent rectangle and the concatenation point. 

Digital PHIGS computes the text extent of the specified character string using the specified attributes: text font, character expansion factor, character spacing, character height, text path, and text alignment.  Digital PHIGS assumes STROKE precision. 

The concatenation offset indicates the text position for the concatenation of a subsequent text string. 

See Also

PATR
PSCHH
PSCHSP
PSCHUP
PSTXAL
PSTXFN
PSTXP
PSTXPR
PTX