跳到主要内容

Model3D

描述:

  用于渲染 glTF 3D 模型的类。

继承自:Node3D

speed

类型: 成员变量。

描述:

  当前动画的播放速度倍率。

签名:

speed: number

duration

类型: 只读成员变量。

描述:

  当前动画的时长,单位为秒。

签名:

const duration: number

elapsed

类型: 只读成员变量。

描述:

  当前动画已经播放的时间,单位为秒。

签名:

const elapsed: number

playing

类型: 只读成员变量。

描述:

  当前是否正在播放动画。

签名:

const playing: boolean

paused

类型: 只读成员变量。

描述:

  当前动画是否暂停。

签名:

const paused: boolean

animationCount

类型: 只读成员变量。

描述:

  此模型中的动画片段数量。

签名:

const animationCount: integer

materialCount

类型: 只读成员变量。

描述:

  当前实例中的材质槽数量。

签名:

const materialCount: integer

getAnimationName

类型: 函数。

描述:

  按从零开始的索引获取动画名称。

签名:

getAnimationName: function(self: Model3D, index: integer): string

hasNode

类型: 函数。

描述:

  检查是否存在指定名称的导入 glTF 节点。

签名:

hasNode: function(self: Model3D, name: string): boolean

attachToNode

类型: 函数。

描述:

  将用户持有的 Node3D 挂到指定导入节点下。

签名:

attachToNode: function(self: Model3D, name: string, child: Node3D): boolean

getLocalBoundsMin

类型: 函数。

描述:

  获取当前模型空间包围盒的最小点。

签名:

getLocalBoundsMin: function(self: Model3D): Vec3

getLocalBoundsMax

类型: 函数。

描述:

  获取当前模型空间包围盒的最大点。

签名:

getLocalBoundsMax: function(self: Model3D): Vec3

getWorldBoundsMin

类型: 函数。

描述:

  获取当前世界空间包围盒的最小点。

签名:

getWorldBoundsMin: function(self: Model3D): Vec3

getWorldBoundsMax

类型: 函数。

描述:

  获取当前世界空间包围盒的最大点。

签名:

getWorldBoundsMax: function(self: Model3D): Vec3

getMaterial

类型: 函数。

描述:

  按从零开始的索引获取逐实例材质槽。

签名:

getMaterial: function(self: Model3D, index: integer): Material3D | nil

play

类型: 函数。

描述:

  按名称播放动画。

签名:

play: function(self: Model3D, name?: string, loop?: boolean --[[false]]): number

参数:

参数名类型描述
namestring[可选] 动画名称。省略时使用默认动画。
loopboolean[可选] 动画是否循环播放。默认为 false。

返回值:

返回类型描述
number动画时长,单位为秒。未找到时返回 0。

stop

类型: 函数。

描述:

  停止当前动画。

签名:

stop: function(self: Model3D)

pause

类型: 函数。

描述:

  暂停当前动画。

签名:

pause: function(self: Model3D)

resume

类型: 函数。

描述:

  恢复暂停的动画。

签名:

resume: function(self: Model3D)