Class BabylonGltf

在 io 中基本导入/导出之上的高级 glTF/glb 工具。它保留完整的资源容器，而不是把所有内容折叠成单个网格，从而启用 KHR_materials_variants、动画组以及其他需要已加载资源图的 glTF 级特性。

Index

Constructors

animations

getAnimationGroups listAnimationGroupNames playAnimationGroup stopAnimationGroup

get

getRootNode getMeshes

load

loadAssetContainerFromUrl loadAssetContainer

variants

listMaterialVariants selectMaterialVariant getSelectedMaterialVariant resetMaterialVariant

Constructors

constructor

new BabylonGltf(): Bit.BabylonGltf
Returns Bit.BabylonGltf

animations

getAnimationGroups

getAnimationGroups(inputs: AssetContainerDto): AnimationGroup[]
获取已加载 glTF 资源容器的动画组。
Parameters
- inputs: AssetContainerDto
  资源容器
Returns AnimationGroup[]
动画组
- Defined in bitbybit-docs.d.ts:48693

listAnimationGroupNames

listAnimationGroupNames(inputs: AssetContainerDto): string[]
列出已加载 glTF 资源容器的动画组名称。
Parameters
- inputs: AssetContainerDto
  资源容器
Returns string[]
动画组的名称
- Defined in bitbybit-docs.d.ts:48701

playAnimationGroup

playAnimationGroup(inputs: PlayAnimationGroupDto): void
开始播放已加载 glTF 资源的动画组。
Parameters
- inputs: PlayAnimationGroupDto
  动画组和播放选项
Returns void
- Defined in bitbybit-docs.d.ts:48708

stopAnimationGroup

stopAnimationGroup(inputs: AnimationGroupDto): void
停止已加载 glTF 资源的动画组。
Parameters
- inputs: AnimationGroupDto
  动画组
Returns void
- Defined in bitbybit-docs.d.ts:48715

get

getRootNode

getRootNode(inputs: AssetContainerDto): TransformNode
获取已加载 glTF 资源的根变换节点。材质变体操作需要此节点。
Parameters
- inputs: AssetContainerDto
  资源容器
Returns TransformNode
根变换节点
- Defined in bitbybit-docs.d.ts:48647

getMeshes

getMeshes(inputs: AssetContainerDto): AbstractMesh[]
获取已加载 glTF 资源容器的所有网格。
Parameters
- inputs: AssetContainerDto
  资源容器
Returns AbstractMesh[]
网格
- Defined in bitbybit-docs.d.ts:48655

load

loadAssetContainerFromUrl

loadAssetContainerFromUrl(inputs: AssetFileByUrlDto): Promise<AssetContainer>
从 URL 将 glTF 或 glb 文件加载到场景中并返回资源容器。该容器保留对网格、材质、动画组和根节点的引用，使材质变体等功能能够正常工作。
Parameters
- inputs: AssetFileByUrlDto
  资源文件名和根 url
Returns Promise<AssetContainer>
已加载 gltf 的 Babylon 资源容器
- Defined in bitbybit-docs.d.ts:48631

loadAssetContainer

loadAssetContainer(inputs: AssetFileDto): Promise<AssetContainer>
从上传的资源文件将 glTF 或 glb 文件加载到场景中并返回资源容器。
Parameters
- inputs: AssetFileDto
  资源文件
Returns Promise<AssetContainer>
已加载 glTF 的 Babylon 资源容器
- Defined in bitbybit-docs.d.ts:48639

variants

listMaterialVariants

listMaterialVariants(inputs: GltfRootNodeDto): string[]
列出已加载 glTF 资源所声明的 KHR_materials_variants 材质变体的名称。
Parameters
- inputs: GltfRootNodeDto
  glTF 根节点
Returns string[]
可用材质变体的名称
- Defined in bitbybit-docs.d.ts:48663

selectMaterialVariant

selectMaterialVariant(inputs: SelectVariantDto): void
按名称激活 KHR_materials_variants 材质变体，相应地替换资源的材质。
Parameters
- inputs: SelectVariantDto
  glTF 根节点和变体名称
Returns void
- Defined in bitbybit-docs.d.ts:48670

getSelectedMaterialVariant

getSelectedMaterialVariant(inputs: GltfRootNodeDto): string | string[]
获取已加载 glTF 资源当前选定的 KHR_materials_variants 材质变体。
Parameters
- inputs: GltfRootNodeDto
  glTF 根节点
Returns string | string[]
所选材质变体的名称，未选择时为空
- Defined in bitbybit-docs.d.ts:48678

resetMaterialVariant

resetMaterialVariant(inputs: GltfRootNodeDto): void
将已加载 glTF 资源的材质重置回原始的 KHR_materials_variants 默认值。
Parameters
- inputs: GltfRootNodeDto
  glTF 根节点
Returns void
- Defined in bitbybit-docs.d.ts:48685