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
|
