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

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

Purpose

Use Inquire View Representation to inquire the current and/or requested values from the specified view table entry of the specified workstation.

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
57
Specified Workstation Is Of Category MI
114
View Index Value < ZERO
101
Specified Representation Has Not Been Defined

Language Bindings

C

pinq_view_rep (ws_id, view_ind, err_ind, upd_st, cur_view, req_view)

Input Parameters

Pint ws_id
Workstation identifier.

Pint view_ind
View index requested (>=0).

Output Parameters

Pint *err_ind
Error indicator.

Pupd_st *upd_st
Viewing transformation update state (0=PUPD_NOT_PEND, 1=PUPD_PEND).

Pview_rep3 *cur_view
Current view representation.

Pview_rep3 *req_view
Requested view representation

FORTRAN

PQVWR (wkid, viewi, curq, errind, vwupd, vwormt, vwmpmt, vwcplm, xyclpi, bclipi, fclipi)

Input Parameters

integer wkid
Workstation identifier.

integer viewi
View index requested (>=0).

integer curq
Specifies whether current or requested values are to be returned (0=PCURVL, 1=PRQSVL).

Output Parameters

integer errind
Error indicator.

integer vwupd
Viewing transformation update state (0=PNPEND, 1=PPEND).

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

  • Set View Representation

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