#类Transform
实现了Disposable

变换组件，用于描述元素的位置、旋转、缩放等信息

总览

构造函数

#Cconstructor
签名
Transform(props: TransformProps, parent: Transform): Transform
参数
props: TransformProps
参数
parent: Transform
返回Transform

属性

#Panchor只读

自身锚点

签名Vector3
#Pposition只读

自身位移

签名Vector3
#Pquat只读

自身旋转对应的四元数，右手坐标系，旋转正方向左手螺旋（轴向的顺时针），旋转欧拉角的顺序为 ZYX

签名Quaternion
#Protation只读

自身旋转角度

签名Euler
#Pscale只读

自身缩放

签名Vector3
#Psize只读

元素矩形宽高

签名Vector2

方法

#MaddChild
签名
addChild(child: Transform): void
描述

添加子变换

参数
child: Transform

要添加的子变换

返回void
#MassignWorldTRS
签名
assignWorldTRS(position: Vector3, quat: Quaternion, scale: Vector3): void
描述

根据世界变换矩阵计算位移、旋转、缩放向量

参数
position: Vector3
参数
quat: Quaternion
参数
scale: Vector3
返回void
#McloneFromMatrix
签名
cloneFromMatrix(m4: Matrix4, scale: Vector3): void
描述

拆解并复制指定矩阵到自身变换

@returns
参数
m4: Matrix4
参数
scale: Vector3
返回void
#MgetMatrix
签名
getMatrix(): Matrix4
描述

获取自身变换对应的模型矩阵 数据修改且需要生效时更新自身矩阵 当变换不需要生效时返回单位矩阵

@returns
返回Matrix4
#MgetParentMatrix
签名
getParentMatrix(): Matrix4
描述

获取父矩阵，如果有多级父节点，返回整体变换

@returns
返回Matrix4
#MgetQuaternion
签名
getQuaternion(): Quaternion
描述

获取当前的四元数

@returns
返回Quaternion
#MgetRotation
签名
getRotation(): Euler
描述

获取当前的旋转量

@returns
返回Euler
#MgetValid
签名
getValid(): boolean
描述

获取 Transform 是否生效

返回boolean
#MgetWorldMatrix
签名
getWorldMatrix(): Matrix4
描述

获取包含自身变换和父变换的模型变换矩阵

@returns
返回Matrix4
#MgetWorldPosition
签名
getWorldPosition(): Vector3
描述

获取联合变换后的最终位置

@returns
返回Vector3
#MgetWorldRotation
签名
getWorldRotation(): Euler
描述

获取联合变换后的最终旋转量

@returns
返回Euler
#MgetWorldScale
签名
getWorldScale(): Vector3
描述

获取联合变换后的最终缩放因子

@returns
返回Vector3
#MremoveChild
签名
removeChild(child: Transform): void
描述

移除子变换

参数
child: Transform
返回void
#MrotateByQuat
签名
rotateByQuat(quat: Quaternion): void
描述

在当前旋转的基础上使用四元素添加旋转

参数
quat: Quaternion
返回void
#MscaleBy
签名
scaleBy(x: number, y: number, z: number): void
描述

在当前缩放基础上设置缩放系数

参数
x: number
参数
y: number
参数
z: number
返回void
#MsetAnchor
签名
setAnchor(x: number, y: number): void
描述

设置锚点

参数
x: number
参数
y: number
返回void
#MsetPosition
签名
setPosition(x: number, y: number, z: number): void
描述

设置位置

参数
x: number
参数
y: number
参数
z: number
返回void
#MsetRotation
签名
setRotation(x: number, y: number, z: number): void
描述

设置旋转

参数
x: number
参数
y: number
参数
z: number
返回void
#MsetScale
签名
setScale(x: number, y: number, z: number): void
描述

设置缩放

参数
x: number
参数
y: number
参数
z: number
返回void
#MsetTransform
签名
setTransform(props: TransformProps, reverseEuler: boolean): void
描述

批量设置 transform 属性

参数
props: TransformProps

要设置的属性

参数
reverseEuler: boolean

设置 rotation时，欧拉角是否需要取负值

返回void
#MsetValid
签名
setValid(val: boolean): void
描述

设置 Transform 生效 / 失效， 默认元素生命周期开始后生效，结束后失效

参数
val: boolean
返回void
#MsetWorldPosition
签名
setWorldPosition(x: number, y: number, z: number): void
描述

设置世界坐标位置

参数
x: number

世界坐标 x

参数
y: number

世界坐标 y

参数
z: number

世界坐标 z

返回void
#Mtranslate
签名
translate(x: number, y: number, z: number): void
描述

在当前位置的基础上添加位置偏移

参数
x: number
参数
y: number
参数
z: number
返回void
#MupdateLocalMatrix
签名
updateLocalMatrix(): void
描述

更新元素自身变换矩阵

返回void
#MgetRotation静态
签名
getRotation(quat: Quaternion, out: Euler): Euler
描述

转换右手坐标系左手螺旋对应的四元数到对应的旋转角

@returns
参数
quat: Quaternion

四元数

参数
out: Euler

欧拉角

返回Euler