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

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

Purpose

Use Set View Representation to set fields in the specified entry of the workstation's view table. The view orientation matrix and the view mapping matrix are first expanded to 44 matrixes. Then 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 graPHIGS API sets the Z portion of the requested view clipping limits for the specified view to the default values.

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_rep (ws_id, view_ind, view_rep)

Input Parameters

Pint ws_id
Workstation identifier.

Pint view_ind
View index (>=1).

const Pview_rep *view_rep
View representation.

FORTRAN

PSVWR (wkid, viewi, vwormt, vwmpmt, vwcplm, xyclpi)

Input Parameters

integer wkid
Workstation identifier.

integer viewi
View index (>=1).

real vwormt(3,3)
View orientation matrix.

real vwmpmt(3,3)
View mapping matrix.

real vwcplm(4)
View clipping limits in NPC (XMIN, XMAX, YMIN, YMAX).

integer xyclpi
X-Y 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 3


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