graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPMLX3 - Set Modeling Transformation 3

GPMLX3 ( matrix, type)

Purpose

Use GPMLX3 to insert a three-dimensional, Set Modeling Transformation 3 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 3 structure element depending on the current edit mode.

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.

Parameters

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

Transformation matrix (4[default]4)

For the transformation 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|

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

201329665 ( X'0C000C01')