Transform

Object Hierarchy:

Description:

[ SimpleType ]
[ CCode ( cname = "sfTransform" , cprefix = "sfTransform_" ) ]
public struct Transform

Define a 3x3 transform matrix.

A sf.Transform specifies how to translate, rotate, scale, shear, project, whatever things.

In mathematical terms, it defines how to transform a coordinate system into another.

For example, if you apply a rotation transform to a sprite, the result will be a rotated sprite. And anything that is transformed by this rotation transform will be rotated the same way, according to its initial position.

Transforms are typically used for drawing. But they can also be used for any computation that requires to transform points between the local and global coordinate systems of an entity (like collision detection).

Example:

// define a translation transform
sf.Transform translation = {};
translation.translate(20, 50);

// define a rotation transform
sf.Transform rotation = {};
rotation.rotate(45);

// combine them
var transform = translation.combine(rotation);

// use the result to transform stuff...
var point = transform.transformPoint(10, 20);
var rect = transform.transformRect(sf.FloatRect(0, 0, 10, 100));

Content:

Static methods:

public static Transform fromMatrix (float a00, float a01, float a02, float a10, float a11, float a12, float a20, float a21, float a22)

Methods:

public void combine (Transform other)
public bool equal (Transform left, Transform right)
public Transform getInverse (Transform transform)
public void getMatrix (float matrix)
public void rotate (float angle)
public void rotateWithCenter (float angle, float centerX, float centerY)
public void scale (float scaleX, float scaleY)
public void scaleWithCenter (float scaleX, float scaleY, float centerX, float centerY)
public Vector2f transformPoint (Vector2f point)
public FloatRect transformRect (FloatRect rectangle)
public void translate (float x, float y)

Fields:

public float[] matrix
public Transform* Identity