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

INQUIRE TEXT FACILITIES (PHOP,*,*,*)

Purpose

Use Inquire Text Facilities to inquire the text facilities for the specified workstation type.

Only the highest supported precision for each font is present in the list of text font and precision pairs. Possible text precisions include: STRING, CHARACTER, or STROKE.

If the graPHIGS API returns a value of zero for the number of available character heights, then the workstation supports a continuous range of character heights. If the graPHIGS API returns a value of zero for the number of available character expansion factors, then the workstation supports a continuous range of character expansion factors.

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

Language Bindings

C

pinq_text_facs (ws_type, num_elems_appl_list, start_ind, err_ind, fac, num_elems_impl_list)

Input Parameters

Pint ws_type
Workstation type.

Pint num_elems_appl_list
Number of elements in the application list (>=0).

Pint start_ind
Starting index (>=0).

Output Parameters

Pint *err_ind
Error indicator.

Ptext_facs *fac
Text facilities.

Pint *num_elems_impl_list
Number of elements in the implementation list.

FORTRAN

PQTXF (wtype, n, errind, nfpp, font, prec, nchh, minchh, maxchh, nchx, minchx, maxchx, nptxi)

Input Parameters

integer wtype
Workstation type.

integer n
List element requested (>=0).

Output Parameters

integer errind
Error indicator.

integer nfpp
Number of text font and precision pairs.

integer font
nth element in the list of text fonts.

integer prec
nth element in the list of text precisions (0=PSTRP, 1=PCHARP, 2=PSTRKP).

integer nchh
Number of available character heights.

real minchh
Minimum character height in DC.

real maxchh
Maximum character height in DC.

integer nchx
Number of available character expansion factors.

real minchx
Minimum character expansion factor.

real maxchx
Maximum character expansion factor.

integer nptxi
Number of predefined text indexes.

Errors

None

Related Subroutines

  • Inquire Workstation Connection And Type

  • Set Text Representation

  • Text

  • Text 3

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