123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278 |
- <!DOCTYPE html>
- <html lang="zh">
- <head>
- <meta charset="utf-8" />
- <base href="../../../" />
- <script src="page.js"></script>
- <link type="text/css" rel="stylesheet" href="page.css" />
- </head>
- <body>
- [page:Loader] →
- <h1>3DM加载器([name])</h1>
- <p class="desc">
- 用于加载 Rhinoceros 3d 模型文件。<br /><br />
- Rhinoceros 是一个 3D 建模器,用于创建、编辑、分析、记录、渲染、动画和转换 NURBS 曲线、曲面、breps、挤压、点云以及多边形网格和 SubD 对象。
- [link:https://github.com/mcneel/rhino3dm rhino3dm.js] 从开源几何库 [link:https://github.com/mcneel/opennurbs openNURBS]
- 编译为 WebAssembly 。加载器当前使用 [link:https://www.npmjs.com/package/rhino3dm/v/8.0.1 rhino3dm.js 8.0.1.]。
- </p>
- <h2>导入</h2>
- <p>
- [name] 是一个附加组件,必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons]。
- </p>
- <code>
- import { Rhino3dmLoader } from 'three/addons/loaders/3DMLoader.js';
- </code>
- <h2>支持的转换</h2>
- <p>
- [name] 将 Rhino 对象转换为以下 three.js 类型:
- </p>
- <table>
- <tr>
- <th>3dm type</th>
- <th>three.js type</th>
- </tr>
- <tr>
- <td>Point</td>
- <td>[page:Points Points]</td>
- </tr>
- <tr>
- <td>PointSet / PointCloud</td>
- <td>[page:Points Points]</td>
- </tr>
- <tr>
- <td>TextDot</td>
- <td>[page:Sprite Sprite]</td>
- </tr>
- <tr>
- <td>Curve</td>
- <td>[page:Line Line] <sup> 1</sup></td>
- </tr>
- <tr>
- <td>Mesh</td>
- <td>[page:Mesh Mesh]</td>
- </tr>
- <tr>
- <td>Extrusion</td>
- <td>[page:Mesh Mesh]<sup> 2</sup></td>
- </tr>
- <tr>
- <td>BREP</td>
- <td>[page:Mesh Mesh]<sup> 2</sup></td>
- </tr>
- <tr>
- <td>SubD</td>
- <td>[page:Mesh Mesh]<sup> 3</sup></td>
- </tr>
- <tr>
- <td>InstanceReferences</td>
- <td>[page:Object3D Object3D]</td>
- </tr>
- <tr>
- <td>DirectionalLight</td>
- <td>[page:DirectionalLight DirectionalLight]</td>
- </tr>
- <tr>
- <td>PointLight</td>
- <td>[page:PointLight PointLight]</td>
- </tr>
- <tr>
- <td>RectangularLight</td>
- <td>[page:RectAreaLight RectAreaLight]</td>
- </tr>
- <tr>
- <td>SpotLight</td>
- <td>[page:SpotLight SpotLight]</td>
- </tr>
- <tr>
- <td>File3dm</td>
- <td>[page:Object3D Object3D]<sup> 4</sup></td>
- </tr>
- <tr>
- <td>Material / Physically Based Material</td>
- <td>[page:MeshPhysicalMaterial MeshPhysicalMaterial]</td>
- </tr>
- </table>
- <h3>注意:</h3>
- <p><i>
- <sup>1</sup> NURBS 曲线被离散化为硬编码分辨率。
- </i></p>
- <p><i>
- <sup>2</sup> 基于 BREP 和 NURBS 曲面的类型用其“渲染网格”表示。如果渲染网格未在 Rhino 中以适当的显示模式显示(即“着色”、“渲染”等),或者以编程方式创建(例如通过 Grasshopper
- 或直接使用 rhino3dm),则渲染网格可能不会与这些对象关联图书馆。从 rhino3dm.js@8.0.0-beta2 开始,BrepFace 和 Extrusions 可以分配网格表示,但这些必须由用户生成。
- </i></p>
- <p><i>
- <sup>3</sup> SubD 对象通过细分其控制网来表示。
- </i></p>
- <p><i>
- <sup>4</sup> 无论 Rhino 文件(File3dm)被加载还是解析,返回的对象都是一个 [page:Object3D
- Object3D] ,所有 Rhino 对象(File3dmObject)都是子对象。File3dm 图层和其他文件级属性将添加到生成对象的 userData 中。
- </i></p>
- <p><i>
- <sup>5</sup> 所有生成的 Three.js 对象都具有来自填充在其 userData 对象中的 Rhino 对象的有用属性(即图层索引、名称等)。
- </i></p>
- <p><i>
- <sup>6</sup> Rhino 和 Three.js 有不同的坐标系。导入后,您应该将生成的 [page:Object3D Object3D] 在 x 方向上旋转 -90° 或在应用程序开始时设置
- THREE.Object3D.DEFAULT_UP:
- <code>THREE.Object3D.DEFAULT_UP.set( 0, 0, 1 );</code>
- 请记住,这将影响应用程序中所有 Object3D 的方向。
- </i></p>
- <h2>例子</h2>
- <p>
- [example:webgl_loader_3dm]
- </p>
- <h2>构造函数</h2>
- <h3>Rhino3dmLoader( [param:LoadingManager manager] )</h3>
- <p>
- [page:LoadingManager manager] — 加载器使用的 [page:LoadingManager loadingManager]。默认值为 [page:LoadingManager
- THREE.DefaultLoadingManager]。
- </p>
- <p>
- 创建一个新的 Rhino3dmLoader。
- </p>
- <h2>属性</h2>
- <p>有关常用属性,请参阅 [page:Loader] 基类。</p>
- <h2>方法</h2>
- <p>有关常用方法,请参阅 [page:Loader] 基类。</p>
- <h3>[method:Object3D load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function
- onError] )</h3>
- <p>
- [page:String url] — 包含 `.3dm` 文件路径/URL的字符串<br />
- [page:Function onLoad] — 加载成功完成后调用的函数<br />
- [page:Function onProgress] — (可选)加载过程中调用的函数。参数将是 XMLHttpRequest 实例,其中包含 .[page:Integer total] 和 .[page:Integer
- loaded] 字节。如果服务器没有设置 Content-Length,.[page:Integer total] 将为 0。<br />
- [page:Function onError] — (可选)加载期间发生错误时调用的函数。该函数接收错误作为参数。<br />
- </p>
- <p>
- 开始从 url 加载并在解析得到 Object3d 后调用 `onLoad` 。
- </p>
- <code>
- // Instantiate a loader
- const loader = new Rhino3dmLoader();
-
- // Specify path to a folder containing WASM/JS libraries or a CDN.
- // For example, /jsm/libs/rhino3dm/ is the location of the library inside the three.js repository
- // loader.setLibraryPath( '/path_to_library/rhino3dm/' );
- loader.setLibraryPath( 'https://cdn.jsdelivr.net/npm/rhino3dm@8.0.1/' );
-
- // Load a 3DM file
- loader.load(
- // resource URL
- 'model.3dm',
- // called when the resource is loaded
- function ( object ) {
-
- scene.add( object );
-
- },
- // called as loading progresses
- function ( xhr ) {
-
- console.log( ( xhr.loaded / xhr.total * 100 ) + '% loaded' );
-
- },
- // called when loading has errors
- function ( error ) {
-
- console.log( 'An error happened' );
-
- }
- );
- </code>
- <h3>[method:Object3D parse]( [param:ArrayBuffer buffer], [param:Function onLoad], [param:Function onProgress],
- [param:Function onError] )</h3>
- <p>
- [page:ArrayBuffer buffer] — 代表 Rhino `File3dm` 文档的 ArrayBuffer<br />
- [page:Function onLoad] — 加载成功完成后调用的函数。<br />
- [page:Function onError] — (可选)加载期间发生错误时调用的函数。该函数接收错误作为参数。<br />
- </p>
- <p>
- 解析 File3dm ArrayBuffer 并在得到 Object3d 后调用 `onLoad`。
- 请参阅 [link:https://github.com/mcneel/rhino-developer-samples/tree/7/rhino3dm/js/SampleParse3dmObjects this example]
- 以获取更多参考。
- </p>
- <code>
- import rhino3dm from 'https://cdn.jsdelivr.net/npm/rhino3dm@8.0.1'
- // Instantiate a loader
- const loader = new Rhino3dmLoader();
- // Specify path to a folder containing WASM/JS libraries or a CDN.
- loader.setLibraryPath( 'https://cdn.jsdelivr.net/npm/rhino3dm@8.0.1' );
- const rhino = await rhino3dm();
- console.log('Loaded rhino3dm.');
- // create Rhino Document and add a point to it
- const doc = new rhino.File3dm();
- const ptA = [0, 0, 0];
- const point = new rhino.Point( ptA );
- doc.objects().add( point, null );
- // create a copy of the doc.toByteArray data to get an ArrayBuffer
- const buffer = new Uint8Array( doc.toByteArray() ).buffer;
- loader.parse( buffer, function ( object ) {
- scene.add( object );
- } );
- </code>
- <h3>[method:this setLibraryPath]( [param:String value] )</h3>
- <p>
- [page:String value] — 包含 JS 和 WASM 库的文件夹的路径。
- </p>
- <code>
- // Instantiate a loader
- const loader = new Rhino3dmLoader();
- // Specify path to a folder containing the WASM/JS library:
- loader.setLibraryPath( '/path_to_library/rhino3dm/' );
- // or from a CDN:
- loader.setLibraryPath( 'https://cdn.jsdelivr.net/npm/rhino3dm@8.0.1' );
- </code>
- <h3>[method:this setWorkerLimit]( [param:Number workerLimit] )</h3>
- <p>
- [page:Number workerLimit] - 要分配的最大 worker 数量。默认值为 4。<br />
- </p>
- <p>
- 设置解码期间要使用的 [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers
- Web Workers] 的最大数量。如果 worker 还负责应用程序中的其他任务,则较低的限制可能更好。
- </p>
- <h3>[method:this dispose]()</h3>
- <p>
- 处理加载程序资源并释放内存。
- </p>
- <h2>源代码</h2>
- <p>
- [link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/loaders/3DMLoader.js examples/jsm/loaders/3DMLoader.js]
- </p>
- </body>
- </html>
|