Available also on: Delphi | .NET | Java | ActiveX.
Transforms shape geometry using a 3x3 matrix and translation vector, either in place or as a new shape.
# Python def Transform( self, _origin: TGIS_Point3D, _m11: float, _m12: float, _m13: float, _m21: float, _m22: float, _m23: float, _m31: float, _m32: float, _m33: float, _dx: float, _dy: float, _dz: float, _returnnewobj: bool ) -> TGIS_Shape:
| Name | Type | Description |
|---|---|---|
| _origin | TGIS_Point3D | Origin point used as the transformation pivot. |
| _m11 | float | Matrix element [1,1]. |
| _m12 | float | Matrix element [1,2]. |
| _m13 | float | Matrix element [1,3]. |
| _m21 | float | Matrix element [2,1]. |
| _m22 | float | Matrix element [2,2]. |
| _m23 | float | Matrix element [2,3]. |
| _m31 | float | Matrix element [3,1]. |
| _m32 | float | Matrix element [3,2]. |
| _m33 | float | Matrix element [3,3]. |
| _dx | float | Translation offset applied in the X direction. |
| _dy | float | Translation offset applied in the Y direction. |
| _dz | float | Translation offset applied in the Z direction. |
| _returnnewobj | bool | If True, returns a new transformed shape; if False, modifies the current shape and returns it. |
| Type | Description |
|---|---|
| TGIS_Shape | The transformed shape instance according to _returnnewobj. |
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.