Table of Contents
ITGIS_Shape.Transform_2 method
DK for ActiveX | TatukGIS_XDK11.ITGIS_Shape.Transform_2 | Methods | Properties
Transforms shape geometry using a 3x3 matrix and translation vector, either in place or as a new shape.
Syntax
// C# public ITGIS_Shape Transform_2( ITGIS_Point3D _origin, double _m11, double _m12, double _m13, double _m21, double _m22, double _m23, double _m31, double _m32, double _m33, double _dx, double _dy, double _dz, WordBool _returnnewobj );
' VisualBasic Public Function Transform_2( ByVal _origin As ITGIS_Point3D, ByVal _m11 As Double, ByVal _m12 As Double, ByVal _m13 As Double, ByVal _m21 As Double, ByVal _m22 As Double, ByVal _m23 As Double, ByVal _m31 As Double, ByVal _m32 As Double, ByVal _m33 As Double, ByVal _dx As Double, ByVal _dy As Double, ByVal _dz As Double, ByVal _returnnewobj As WordBool ) As ITGIS_Shape
// Oxygene public function Transform_2( _origin : ITGIS_Point3D; _m11 : Double; _m12 : Double; _m13 : Double; _m21 : Double; _m22 : Double; _m23 : Double; _m31 : Double; _m32 : Double; _m33 : Double; _dx : Double; _dy : Double; _dz : Double; _returnnewobj : WordBool ) : ITGIS_Shape;
Parameters
| Name | Type | Description |
|---|---|---|
| _origin | ITGIS_Point3D | Origin point used as the transformation pivot. |
| _m11 | double Double | Matrix element [1,1]. |
| _m12 | double Double | Matrix element [1,2]. |
| _m13 | double Double | Matrix element [1,3]. |
| _m21 | double Double | Matrix element [2,1]. |
| _m22 | double Double | Matrix element [2,2]. |
| _m23 | double Double | Matrix element [2,3]. |
| _m31 | double Double | Matrix element [3,1]. |
| _m32 | double Double | Matrix element [3,2]. |
| _m33 | double Double | Matrix element [3,3]. |
| _dx | double Double | Translation offset applied in the X direction. |
| _dy | double Double | Translation offset applied in the Y direction. |
| _dz | double Double | Translation offset applied in the Z direction. |
| _returnnewobj | WordBool | If True, returns a new transformed shape; if False, modifies the current shape and returns it. |
Result
| Type | Description |
|---|---|
| ITGIS_Shape | The transformed shape instance according to _returnnewobj. |
Remarks
PURPOSE: Applies affine or general linear transformation to shape geometry with control over whether the operation creates a new object or updates the existing shape.
BEHAVIOR: Transforms coordinates relative to _origin using the supplied matrix and translation values. When _returnnewobj is True, the original shape is unchanged; otherwise the current shape is modified in place.
CONSTRAINTS: Callers must account for object ownership when _returnnewobj is True. In-place transformation permanently changes the current geometry.
Example
Rotate shape by 30 degrees