MAL.CreateTM

ref_TM_out = MAL.CreateTM( BYREF TM_out         AS ARRAY,

                           BYREF point1         AS ARRAY,

                           BYREF point2         AS ARRAY,

                           BYREF point3         AS ARRAY,

                          [BYVAL nAxis1         AS INTEGER=ML_AXIS_X],

                          [BYVAL nAxis2         AS INTEGER=ML_AXIS_Y],

                          [BYVAL nPoint         AS INTEGER=1],

                          [BYVAL nFrameOffset   AS INTEGER=0] ) AS REFERENCE

ref_TM_out = MAL.CreateTM( BYREF TM_out         AS ARRAY,

                           BYREF arr_in         AS ARRAY,

                           BYVAL point1         AS INTEGER,

                           BYVAL point2         AS INTEGER,

                           BYVAL point3         AS INTEGER,

                          [BYVAL nAxis1         AS INTEGER=ML_AXIS_X],

                          [BYVAL nAxis2         AS INTEGER=ML_AXIS_Y],

                          [BYVAL nFrameOffset   AS INTEGER=0] ) AS REFERENCE

Creates a 3x3 transformation matrix using 3 points as reference.  The input arrays must be 3D.  The output is a 3x3 Transformation Matrix that should be dimensioned as

DIM tm( 3, 3 ) AS REAL

Example:

'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

'

DIM TM_Out( nFrames, 3, 3 ) AS REAL

' Use 3 3D Points as Input

MAL.CreateTM( TM_Out,_

             V3D( Position, 1 ),_

             V3D( Position, 2 ),_

             V3D( Position, 3 ) )

CALL PrintArray( REF( TM_Out ) )

' Here we use one array with the 3 points

MAL.CreateTM( TM_Out, Position, 1, 2, 3 )

CALL PrintArray( REF( TM_Out ) )