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

SET VIEW REPRESENTATION 3 (PHOP,WSOP,*,*)

Purpose

Use Set View Representation 3 to set fields in the specified entry of the workstation's view table. The graPHIGS API stores the specified values in the REQUESTED view table entry. The graPHIGS API sets the corresponding CURRENT values in the view table entry to the REQUESTED values when you update the workstation.

The clipping indicators determine to which boundaries the graPHIGS API clips the contents of the view.

The workstation's view table is 0 based, however, you cannot change view entry 0. (See The graPHIGS Programming Interface: Technical Reference for the default values for view entry 0).

Language Bindings

C

pset_view_rep3 (ws_id, view_ind, view_rep)

Input Parameters

Pint ws_id
Workstation identifier.

Pint view_ind
View index (>=1).

const Pview_rep3 *view_rep
View representation.

FORTRAN

PSVWR3 (wkid, viewi, vwormt, vwmpmt, vwcplm, xyclpi, bclipi, fclipi)

Input Parameters

integer wkid
Workstation identifier.

integer viewi
View index (>=1).

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-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

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
57
Specified Workstation Is Of Category MI
115
View Index Value < ONE
150
Exceeded Maximum Number Of View Table Entries
153
Invalid View Clipping Limits: XMIN>=XMAX, YMIN>=YMAX OR ZMIN>ZMAX
154
View Clipping Limits Are Not Within NPC Range

Related Subroutines

  • Inquire View Representation

  • Set View Representation


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