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

INQUIRE GENERALIZED DRAWING PRIMITIVE (PHOP,*,*,*)

Purpose

Use Inquire Generalized Drawing Primitive to inquire the list of sets of attributes used by the specified Generalized Drawing Primitive (GDP) on the specified workstation. Possible sets of attributes include: POLYLINE, POLYMARKER, TEXT, INTERIOR and/or EDGE attributes.

The graPHIGS API returns a list of the attributes used by the specified GDP. For registered GDP identifiers, the ISO International Register of Graphical Items defines the list of sets of attributes used. For implementation dependent GDP identifiers, the list of sets of attributes used is workstation dependent.

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
64
Specified Workstation Type Cannot Generate Specified GDP
62
This Information Not Available For MO Workstation Type

Language Bindings

C

pinq_gdp (ws_type, gdp, err_ind, num_attr, attr)

Input Parameters

Pint ws_type
Workstation type.

Pint gdp
GDP function identifier.

Output Parameters

Pint *err_ind
Error indicator.

Pint *num_attr
Number of sets of attributes used.

Pattrs attr[5]
List of sets of attributes used (0=PATTR_LINE, 1=PATTR_MARKER, 2=PATTR_TEXT, 3=PATTR_INT, 4=PATTR_EDGE).

FORTRAN

PQGDP (wtype, gdp, errind, nbnd, bndl)

Input Parameters

integer wtype
Workstation type.

integer gdp
GDP function identifier.

Output Parameters

integer errind
Error indicator.

integer nbnd
Number of sets of attributes used.

integer bndl(5)
List of sets of attributes used (0=PPLATT, 1=PPMATT, 2=PTXATT, 3=PINATT, 4=PEDATT).

Errors

None

Related Subroutines

  • Generalized Drawing Primitive


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