| << SL_GetTM2D | SL_ConcateTM2D >> |
| Top: Documentation Library | Up: SoftLogik App Library API |
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-2024 GrasshopperLLC. All Rights Reserved.
| User Contributed Comments For SL_SetTM2D | sign in to add a comment |
| There are no user contributed comments for this page. | |
| << SL_GetTM2D | SL_ConcateTM2D >> |
| Top: Documentation Library | Up: SoftLogik App Library API |