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

INQUIRE ANNOTATION FACILITIES (PHOP,*,*,*)

Purpose

Use Inquire Annotation Facilities to inquire the list of annotation styles and the number and range of annotation text character heights supported by a workstation. If the number of annotation text character heights is zero, then the graPHIGS API supports a continuous range from the minimum height to the maximum height. Possible annotation styles include: UNCONNECTED and LEAD LINE.

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_anno_facs (ws_type, num_elems_appl_list, start_ind, err_ind, styles, num_elems_impl_list, num_anno_char_hts, min_anno_char_ht, max_anno_char_ht);

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.

Pint_list *styles
List of annotation styles (1=PANNO_STYLE_UNCONNECTED, 2=PANNO_STYLE_LEAD_LINE).

Pint *num_elems_impl_list
Number of elements in the implementation list.

Pint *num_anno_char_hts
Number of available annotation text character heights.

Pfloat *min_anno_char_ht
Minimum annotation text character height in DC.

Pfloat *max_anno_char_ht
Maximum annotation text character height in DC.

FORTRAN

PQANF (wtype, n, errind, nas, as, nchh, minchh, maxchh)

Input Parameters

integer wtype
Workstation type.

integer n
List element of the annotation styles requested (>=0).

Output Parameters

integer errind
Error indicator.

integer nas
Number of available annotation styles.

integer as
nth element of the list of available annotation styles (1=PUNCON, 2=PLDLN).

integer nchh
Number of available annotation text character heights.

real minchh
Minimum annotation text character height in DC.

real maxchh
Maximum annotation text character height in DC.

Errors

None

Related Subroutines

  • None

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