Usd-viewer NPM

usd-viewer

Experimental Web Component for rendering USDZ 3d format. Built on the experimental work and efforts of https://github.com/autodesk-forks/USD/tree/release

Instalation

npm install usd-viewer

Web Assembly Dependencies

Currently this depends on the SharedArrayBuffer so to enable in the browser the following response headers must be set:

"Cross-Origin-Embedder-Policy": "require-corp"
"Cross-Origin-Opener-Policy": "same-origin"

To load the Wasm dependencies in the browser copy them from the node_modules into your host env.

cpy node_modules/usd-viewer/wasm/**/* dist/wasm

To change the default path (./wasm) of the Wasm resources add the following meta tag to the document.

<meta name="usd-viewer:wasm" content="custom-path/wasm" />

Usage

<script type="module">
  import 'usd-viewer/include.js';
</script>

<usd-viewer src="./usd/perseverance.usdz" alt="Perseverance Mars Rover"></usd-viewer>

API

Property	Attribute	Type	Description
`src`	`src`	string	source path for usd/usdz file
`alt`	`alt`	string	alt descriptive text
`controls`	`conrols`	boolean	enable or disable model touch/mouse controls
`fileName`	`file-name`	boolean	enable or disable display of file name
`autoRotate`	`auto-rotate`	boolean	enable or disable auto rotation of model
`autoRotateSpeed`	`auto-rotate-speed`	number	adjust speed of rotations of model
`minDistance`	`min-distance`	number	minimum zoom distance of model
`maxDistance`	`max-distance`	number	maximum zoom distance of model
`zoom`	`zoom`	number	default zoom level of camera relative to model

Licensing

The Web Component of this project is MIT licensed, however refer to the following external dependencies and explicitly marked file headers. For additional license details see:

web components usd 3d model

lit three

@everything-registry/sub-chunk-3024

0.0.0

1 year ago