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

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

Purpose

Use Inquire Polyline Representation to inquire the current polyline representation in the specified entry in the polyline bundle table of the specified workstation. Returned values of type SET or REALIZED may be specified.

If the specified polyline index is not present in the polyline bundle table on the workstation and the specified type of returned values is REALIZED, then the graPHIGS API returns the representation for polyline index 1.

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_line_rep (ws_id, index, type, errind, line_rep)

Input Parameters

Pint ws_id
Workstation identifier.

Pint index
Polyline index (>=1).

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

Output Parameters

Pint *errind
Error indicator.

Pline_bundle *line_rep
Polyline representation.

FORTRAN

PQPLR (wkid, pli, type, errind, ltype, lwidth, coli)

Input Parameters

integer wkid
Workstation identifier.

integer pli
Polyline index (>=1).

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

Output Parameters

integer errind
Error indicator.

integer ltype
Line type.

real lwidth
Line width scale factor.

integer coli
Polyline color index.

Errors

None

Related Subroutines

  • Set Polyline Representation


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