[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

INQUIRE TEXT REPRESENTATION (PHOP,WSOP,*,*)

Purpose

Use Inquire Text Representation to inquire the current text attributes contained in the specified entry in the text bundle table of the specified workstation. Returned values of type SET or REALIZED may be specified.

The graPHIGS API returns data indicating the text font and precision, character expansion factor and spacing, and text color of the specified entry. Possible text precisions include: STRING, CHARACTER, and STROKE.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the information is unavailable, then the values returned in the output parameters are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
59
Specified Workstation Does Not Have Output Capability
100
Bundle Index Value Is Less Than One
101
Specified Representation Has Not Been Defined

Language Bindings

C

pinq_text_rep (ws_id, index, type, err_ind, text_rep)

Input Parameters

Pint ws_id
Workstation identifier.

Pint index
Text index (>=1).

Pinq_type type
Type of returned values (0=PINQ_SET, 1=PINQ_REALIZED).

Output Parameters

Pint *err_ind
Error indicator.

Ptext_bundle *text_rep
Text representation.

FORTRAN

PQTXR (wkid, txi, type, errind, font, prec, chxp, chsp, coli)

Input Parameters

integer wkid
Workstation identifier.

integer txi
Text index (>=1).

integer type
Type of returned values (0=PSET, 1=PREALI).

Output Parameters

integer errind
Error indicator.

integer font
Text font.

integer prec
Text precision (0=PSTRP, 1=PCHARP, 2=PSTRKP).

real chxp
Character expansion factor.

real chsp
Character spacing.

integer coli
Text color index.

Errors

None

Related Subroutines

  • Set Text Representation


  • [ Previous | Next | Contents | Glossary | Home | Search ]