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 Template:Creates a new Matrix object [[1]] Template:Get anchor position from matrix transformation [[2]] Template:Returns the elements of this matrix instance [[3]] Template:Returns the value of the m11 component [[4]] Template:Returns the value of the m12 component [[5]] Template:Returns the value of the m21 component [[6]] Template:Returns the value of the m22 component [[7]] Template:Get all 16 elements of 4x4 matrix [[8]] Template:Get position from matrix transformation [[9]] Template:Get rotation for x axis [[10]] Template:Get rotation on y axis [[11]] Template:Get rotation for z axis [[12]] Template:Get scale from matrix transformation [[13]] Template:Get scale on x axis [[14]] Template:Get scale on y axis [[15]] Template:Get scale on z axis [[16]] Template:Returns the value of the tx component [[17]] Template:Returns the value of the ty component [[18]] Template:Returns the value of the tz component [[19]] Template:Get x position [[20]] Template:Get y position [[21]] Template:Get z position [[22]] {{}} [[23]] Template:Multiply current matrix with new one [[24]] {{}} [[25]] {{}} [[26]] {{}} [[27]] Template:Combine existing rotation with provided [[28]] Template:Combine existing scale with provided scale [[29]] Template:Transform matrix for setting anchor position [[30]] Template:Sets all 6 elements of this matrix instance [[31]] Template:Sets the value of the m11 component [[32]] Template:Sets the value of the m22 component [[33]] {{}} [[34]] {{}} [[35]] Template:Set all 16 elements of 4x4 matrix [[36]] Template:Transform matrix for setting position [[37]] Template:Set rotation on x axis [[38]] Template:Set rotation on y axis [[39]] Template:Set rotation on z axis [[40]] Template:Transform matrix for setting scale [[41]] Template:Set scale on x axis [[42]] Template:Set scale on y axis [[43]] Template:Set scale on z axis [[44]] Template:Sets the value of the tx component [[45]] Template:Sets the value of the ty component [[46]] Template:Sets the value of the tz component [[47]] Template:Set x position [[48]] Template:Set y position [[49]] Template:Set z position [[50]] {{}} [[51]] Template:Combine existing translation with provided translation

Events Constants