graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPVMT3 - Set View Matrix 3

GPVMT3 (wsid, view, matrix)

Purpose

Use GPVMT3 to load the requested view matrix into the specified view table entry. For the specified workstation, the current value is set to the requested value when the workstation is updated.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

view -- specified by user, fullword integer

Index of view table entry to be loaded (>=1)

matrix -- specified by user, 16 short floating-point numbers

View matrix.

For the input view matrix, the elements must be in the following order:

                 
  |m11 m12 m13 m14|
  |m21 m22 m23 m24|---> (m11,m12,m13,m14,m21,m22,...m44)
  |m31 m32 m33 m34|
  |m41 m42 m43 m44|

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
59: VIEW INDEX VALUE < ZERO
323: VIEW INDEX EXCEEDS VIEW TABLE CAPACITY
518: VIEW ZERO CANNOT BE MODIFIED
522: VIEW MATRIX IS SINGULAR

Related Subroutines

GPXVR: Set Extended View Representation

RCP code

201329921 (X'0C000D01')