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

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

Purpose

Use Inquire Predefined View Representation to inquire the predefined view attributes corresponding to the specified view table entry for the specified workstation type.

The graPHIGS API returns the view orientation matrix, the view mapping matrix, the view clipping limits, the x to y clipping indicator, and the back and front clipping indicators for the specified entry.

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
57
Specified Workstation Is Of Category MI
114
View Index Value < ZERO
101
Specified Representation Has Not Been Defined
62
This Information Not Available For MO Workstation Type

Language Bindings

C

pinq_pred_view_rep (ws_type, index, err_ind, view)

Input Parameters

Pint ws_type
Workstation type.

Pint index
Predefined view index (>=0).

Output Parameters

Pint *err_ind
Error indicator.

Pview_rep3 *view
View representation.

FORTRAN

PQPVWR (wtype, pvwi, errind, vwormt, vwmpmt, vwcplm, xyclpi, bclipi, fclipi)

Input Parameters

integer wtype
Workstation type

integer pvwi
Predefined view index (>=0).

Input Parameters

integer errind
Error indicator.

real vwormt(4,4)
View orientation matrix.

real vwmpmt(4,4)
View mapping matrix.

real vwcplm(6)
View clipping limits in NPC (XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX).

integer xyclpi
x to y clipping indicator (0=PNCLIP, 1=PCLIP).

integer bclipi
Back clipping indicator (0=PNCLIP, 1=PCLIP).

integer fclipi
Front clipping indicator (0=PNCLIP, 1=PCLIP).

Errors

None

Related Subroutines

  • Inquire Workstation Connection And Type

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