Matrix

Supported platforms: android, ios, mac, pc
Available since: Gideros 2011.6

Description

The Matrix class specifies transformation from one coordinate space to another.
These transformations include translation, rotation, scaling and skewing.

A 2D transformation matrix is a 3 x 3 matrix in homogenous coordinate system:

![images/matrix_props.png]

You can get and set the values of all six of the properties in a
Matrix object: [[[m11`, `m12`, `m21`, `m22`, `tx`, and `ty]]].

Since Gideros 2016.6, Matrix can also hold 3D (4x4) matrices.

Examples

Applying matrix to Sprite objects

local angle = math.rad(30)
-- create skew matrix
local m = Matrix.new(1, math.tan(angle), math.tan(angle), 1, 0, 0)
--aply to Sprite
local sprite = Sprite.new()
sprite:setMatrix(m)

Methods Matrix.new - creates a new Matrix object [[1]] - get anchor position from matrix transformation [[2]] - returns the elements of this matrix instance [[3]] - returns the value of the m11 component [[4]] - returns the value of the m12 component [[5]] - returns the value of the m21 component [[6]] - returns the value of the m22 component [[7]] - get all 16 elements of 4x4 matrix [[8]] - get position from matrix transformation [[9]] - get rotation for x axis [[10]] - get rotation on y axis [[11]] - get rotation for z axis [[12]] - get scale from matrix transformation [[13]] - get scale on x axis [[14]] - get scale on y axis [[15]] - get scale on z axis [[16]] - returns the value of the tx component [[17]] - returns the value of the ty component [[18]] - returns the value of the tz component [[19]] - get x position [[20]] - get y position [[21]] - get z position [[22]] - [[23]] - Multiply current matrix with new one [[24]] - [[25]] - [[26]] - [[27]] - combine existing rotation with provided [[28]] - combine existing scale with provided scale [[29]] - transform matrix for setting anchor position [[30]] - sets all 6 elements of this matrix instance [[31]] - sets the value of the m11 component [[32]] - sets the value of the m22 component [[33]] - [[34]] - [[35]] - set all 16 elements of 4x4 matrix [[36]] - transform matrix for setting position [[37]] - set rotation on x axis [[38]] - set rotation on y axis [[39]] - set rotation on z axis [[40]] - transform matrix for setting scale [[41]] - set scale on x axis [[42]] - set scale on y axis [[43]] - set scale on z axis [[44]] - sets the value of the tx component [[45]] - sets the value of the ty component [[46]] - sets the value of the tz component [[47]] - set x position [[48]] - set y position [[49]] - set z position [[50]] - [[51]] - combine existing translation with provided translation

Events Constants