Home

Awesome

PlayCanvas glTF Viewer

The PlayCanvas glTF scene viewer is blazingly fast and 100% compliant with the glTF 2.0 spec.

PlayCanvas Viewer

You can find a live version at:

https://playcanvas.com/model-viewer

Viewing Scenes

The viewer can load any glTF 2.0 scene. Embedded glTF and binary glTF (GLB) can be dragged directly into the 3D view. To load an unpacked glTF scene, drag its parent folder into the 3D view.

You can also drag and drop images into the 3D view to set a background. Options are:

Face 0Face 1Face 2Face 3Face 4Face 5
posxnegxposynegyposznegz
pxnxpynypznz
rightleftupdownfrontback
rightlefttopbottomforwardbackward
012345

Supported URL Parameters

Some URL query parameters are available to override certain aspects of the viewer:

ParameterDescriptionExample
load/assetUrlSpecify URL to a glTF scene to load?load=URL
cameraPositionOverride the initial camera position?cameraPosition=0,0,20

How to build

Ensure you have Node.js installed (v18.0+). Then, from a command prompt, run:

npm install
npm run build

This will invoke Rollup and output the built viewer to the dist folder. To invoke Rollup with the --watch flag (which rebuilds the viewer on saving any source file), do:

npm run watch

How to build with local PlayCanvas engine

You can set the npm build scripts to use local versions of the PlayCanvas engine & PlayCanvas extras builds by setting the following environment variables when launching the npm build scripts:

ENGINE_PATH=./path/to/engine npm run build

How to run

Run:

npm run serve

Open a browser and navigate to http://localhost:3000.

Development

Run:

npm run develop

Open a browser and navigate to http://localhost:3000.

N.B. To load local models run npx server --cors in the directory containing the model (disables CORS).