SL_SetTM2D


NAME
SL_SetTM2D -- allows the initing of all values in a 2-d tm.

SYNOPSIS
SL_SetTM2D(tm, value_array, unit_array);
A0 A1 A2

void SL_SetTM2D(TM2DHANDLE, LONG *, ULONG *);

FUNCTION
This allows the user to set all six values that comprise a 2-d
transformation matrix. Each array must have at least six entries.
This is the order of the array as it corresponds to the matrix:

value_array[0] = matrix[0][0].
value_array[1] = matrix[0][1].
value_array[2] = matrix[1][0].
value_array[3] = matrix[1][1].
value_array[4] = matrix[2][0].
value_array[5] = matrix[2][1].

This is how the matrix entries are used:

[ xscale 0 ]
[ 0 yscale]
[ 0 0 ]

[ cos twist sin twist ]
[ -sin slant cos slant ]
[ 0 0 ]

[ 1 0 ]
[ 0 1 ]
[ xoffset yoffset]

The matrix is set using the result of value_array[x]/unit_array[x].
An unspecified internal presision is maintain so the units may be
larger than the values. No entry in the unit_array should be 0.

If the value_array is NULL then the values are assumed to be 1 for
each entry in the unit_array.

If the unit_array is NULL then the units are assumed to be 1 for
each entry in the value_array.

If both are NULL then the tm is simply inited via SL_InitTM2D.

INPUTS
tm - the 2-d transformation matrix to init.
value_array - an array of 6 LONG's the describe the 6 values
of the transformation matrix.
unit_array - an array of 6 LONG's the describe the units
for the value_array. This may be NULL.

SEE ALSO
SL_ApplyTM2D, SL_CloneTM2D, SL_ConcateTM2D, SL_CopyTM2D, SL_CreateTM2D, SL_DeltaApplyTM2D, SL_FreeTM2D, SL_GetTM2D, SL_InitTM2D, SL_InverseApplyTM2D, SL_InverseDeltaApplyTM2D, SL_InvertTM2D, SL_RotateTM2D, SL_ScaleTM2D, SL_SetTM2D, SL_TranslateTM2D.

 

SL_SetTM2D  Command Section By Type  url:SL_SetTM2D
  created:2008-03-01 23:36:36   last updated:2008-03-01 23:36:36
  Copyright © 1985-2017 GrasshopperLLC. All Rights Reserved.

User Contributed Comments For SL_SetTM2D
There are no user contributed comments for this page.