跳到主要内容

Node3D

描述:

  用于构建 3D 对象层级树的类。

继承自:Object

order

类型: 成员变量。

描述:

  节点在父节点子节点数组中的顺序。

签名:

order: integer

tag

类型: 成员变量。

描述:

  节点的字符串标签。

签名:

tag: string

visible

类型: 成员变量。

描述:

  节点是否可见。

签名:

visible: boolean

parent

类型: 只读成员变量。

描述:

  父 3D 节点。

签名:

const parent: Node3D | nil

hasChildren

类型: 只读成员变量。

描述:

  节点是否拥有 3D 子节点。

签名:

const hasChildren: boolean

position

类型: 成员变量。

描述:

  节点位置。

签名:

position: Vec3

scale

类型: 成员变量。

描述:

  节点缩放。

签名:

scale: Vec3

rotation

类型: 成员变量。

描述:

  节点旋转。

签名:

rotation: any

angles

类型: 成员变量。

描述:

  节点欧拉角旋转,单位为度。

签名:

angles: Vec3

worldMatrix

类型: 只读成员变量。

描述:

  节点的世界变换矩阵。

签名:

const worldMatrix: any

x

类型: 成员变量。

描述:

  节点的 X 轴位置。

签名:

x: number

y

类型: 成员变量。

描述:

  节点的 Y 轴位置。

签名:

y: number

z

类型: 成员变量。

描述:

  节点的 Z 轴位置。

签名:

z: number

angleX

类型: 成员变量。

描述:

  节点绕 X 轴的旋转角度,单位为度。

签名:

angleX: number

angleY

类型: 成员变量。

描述:

  节点绕 Y 轴的旋转角度,单位为度。

签名:

angleY: number

angleZ

类型: 成员变量。

描述:

  节点绕 Z 轴的旋转角度,单位为度。

签名:

angleZ: number

scaleX

类型: 成员变量。

描述:

  节点的 X 轴缩放系数。

签名:

scaleX: number

scaleY

类型: 成员变量。

描述:

  节点的 Y 轴缩放系数。

签名:

scaleY: number

scaleZ

类型: 成员变量。

描述:

  节点的 Z 轴缩放系数。

签名:

scaleZ: number

addChild

类型: 函数。

描述:

  添加子 3D 节点。

签名:

addChild: function(
self: Node3D,
child: Node3D,
order?: integer --[[0]],
tag?: string --[[""]]
)

参数:

参数名类型描述
childNode3D要添加的子节点。
orderinteger[可选] 子节点的绘制顺序。默认为 0。
tagstring[可选] 子节点的标签。默认为空字符串。

removeChild

类型: 函数。

描述:

  移除子 3D 节点。

签名:

removeChild: function(self: Node3D, child: Node3D, cleanup?: boolean --[[true]])

参数:

参数名类型描述
childNode3D要移除的子节点。
cleanupboolean[可选] 是否清理子节点。默认为 true。

removeAllChildren

类型: 函数。

描述:

  移除所有子 3D 节点。

签名:

removeAllChildren: function(self: Node3D, cleanup?: boolean --[[true]])

参数:

参数名类型描述
cleanupboolean[可选] 是否清理子节点。默认为 true。

removeFromParent

类型: 函数。

描述:

  从父节点中移除当前节点。

签名:

removeFromParent: function(self: Node3D, cleanup?: boolean --[[true]])

参数:

参数名类型描述
cleanupboolean[可选] 是否清理当前节点。默认为 true。

cleanup

类型: 函数。

描述:

  清理当前节点并释放 3D 资源。

签名:

cleanup: function(self: Node3D)

convertToWorldSpace

类型: 函数。

描述:

  将本地坐标点转换到世界坐标空间。

签名:

convertToWorldSpace: function(self: Node3D, localPoint: Vec3): Vec3

参数:

参数名类型描述
localPointVec3本地坐标点。

返回值:

返回类型描述
Vec3转换后的世界坐标点。

convertToNodeSpace

类型: 函数。

描述:

  将世界坐标点转换到本地坐标空间。

签名:

convertToNodeSpace: function(self: Node3D, worldPoint: Vec3): Vec3

参数:

参数名类型描述
worldPointVec3世界坐标点。

返回值:

返回类型描述
Vec3转换后的本地坐标点。