---

title: Rhino3dmLoader category: Addons layout: docs

Rhino3dmLoader

A loader for Rhinoceros 3D files and objects.

Rhinoceros is a 3D modeler used to create, edit, analyze, document, render, animate, and translate NURBS curves, surfaces, breps, extrusions, point clouds, as well as polygon meshes and SubD objects. rhino3dm.js is compiled to WebAssembly from the open source geometry library openNURBS. The loader currently uses rhino3dm.js 8.4.0.

Code Example

const loader = new Rhino3dmLoader();
loader.setLibraryPath( 'https://cdn.jsdelivr.net/npm/rhino3dm@8.0.1' );
const object = await loader.loadAsync( 'models/3dm/Rhino_Logo.3dm' );
scene.add( object );

Import

Rhino3dmLoader is an addon, and must be imported explicitly, see Installation#Addons.

import { Rhino3dmLoader } from 'three/addons/loaders/3DMLoader.js';

Constructor

new Rhino3dmLoader( manager : LoadingManager )

Constructs a new Rhino 3DM loader.

manager | The loading manager.
---|---

Methods

.debug()

Prints debug messages to the browser console.

.decodeObjects( buffer : ArrayBuffer, url : string ) : Promise.<Object3D>

Decodes the 3DM asset data with a Web Worker.

buffer | The raw 3DM asset data as an array buffer.
---|---
url | The asset URL.

Returns: A Promise that resolved with the decoded 3D object.

.dispose()

Frees internal resources. This method should be called when the loader is no longer required.

.load( url : string, onLoad : function, onProgress : onProgressCallback, onError : onErrorCallback )

Starts loading from the given URL and passes the loaded 3DM asset to the onLoad() callback.

url | The path/URL of the file to be loaded. This can also be a data URI.
---|---
onLoad | Executed when the loading process has been finished.
onProgress | Executed while the loading is in progress.
onError | Executed when errors occur.

Overrides: Loader#load

.parse( data : ArrayBuffer, onLoad : function, onError : onErrorCallback )

Parses the given 3DM data and passes the loaded 3DM asset to the onLoad() callback.

data | The raw 3DM asset data as an array buffer.
---|---
onLoad | Executed when the loading process has been finished.
onError | Executed when errors occur.

Overrides: Loader#parse

.setLibraryPath( path : string ) : Rhino3dmLoader

Path to a folder containing the JS and WASM libraries.

path | The library path to set.
---|---

Returns: A reference to this loader.

.setWorkerLimit( workerLimit : number ) : Rhino3dmLoader

Sets the maximum number of Web Workers to be used during decoding. A lower limit may be preferable if workers are also for other tasks in the application.

workerLimit | The worker limit.
---|---

Returns: A reference to this loader.

Source

examples/jsm/loaders/3DMLoader.js