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

*The graPHIGS Programming Interface : Subroutine Reference*

## GPMLX2 - Set Modeling Transformation 2

**Purpose**

Use
**GPMLX2** to insert a two-dimensional,
Set Modeling 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 Modeling Transformation 2
structure element
depending on the current edit mode.

When encountered during traversal,
the 33 modeling matrix is
expanded 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|

Depending on the composition type,
when this element is encountered during traversal,
the specified matrix either replaces, is
pre-concatenated with, or is post-concatenated
with the current local modeling transformation matrix.
The resultant matrix,
in conjunction with the global 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)
For the transformation matrix,
the elements must be in the following order:

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

*type* -- specified by user, fullword integer
Composition type
(
`1=PRECONCATENATE, 2=POSTCONCATENATE,
3=REPLACE`
)
**Error Codes**

**5**
- FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
**319**
- COMPOSITION TYPE VALUE IS INVALID

**Related Subroutines**

None

**RCP code**

201329666 (
X'0C000C02')

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