Packagelaya.maths
Classpublic class Matrix
InheritanceMatrix Inheritance Object

Matrix 类表示一个转换矩阵,它确定如何将点从一个坐标空间映射到另一个坐标空间。

您可以对一个显示对象执行不同的图形转换,方法是设置 Matrix 对象的属性,将该 Matrix 对象应用于 Transform 对象的 matrix 属性,然后应用该 Transform 对象作为显示对象的 transform 属性。这些转换函数包括平移(x 和 y 重新定位)、旋转、缩放和倾斜。



Public Properties
 PropertyDefined By
  a : Number
缩放或旋转图像时影响像素沿 x 轴定位的值。
Matrix
  b : Number
旋转或倾斜图像时影响像素沿 y 轴定位的值。
Matrix
  c : Number
旋转或倾斜图像时影响像素沿 x 轴定位的值。
Matrix
  d : Number
缩放或旋转图像时影响像素沿 y 轴定位的值。
Matrix
  TEMP : Matrix
[static] 用于中转使用的 Matrix 对象。
Matrix
  tx : Number
沿 x 轴平移每个点的距离。
Matrix
  ty : Number
沿 y 轴平移每个点的距离。
Matrix
Public Methods
 MethodDefined By
  
Matrix(a:Number = 1, b:Number = 0, c:Number = 0, d:Number = 1, tx:Number = 0, ty:Number = 0)
使用指定参数创建新的 Matrix 对象。
Matrix
  
返回此 Matrix 对象的副本。
Matrix
  
将指定矩阵与当前矩阵连接,从而将这两个矩阵的几何效果有效地结合在一起。
Matrix
  
将当前 Matrix 对象中的所有矩阵数据复制到指定的 Matrix 对象中。
Matrix
  
[static] 从对象池中创建一个 Matrix 对象。
Matrix
  
destroy():void
销毁此对象。
Matrix
  
getScaleX():Number
获取 X 轴缩放值。
Matrix
  
getScaleY():Number
获取 Y 轴缩放值。
Matrix
  
将本矩阵设置为单位矩阵。
Matrix
  
执行原始矩阵的逆转换。
Matrix
  
对指定的点应用当前矩阵的逆转化并返回此点。
Matrix
  
[static] 将指定的两个矩阵相乘后的结果赋值给指定的输出对象。
Matrix
  
mul16(m1:Matrix, m2:Matrix, out:Array):Array
[static] 将指定的两个矩阵相乘,结果赋值给指定的输出数组,长度为16。
Matrix
  
rotate(angle:Number):void
对 Matrix 对象应用旋转转换。
Matrix
  
scale(x:Number, y:Number):void
对矩阵应用缩放转换。
Matrix
  
setTo(a:Number, b:Number, c:Number, d:Number, tx:Number, ty:Number):Matrix
将 Matrix 的成员设置为指定值。
Matrix
  
setTranslate(x:Number, y:Number):Matrix
设置沿 x 、y 轴平移每个点的距离。
Matrix
  
skew(x:Number, y:Number):Matrix
对 Matrix 对象应用倾斜转换。
Matrix
  
toString():String
返回列出该 Matrix 对象属性的文本值。
Matrix
  
将 Matrix 对象表示的几何转换应用于指定点。
Matrix
  
将 Matrix 对象表示的几何转换应用于指定点,忽略tx、ty。
Matrix
  
translate(x:Number, y:Number):Matrix
沿 x 和 y 轴平移矩阵,平移的变化量由 x 和 y 参数指定。
Matrix
Property Detail
aproperty
public var a:Number

缩放或旋转图像时影响像素沿 x 轴定位的值。

bproperty 
public var b:Number

旋转或倾斜图像时影响像素沿 y 轴定位的值。

cproperty 
public var c:Number

旋转或倾斜图像时影响像素沿 x 轴定位的值。

dproperty 
public var d:Number

缩放或旋转图像时影响像素沿 y 轴定位的值。

TEMPproperty 
public static var TEMP:Matrix

用于中转使用的 Matrix 对象。

txproperty 
public var tx:Number

沿 x 轴平移每个点的距离。

typroperty 
public var ty:Number

沿 y 轴平移每个点的距离。

Constructor Detail
Matrix()Constructor
public function Matrix(a:Number = 1, b:Number = 0, c:Number = 0, d:Number = 1, tx:Number = 0, ty:Number = 0)

使用指定参数创建新的 Matrix 对象。

Parameters
a:Number (default = 1) — (可选)缩放或旋转图像时影响像素沿 x 轴定位的值。
 
b:Number (default = 0) — (可选)旋转或倾斜图像时影响像素沿 y 轴定位的值。
 
c:Number (default = 0) — (可选)旋转或倾斜图像时影响像素沿 x 轴定位的值。
 
d:Number (default = 1) — (可选)缩放或旋转图像时影响像素沿 y 轴定位的值。
 
tx:Number (default = 0) — (可选)沿 x 轴平移每个点的距离。
 
ty:Number (default = 0) — (可选)沿 y 轴平移每个点的距离。
Method Detail
clone()method
public function clone():Matrix

返回此 Matrix 对象的副本。

Returns
Matrix — 与原始实例具有完全相同的属性的新 Matrix 实例。
concat()method 
public function concat(matrix:Matrix):Matrix

将指定矩阵与当前矩阵连接,从而将这两个矩阵的几何效果有效地结合在一起。

Parameters

matrix:Matrix — 要连接到源矩阵的矩阵。

Returns
Matrix — 当前矩阵。
copyTo()method 
public function copyTo(dec:Matrix):Matrix

将当前 Matrix 对象中的所有矩阵数据复制到指定的 Matrix 对象中。

Parameters

dec:Matrix — 要复制当前矩阵数据的 Matrix 对象。

Returns
Matrix — 已复制当前矩阵数据的 Matrix 对象。
create()method 
public static function create():Matrix

从对象池中创建一个 Matrix 对象。

Returns
MatrixMatrix 对象。
destroy()method 
public function destroy():void

销毁此对象。

getScaleX()method 
public function getScaleX():Number

获取 X 轴缩放值。

Returns
Number — X 轴缩放值。
getScaleY()method 
public function getScaleY():Number

获取 Y 轴缩放值。

Returns
Number — Y 轴缩放值。
identity()method 
public function identity():Matrix

将本矩阵设置为单位矩阵。

Returns
Matrix — 返回当前矩形。
invert()method 
public function invert():Matrix

执行原始矩阵的逆转换。

Returns
Matrix — 当前矩阵对象。
invertTransformPoint()method 
public function invertTransformPoint(out:Point):Point

对指定的点应用当前矩阵的逆转化并返回此点。

Parameters

out:Point — 待转化的点 Point 对象。

Returns
Point — 返回out
mul()method 
public static function mul(m1:Matrix, m2:Matrix, out:Matrix):Matrix

将指定的两个矩阵相乘后的结果赋值给指定的输出对象。

Parameters

m1:Matrix — 矩阵一。
 
m2:Matrix — 矩阵二。
 
out:Matrix — 输出对象。

Returns
Matrix — 结果输出对象 out。
mul16()method 
public static function mul16(m1:Matrix, m2:Matrix, out:Array):Array

将指定的两个矩阵相乘,结果赋值给指定的输出数组,长度为16。

Parameters

m1:Matrix — 矩阵一。
 
m2:Matrix — 矩阵二。
 
out:Array — 输出对象Array。

Returns
Array — 结果输出对象 out。
rotate()method 
public function rotate(angle:Number):void

对 Matrix 对象应用旋转转换。

Parameters

angle:Number — 以弧度为单位的旋转角度。

scale()method 
public function scale(x:Number, y:Number):void

对矩阵应用缩放转换。

Parameters

x:Number — 用于沿 x 轴缩放对象的乘数。
 
y:Number — 用于沿 y 轴缩放对象的乘数。

setTo()method 
public function setTo(a:Number, b:Number, c:Number, d:Number, tx:Number, ty:Number):Matrix

将 Matrix 的成员设置为指定值。

Parameters

a:Number — 缩放或旋转图像时影响像素沿 x 轴定位的值。
 
b:Number — 旋转或倾斜图像时影响像素沿 y 轴定位的值。
 
c:Number — 旋转或倾斜图像时影响像素沿 x 轴定位的值。
 
d:Number — 缩放或旋转图像时影响像素沿 y 轴定位的值。
 
tx:Number — 沿 x 轴平移每个点的距离。
 
ty:Number — 沿 y 轴平移每个点的距离。

Returns
Matrix — 当前矩阵对象。
setTranslate()method 
public function setTranslate(x:Number, y:Number):Matrix

设置沿 x 、y 轴平移每个点的距离。

Parameters

x:Number — 沿 x 轴平移每个点的距离。
 
y:Number — 沿 y 轴平移每个点的距离。

Returns
Matrix — 返回对象本身
skew()method 
public function skew(x:Number, y:Number):Matrix

对 Matrix 对象应用倾斜转换。

Parameters

x:Number — 沿着 X 轴的 2D 倾斜弧度。
 
y:Number — 沿着 Y 轴的 2D 倾斜弧度。

Returns
Matrix — 当前 Matrix 对象。
toString()method 
public function toString():String

返回列出该 Matrix 对象属性的文本值。

Returns
String — 一个字符串,它包含 Matrix 对象的属性值:a、b、c、d、tx 和 ty。
transformPoint()method 
public function transformPoint(out:Point):Point

将 Matrix 对象表示的几何转换应用于指定点。

Parameters

out:Point — 用来设定输出结果的点。

Returns
Point — 返回out
transformPointN()method 
public function transformPointN(out:Point):Point

将 Matrix 对象表示的几何转换应用于指定点,忽略tx、ty。

Parameters

out:Point — 用来设定输出结果的点。

Returns
Point — 返回out
translate()method 
public function translate(x:Number, y:Number):Matrix

沿 x 和 y 轴平移矩阵,平移的变化量由 x 和 y 参数指定。

Parameters

x:Number — 沿 x 轴向右移动的量(以像素为单位)。
 
y:Number — 沿 y 轴向下移动的量(以像素为单位)。

Returns
Matrix — 返回此矩形对象。