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

*The graPHIGS Programming Interface : Subroutine Reference*

## GPGLX2 - Set Global Transformation 2

**Purpose**

Use
**GPGLX2** to insert a two-dimensional,
Set Global Transformation 2 structure element
into the open structure following the element pointer
or replace the element pointed at by the element pointer
with a Set Global Transformation 2 structure element
depending on the current edit mode.

When encountered during traversal, this element
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|

and causes the expanded matrix to
become the current global transformation for the current structure.
The resultant matrix,
in conjunction with the local modeling
transformation, transforms all subsequent primitives from the Modeling
Coordinate (MC)
system to the World Coordinate (WC) system.
**Note: **

When inquired, the matrix returned by
the Inquire Element Content
(
**GPQE**) subroutine
is the expanded
44 matrix;
the matrix returned by
the Inquire List of Element Data
(
**GPQED**) subroutine
is the 33 matrix.

**Parameters**

*matrix* -- specified by user,
9 short floating-point numbers
Transformation matrix (33)
The elements must be in the following order
for the input transformation matrix:

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

**Error Codes**

**5**
- FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)

**Related Subroutines**

None

**RCP code**

201329668 (
X'0C000C04')

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