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

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

Purpose

Use Inquire Predefined Text Representation to inquire the predefined text attributes corresponding to the specified entry in the text bundle table for the specified workstation type.

The graPHIGS API returns text font, text precision, character expansion factor, character spacing, and text color for 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:

2
Function Requires State (PHOP,*,*,*)
52
Workstation Type Not Recognized By Implementation
51
Information Not Available For Generic Workstation Type
59
Specified Workstation Does Not Have Output Capability
62
This Information Not Available For MO Workstation Type
100
Bundle Index Value Is Less Than One
102
Representation Has Not Been Predefined On This Workstation

Language Bindings

C

pinq_pred_text_rep (ws_type, index, err_ind, bundle)

Input Parameters

Pint ws_type
Workstation type.

Pint index
Predefined text index (>=1).

Output Parameters

Pint *err_ind
Error indicator.

Ptext_bundle *bundle
Predefined text representation.

FORTRAN

PQPTXR (wtype, ptxi, errind, font, prec, chxp, chsp, coli)

Input Parameters

integer wtype
Workstation type.

integer ptxi
Predefined text index (>=1).

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

  • Inquire Workstation Connection And Type

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