用于加载 `LDraw` 资源。
[link:https://ldraw.org LDraw] (LEGO Draw) 是一种
[link:https://ldraw.org/article/218.html 开放格式规范] ,用于描述 LEGO 和其他建筑套装 3D 模型。
LDraw 资源(通常扩展名为 .ldr、.dat 或 .txt 的文本文件)可以仅描述单个构造件或整个模型。对于模型,LDraw 文件可以引用其他 LDraw 文件,这些文件是从使用 [page:Function setPartsLibraryPath] 设置的库路径加载的。您通常下载 LDraw 官方零件库,解压到一个文件夹并将 setPartsLibraryPath 指向它。
库部件将通过子文件夹“parts”、“p” 和 “models” 中的反复试验来加载。这些文件访问对于 Web 环境来说并不是最佳的,因此我们制作了一个脚本工具来将 LDraw 文件及其所有依赖项打包到一个文件中,这样加载速度会更快。请参阅“打包 LDraw 模型”部分。LDrawLoader 示例加载多个打包文件。由于官方零件库较大,因此不包含在内。
[name] 是一个附加组件,必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons].
import { LDrawLoader } from 'three/addons/loaders/LDrawLoader.js';
[name] 支持以下扩展:
// Instantiate a loader
const loader = new LDrawLoader();
// Optionally set library parts path
// loader.setPartsLibraryPath( path to library );
// Load a LDraw resource
loader.load(
// resource URL
'models/car.ldr_Packed.mpd',
// called when the resource is loaded
function ( group ) {
// Optionally, use LDrawUtils.mergeObject() from
// 'examples/jsm/utils/LDrawUtils.js' to merge all
// geometries by material (it gives better runtime
// performance, but building steps are lost)
// group = LDrawUtils.mergeObject( group );
scene.add( group );
},
// called while loading is progressing
function ( xhr ) {
console.log( ( xhr.loaded / xhr.total * 100 ) + '% loaded' );
},
// called when loading has errors
function ( error ) {
console.log( 'An error happened' );
}
);
[example:webgl_loader_ldraw]
要将模型及其所有引用文件打包,请下载 [link:https://www.ldraw.org/parts/latest-parts.html 官方 LDraw 零件库] 并使用以下节点脚本:[link:https://github.com/mrdoob/three.js/blob/master/utils/packLDrawModel.js utils/packLDrawModel.js] 它包含有关如何设置文件和执行文件的说明。
[name] 返回一个包含对象层次结构的 [page:Group] 。根据每个子对象类型,其 .userData 成员将包含以下成员:
在 [page:Group]中, userData 成员将包含:
在 [page:Material] 中,userData 成员将包含:
[page:LoadingManager manager] — 加载器使用的 [page:LoadingManager loadingManager] 。默认值为 [page:LoadingManager THREE.DefaultLoadingManager]。
创建一个新的 [name]。
有关公共属性,请参阅 [page:Loader] 基类。
有关常用方法,请参阅 [page:Loader] 基类。
[page:String url] — 包含 LDraw 文件的路径/URL 的字符串。
[page:Function onLoad] — 加载成功完成后调用的函数。该函数接收从 [page:Function parse] 返回的加载的 JSON 响应。
[page:Function onProgress] — (可选)加载过程中调用的函数。参数将是 XMLHttpRequest 实例,其中包含 .[page:Integer total] 和 .[page:Integer
loaded] 字节。如果服务器没有设置 Content-Length,.[page:Integer total] 将为 0。
[page:Function onError] — (可选)加载期间发生错误时调用的函数。该函数接收错误作为参数。
开始从 url 加载并使用解析的响应内容调用回调函数。
[page:String path] — 用于加载引用零件的库零件文件的路径。这与 [page:Loader.setPath] 不同,后者指示加载主资源的路径。
必须在 [page:.load] 之前调用此方法,除非要加载的模型不引用库部件(通常它将是一个所有部件都打包在单个文件中的模型)。
[page:Map map] — 设置从 [page:String] 到 [page:String] 的映射,将引用的库文件名映射到新文件名。如果未指定 fileMap(默认值),则将通过子文件夹“parts”、“p”和“models”中的反复试验来访问库部件。
[page:String text] — 要解析的 LDraw 资源,作为字符串。
[page:String path] — 从中查找其他引用的 LDraw 资源文件的基本路径。
[page:Function onLoad] — 解析完成时调用的函数。
将 LDraw 文件内容解析为字符串,并在完成时触发 [page:Function onLoad] 回调。[page:Function onLoad] 的参数将是一个 [page:Group],其中包含 [page:Group]、[page:Mesh] 和 [page:LineSegments] 的层次结构(以及 .userData 字段中的其他零件数据)。
[page:String colourCode] — 用于获取关联 [page:Material] 的颜色代码。
返回主 LDraw 颜色的 [page:Material]。
对于已加载的 LDraw 资源,返回与主颜色代码关联的 [page:Material]。此方法可用于修改模型或暴露模型的零件的主要材质。
主要颜色代码是为 LDraw 零件着色的标准方法。三角形为“16”,边为“24”。通常,完整的模型不会暴露主要颜色(也就是说,没有零件在顶层使用代码“16”,因为它们被分配了其他特定颜色)另一方面,LDraw零件文件将暴露代码“16”可以着色,并且可以有附加的固定颜色。
返回边缘主 LDraw 颜色的 [page:Material]。
[page:String path] — LDraw 材料资源的路径。
此异步方法从单个 LDraw 文件预加载材质。在官方零件库中,有一个特殊文件,始终首先加载(LDConfig.ldr)并包含所有标准颜色代码。此方法旨在与未打包的文件一起使用,例如在预加载材料并按需加载部件的编辑器中。
[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/loaders/LDrawLoader.js examples/jsm/loaders/LDrawLoader.js]