Loader →

USDLoader

A loader for the USDZ format.

USDZ files that use USDC internally are not yet supported, only USDA.

Code Example

const loader = new USDZLoader();
const model = await loader.loadAsync( 'saeukkang.usdz' );
scene.add( model );

Import

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

import { USDLoader } from 'three/addons/loaders/USDLoader.js';

Constructor

new USDLoader( manager : LoadingManager )

Constructs a new USDZ loader.

manager

The loading manager.

Methods

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

Starts loading from the given URL and passes the loaded USDZ 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( buffer : ArrayBuffer | string ) : Group

Parses the given USDZ data and returns the resulting group.

buffer

The raw USDZ data as an array buffer.
Overrides: Loader#parse
Returns: The parsed asset as a group.

Source

examples/jsm/loaders/USDLoader.js