Options
All
  • Public
  • Public/Protected
  • All
Menu

表示右手3 * 3的浮点矩阵,可以存储平移、缩放和旋转信息。

Hierarchy

  • Matrix
    • Matrix2D

Implements

  • IHashObject

Index

Constructors

constructor

  • new Matrix2D(a?: number, b?: number, c?: number, d?: number, tx?: number, ty?: number): Matrix2D
  • 使用指定参数创建一个 Matrix 对象

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • Optional a: number

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

    • Optional b: number

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

    • Optional c: number

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

    • Optional d: number

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

    • Optional tx: number

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

    • Optional ty: number

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

    Returns Matrix2D

Properties

Private $hashCode

$hashCode: number

a

a: number

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

default

1

version

Egret 2.4

platform

Web,Native

language

zh_CN

b

b: number

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

default

0

version

Egret 2.4

platform

Web,Native

language

zh_CN

c

c: number

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

default

0

version

Egret 2.4

platform

Web,Native

language

zh_CN

d

d: number

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

default

1

version

Egret 2.4

platform

Web,Native

language

zh_CN

Readonly hashCode

hashCode: number

返回此对象唯一的哈希值,用于唯一确定一个对象。hashCode为大于等于1的整数。

version

Egret 2.4

platform

Web,Native

language

zh_CN

tx

tx: number

沿 x 轴平移每个点的距离

default

0

version

Egret 2.4

platform

Web,Native

language

zh_CN

ty

ty: number

沿 y 轴平移每个点的距离

default

0

version

Egret 2.4

platform

Web,Native

language

zh_CN

Accessors

m11

  • get m11(): number
  • set m11(value: number): void

m12

  • get m12(): number
  • set m12(value: number): void

m21

  • get m21(): number
  • set m21(value: number): void

m22

  • get m22(): number
  • set m22(value: number): void

m31

  • get m31(): number
  • set m31(value: number): void

m32

  • get m32(): number
  • set m32(value: number): void

Methods

Private $getScaleX

  • $getScaleX(): number

Private $getScaleY

  • $getScaleY(): number

Private $getSkewX

  • $getSkewX(): number

Private $getSkewY

  • $getSkewY(): number

Private $invertInto

  • $invertInto(target: Matrix): void

Private $preMultiplyInto

  • $preMultiplyInto(other: Matrix, target: Matrix): void

Private $transformBounds

  • $transformBounds(bounds: Rectangle): void

Private $updateScaleAndRotation

  • $updateScaleAndRotation(scaleX: number, scaleY: number, skewX: number, skewY: number): void

add

append

  • append(a: number, b: number, c: number, d: number, tx: number, ty: number): Matrix
  • 后置矩阵

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • a: number

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

    • b: number

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

    • c: number

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

    • d: number

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

    • tx: number

      沿 x 轴平移每个点的距离

    • ty: number

      沿 y 轴平移每个点的距离

    Returns Matrix

    矩阵自身

clone

  • clone(): Matrix
  • 返回一个新的 Matrix 对象,它是此矩阵的克隆,带有与所含对象完全相同的副本。

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Returns Matrix

concat

  • concat(other: Matrix): void
  • 将某个矩阵与当前矩阵连接,从而将这两个矩阵的几何效果有效地结合在一起。在数学术语中,将两个矩阵连接起来与使用矩阵乘法将它们结合起来是相同的。

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • other: Matrix

      要连接到源矩阵的矩阵。

    Returns void

copyFrom

  • copyFrom(other: Matrix): Matrix
  • 将源 Matrix 对象中的所有矩阵数据复制到调用方 Matrix 对象中。

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • other: Matrix

      要拷贝的目标矩阵

    Returns Matrix

createBox

  • createBox(scaleX: number, scaleY: number, rotation?: number, tx?: number, ty?: number): void
  • 包括用于缩放、旋转和转换的参数。当应用于矩阵时,该方法会基于这些参数设置矩阵的值。

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • scaleX: number

      水平缩放所用的系数

    • scaleY: number

      垂直缩放所用的系数

    • Optional rotation: number

      旋转量(以弧度为单位)

    • Optional tx: number

      沿 x 轴向右平移(移动)的像素数

    • Optional ty: number

      沿 y 轴向下平移(移动)的像素数

    Returns void

createGradientBox

  • createGradientBox(width: number, height: number, rotation?: number, tx?: number, ty?: number): void
  • 创建 Graphics 类的 beginGradientFill() 和 lineGradientStyle() 方法所需的矩阵的特定样式。 宽度和高度被缩放为 scaleX/scaleY 对,而 tx/ty 值偏移了宽度和高度的一半。

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • width: number

      渐变框的宽度

    • height: number

      渐变框的高度

    • Optional rotation: number

      旋转量(以弧度为单位)

    • Optional tx: number

      沿 x 轴向右平移的距离(以像素为单位)。此值将偏移 width 参数的一半

    • Optional ty: number

      沿 y 轴向下平移的距离(以像素为单位)。此值将偏移 height 参数的一半

    Returns void

deltaTransformPoint

  • deltaTransformPoint(point: Point): Point
  • 如果给定预转换坐标空间中的点,则此方法返回发生转换后该点的坐标。 与使用 transformPoint() 方法应用的标准转换不同,deltaTransformPoint() 方法的转换不考虑转换参数 tx 和 ty。

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • point: Point

      想要获得其矩阵转换结果的点

    Returns Point

    由应用矩阵转换所产生的点

determinant

  • determinant(): number

divide

equals

  • equals(other: Matrix): boolean
  • 是否与另一个矩阵数据相等

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • other: Matrix

      要比较的另一个矩阵对象。

    Returns boolean

    是否相等,ture表示相等。

identity

invert

multiply

prepend

  • prepend(a: number, b: number, c: number, d: number, tx: number, ty: number): Matrix
  • 前置矩阵

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • a: number

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

    • b: number

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

    • c: number

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

    • d: number

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

    • tx: number

      沿 x 轴平移每个点的距离

    • ty: number

      沿 y 轴平移每个点的距离

    Returns Matrix

    矩阵自身

release

rotate

scale

  • scale(sx: number, sy: number): Matrix2D

setTo

  • setTo(a: number, b: number, c: number, d: number, tx: number, ty: number): Matrix
  • 将 Matrix 的成员设置为指定值

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • a: number

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

    • b: number

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

    • c: number

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

    • d: number

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

    • tx: number

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

    • ty: number

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

    Returns Matrix

substract

toString

  • toString(): string
  • 返回将 Matrix 对象表示的几何转换应用于指定点所产生的结果。

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Returns string

    一个字符串,它包含 Matrix 对象的属性值:a、b、c、d、tx 和 ty。

transformPoint

  • transformPoint(pointX: number, pointY: number, resultPoint?: Point): Point
  • 返回将 Matrix 对象表示的几何转换应用于指定点所产生的结果。

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • pointX: number

      想要获得其矩阵转换结果的点的x坐标。

    • pointY: number

      想要获得其矩阵转换结果的点的y坐标。

    • Optional resultPoint: Point

      框架建议尽可能减少创建对象次数来优化性能,可以从外部传入一个复用的Point对象来存储结果,若不传入将创建一个新的Point对象返回。

    Returns Point

    由应用矩阵转换所产生的点。

translate

  • translate(dx: number, dy: number): Matrix2D

Static create

Static release

  • release(matrix: Matrix): void
  • 释放一个Matrix实例到对象池

    version

    Egret 2.4

    platform

    Web,Native

    language

    zh_CN

    Parameters

    • matrix: Matrix

      需要回收的 matrix

    Returns void

Generated using TypeDoc