用途:在 Three.js 中加载 3D 模型(GLTF/GLB、FBX、OBJ+MTL)、2D 纹理、立方体贴图与 HDR 环境贴图时提供统一的加载器语法与注意事项,帮助避免压缩解码器未配置、色彩空间设置错误等问题。
主要能力:说明所有加载器继承自 Loader 基类的两种调用方式——回调式 loader.load(url, onLoad, onProgress, onError) 与 Promise 式 await loader.loadAsync(url, onProgress);列出各加载器的导入路径(TextureLoader、CubeTextureLoader、GLTFLoader、DRACOLoader、KTX2Loader、FBXLoader、OBJLoader、MTLLoader、RGBELoader、MeshoptDecoder)。介绍 LoadingManager 的进度与错误回调、itemStart/itemEnd/itemError、setURLModifier 等方法。说明 GLTFLoader 返回对象字段(scene、scenes、cameras、animations、asset、parser、userData)及 setDRACOLoader、setKTX2Loader、setMeshoptDecoder、register 等配置方法;DRACOLoader 的 setDecoderPath、setDecoderConfig、preload、dispose;纹理与 HDR 的加载与色彩空间设置;FBX 与 OBJ+MTL 的加载步骤;以及通过 traverse 释放几何体、材质与纹理的写法。
使用方式与限制:资料建议优先使用 glTF/GLB,并在初始化阶段一次性加载并缓存资源,避免在渲染循环中调用 load;Draco 模型需先设置指向含 draco_decoder.wasm 目录的路径,全部加载后调用 dispose;loadAsync 需包裹 try/catch;颜色类纹设 SRGBColorSpace,数据类纹不设;MTL 需先于 OBJ 加载。资料另引用 references 目录与官方文档链接,具体平台与收费信息暂未提供。