Table of Contents
TGIS_Shape.Transform(TGIS_Point3D, double, double, double, double, double, double, double, double, double, double, double, double, bool) method
DK for Java | tatukgis.jdk.TGIS_Shape.Transform | Overloads | Constructors | Fields | Methods | Properties
Transforms shape geometry using a 3x3 matrix and translation vector, either in place or as a new shape.
Syntax
// Java public TGIS_Shape Transform( TGIS_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, bool _returnnewobj );
// Oxygene public function Transform( _origin : TGIS_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 : Boolean ) : TGIS_Shape;
Parameters
| Name | Type | Description |
|---|---|---|
| _origin | TGIS_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 | bool Boolean | If True, returns a new transformed shape; if False, modifies the current shape and returns it. |
Result
| Type | Description |
|---|---|
| TGIS_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