Class TModel

initAssemble

• initAssemble(modelInfo?: modelInfoParams): Promise<any>

  创建组合模型

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数

  Returns Promise<any>

  Update

  2026/07/01 - 整合loadModel方法

initBufferAttribute

• initBufferAttribute(
      array: any,
      itemSize: any,
  ): BufferAttribute<BufferAttributeEventMap>

  Parameters

  • array: any
  • itemSize: any

  Returns BufferAttribute<BufferAttributeEventMap>

initBufferGeometry

• initBufferGeometry(): BufferGeometry<
      NormalBufferAttributes,
      BufferGeometryEventMap,
  >

  Returns BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>

initCircle

• initCircle(modelInfo?: any): Object3D

  创建圆形（平面）

  Parameters

  • OptionalmodelInfo: any

    模型参数

  Returns Object3D

initCone

• initCone(modelInfo?: modelInfoParams): Object3D

  创建圆锥

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数

  Returns Object3D

initCube

• initCube(modelInfo?: modelInfoParams, material?: any): Object3D

  创建立方体

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数
  • Optionalmaterial: any

    材质

  Returns Object3D

initCylinder

• initCylinder(modelInfo?: modelInfoParams): Object3D

  创建圆柱体

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数

  Returns Object3D

initFence

• initFence(fenceInfo: fenceInfoParams): Promise<Object3D<Object3DEventMap>>

  创建围栏

  Parameters

  • fenceInfo: fenceInfoParams

  Returns Promise<Object3D<Object3DEventMap>>

initGroup

• initGroup(modelInfo?: modelInfoParams): Object3D

  创建Group

  Parameters

  • OptionalmodelInfo: modelInfoParams

    [modelInfo] 模型参数

  Returns Object3D

initLineHelper

• initLineHelper(modelInfo?: modelInfoParams): Object3D

  创建线辅助器

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数

  Returns Object3D

initLOD

• initLOD(
      modelInfo?: modelInfoParams,
      mode?: "auto" | "performance" | "distance",
      disableCache?: boolean,
  ): Promise<Object3D<Object3DEventMap>>

  创建LOD（Level of Detail）对象 支持两种模式：

  1. 距离模式：根据距离阈值自动切换不同细节层次的模型（传统LOD）
  2. 性能模式：根据设备性能自动选择合适细节层次的模型 自动检测模式：如果levels中有distance属性，使用距离模式；否则使用性能模式

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数
  • mode: "auto" | "performance" | "distance" = 'auto'

    可选，强制指定模式：'distance' | 'performance' | 'auto'（默认自动检测）
  • disableCache: boolean = false

    可选，是否禁用缓存（默认不禁用）

  Returns Promise<Object3D<Object3DEventMap>>

initLoft

• initLoft(
      options: {
          capEnd?: boolean;
          capStart?: boolean;
          color?: string;
          modelName?: string;
          position?: { x: number; y: number; z: number };
          sections: Vector3[][];
      },
  ): Object3D

  Loft 放样（r185 LoftGeometry）

  Parameters

  • options: {
        capEnd?: boolean;
        capStart?: boolean;
        color?: string;
        modelName?: string;
        position?: { x: number; y: number; z: number };
        sections: Vector3[][];
    }

  Returns Object3D

initMap

• initMap(modelInfo?: any): Promise<Object3D<Object3DEventMap>>

  创建地图

  Parameters

  • OptionalmodelInfo: any

    模型参数

  Returns Promise<Object3D<Object3DEventMap>>

initMesh

• initMesh(geometry?: any, material?: any): Mesh<any, any, Object3DEventMap>

  Parameters

  • Optionalgeometry: any
  • Optionalmaterial: any

  Returns Mesh<any, any, Object3DEventMap>

initPlane

• initPlane(modelInfo?: modelInfoParams): Promise<Object3D<Object3DEventMap>>

  创建平面

  Parameters

  • OptionalmodelInfo: modelInfoParams

  Returns Promise<Object3D<Object3DEventMap>>

initPlaneGeometry

• initPlaneGeometry(width?: number, height?: number): PlaneGeometry

  创建平面缓冲几何体

  Parameters

  • Optionalwidth: number
  • Optionalheight: number

  Returns PlaneGeometry

initPoints

• initPoints(modelInfo?: modelInfoParams): Object3D

  创建点云

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数

  Returns Object3D

initPoints2

• initPoints2(modelInfo?: modelInfoParams): Object3D

  Parameters

  • OptionalmodelInfo: modelInfoParams

  Returns Object3D

initShelf

• initShelf(modelInfo?: modelInfoParams): Promise<Object3D<Object3DEventMap>>

  创建货架 自定义尺寸

  Parameters

  • OptionalmodelInfo: modelInfoParams

  Returns Promise<Object3D<Object3DEventMap>>

initSimTexts

• initSimTexts(info: any, model: any): Promise<void>

  创建仿真文字

  Parameters

  • info: any
  • model: any

  Returns Promise<void>

initSphere

• initSphere(modelInfo?: modelInfoParams, material?: any): Object3D

  创建球体

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数
  • Optionalmaterial: any

    材质（不传使用默认）

  Returns Object3D

initSpritePic

• initSpritePic(modelInfo?: modelInfoParams): Object3D

  创建图片精灵

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数

  Returns Object3D

initSpriteShape

• initSpriteShape(modelInfo?: modelInfoParams): Object3D

  创建精灵图形

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数

  Returns Object3D

initVideoPlane

• initVideoPlane(dom: HTMLVideoElement, modelInfo?: modelInfoParams): Object3D

  创建视频面板

  Parameters

  • dom: HTMLVideoElement

    video标签
  • OptionalmodelInfo: modelInfoParams

    模型参数

  Returns Object3D

initZip

• initZip(modelInfo?: modelInfoParams): Promise<Object3D<Object3DEventMap>>

  创建压缩包导入模型（支持gltf/glb/fbx/obj/stl/json及跨目录纹理）

  Parameters

  • OptionalmodelInfo: modelInfoParams

    模型参数数组

  Returns Promise<Object3D<Object3DEventMap>>

  Update

  2026/04/24 (性能优化版：异步解压、合并遍历、减少主线程阻塞)

  Note

  下载 → Worker 解压 → 建文件映射 → 选模型 → 独立 LoadingManager + setURLModifier（把贴图 URL 重写成 Blob URL）→ loadWithConfig → FBX 贴图自动修复 → 清理 Blob。

loadModel

• loadModel(
      modelInfo: modelInfoParams,
      useIndexedDB?: boolean,
  ): Promise<Object3D<Object3DEventMap>>

  加载模型（单个或批量）

  • 传入单个 modelInfo：走单模型加载，返回 Object3D
  • 传入 models 数组：走批量逻辑（同 id 仅首条 loadModel，其余复制并应用独立配置；indexedDB 缓存、加载进度），返回 Object3D[]

  Parameters

  • modelInfo: modelInfoParams

    单个模型信息
  • OptionaluseIndexedDB: boolean

    是否使用 indexedDB（仅单模型时有效，默认 true）

  Returns Promise<Object3D<Object3DEventMap>>

  Update

  2026/06/20 - 优化 indexedDB 存储逻辑、批量加载逻辑

• loadModel(
      models: modelInfoParams[],
      onModelLoaded?: (model: Object3D, index: number) => void,
      onAllLoaded?: (
          models: Object3D<Object3DEventMap>[],
          thingOrigin?: ThingOrigin,
      ) => ThingOrigin,
  ): Promise<Object3D<Object3DEventMap>[]>

  加载模型（单个或批量）

  • 传入单个 modelInfo：走单模型加载，返回 Object3D
  • 传入 models 数组：走批量逻辑（同 id 仅首条 loadModel，其余复制并应用独立配置；indexedDB 缓存、加载进度），返回 Object3D[]

  Parameters

  • models: modelInfoParams[]

    模型数组
  • OptionalonModelLoaded: (model: Object3D, index: number) => void

    单个模型加载完成的回调
  • OptionalonAllLoaded: (models: Object3D<Object3DEventMap>[], thingOrigin?: ThingOrigin) => ThingOrigin

    所有模型加载完成的回调，接收模型数组和 ThingOrigin 实例，返回 ThingOrigin 实例供后续操作

  Returns Promise<Object3D<Object3DEventMap>[]>

  Update

  2026/06/20 - 优化 indexedDB 存储逻辑、批量加载逻辑

mergeMesh

• mergeMesh(
      meshArray: Mesh<
          BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
          Material<MaterialEventMap> | Material<MaterialEventMap>[],
          Object3DEventMap,
      >[],
  ): Mesh<
      any,
      Material<MaterialEventMap>
      | Material<MaterialEventMap>[],
      Object3DEventMap,
  >

  Parameters

  • meshArray: Mesh<
        BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
        Material<MaterialEventMap> | Material<MaterialEventMap>[],
        Object3DEventMap,
    >[]

  Returns Mesh<
      any,
      Material<MaterialEventMap>
      | Material<MaterialEventMap>[],
      Object3DEventMap,
  >

  Description

  合并Mesh网格

  Warn

  需手动将合并的模型删除

updateModelHierarchy

• updateModelHierarchy(root: Object3D): void

  更新模型层级

  Parameters

  • root: Object3D

    根模型节点

  Returns void

warmupDecoders

• warmupDecoders(renderer?: TORenderer): Promise<void>

  预热 Draco / KTX2 解码器（在首批 glb 加载前调用，避免 wasm 计入首模时间） 远程 wasm 加载失败时（如本地 dev CORS）自动回退 three 内置资源

  Parameters

  • Optionalrenderer: TORenderer

  Returns Promise<void>

ColladaLoader

DRACO_LOADER

FBXLoader

GLTFLoader

KTX2_LOADER

MANAGER

ObjectLoader

OBJLoader

PLYLoader

Rhino3dmLoader

STLLoader

SVGLoader

TDSLoader

URDFLoader