Transform Structure
Represents a 2D affine transformation matrix.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CECore assembly)
Syntax
public sealed class Transform : EngineValueTypeRemarks
A Transform represents a 2D affine transformation matrix, which can be used to transform 2D coordinates from one coordinate system to another. The transformation consists of a sequence of translations, rotations and scaling operations. Transforms are used by custom visualizers and symbols, via the Drawable.Transform property of the drawable.
When a custom visualizer is called to draw a feature on a drawable, the transform of the drawable is set up to map directly from the Crs coordinates of the feature to screen pixels. The visualizer typically does one of two things:
Does some calculations with the geometry of the feature using Crs coordinates, and then draws the geometry using Crs coordinates, leaving the transform of the drawable unchanged.
Transforms the geometry to screen coordinates or some other coordinate system, does some calculations, and resets and/or modifies the transform of the drawable before drawing the geometry.
Inheritance Hierarchy
System.Object (not available in C#)
EngineValueType
Transform
Platforms
Windows, Linux, Android
Transform Members
The Transform type has the following members.
Constructors
| Name | Description |
|---|---|
| Transform | Initializes a new instance of the Transform class. |
Properties
| Name | Description |
|---|---|
| M00 | Gets the affine 2D matrix value at row 0, column 0. |
| M01 | Gets the affine 2D matrix value at row 0, column 1. |
| M02 | Gets the affine 2D matrix value at row 0, column 2. |
| M10 | Gets the affine 2D matrix value at row 1, column 0. |
| M11 | Gets the affine 2D matrix value at row 1, column 1. |
| M12 | Gets the affine 2D matrix value at row 1, column 2. |
| Rotation | Gets the total rotation of the transform. |
| ScaleX | Gets the scale factor in X of the transform. |
| ScaleXY | Gets the average scale factor in X and Y of the transform. |
| ScaleY | Gets the scale factor in Y of the transform. |
Methods
| Name | Description |
|---|---|
| Equals | Overloaded. Determines whether two Transform objects have the same value. |
| GetHashCode | Returns the hash code for this Transform. |
| Inverse | Creates a new transform, which is the inverse of this. |
 Operator == | Determines whether two specified Transform objects have the same value. |
| Operator != | Determines whether two specified Transform objects have different values. |
| Reset | Resets this transform to the identity matrix. |
| Rotate | Appends a rotation to the transform. |
| Scale | Appends scale factors in X and Y to the transform. |
| ToString | Converts this Transform to a human readable string. |
| Translate | Appends a translation to the transform. |