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

GPVMT2 - Set View Matrix 2

GPVMT2 (wsid, view, matrix)

Purpose

Use GPVMT2 to load the requested view matrix into the specified view table entry.

The 33 matrix is expanded by the graPHIGS API into a 44 matrix as follows:

                      
  |a b c|        |a b 0 c|
  |d e f| ---->  |d e 0 f|
  |g h i|        |0 0 1 0|
                 |g h 0 i|
                        

The current value is set to the requested value when the workstation is updated.

When inquired, the matrix returned is the expanded 44 matrix.

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, 9 short floating-point numbers

View matrix.

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

             
  |m11 m12 m13|
  |m21 m22 m23|---> (m11,m12,m13,m21.....m33)
  |m31 m32 m33|
             

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

201329922 (X'0C000D02')


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