Obj

The Obj component loads and displays OBJ (Wavefront) 3D model files. This is ideal for:

Loading static 3D models from files
Displaying pre-made assets
Loading textured models with MTL files
Importing models from 3D modeling software

Basic Usage

A minimal example that loads an OBJ file from a URL:

python

import os
from vuer import Vuer
from vuer.schemas import DefaultScene, Obj, OrbitControls

app = Vuer(static_root=os.getcwd() + "/../../../assets")
obj_file = "pointclouds/male02/male02.obj"
mtl_file = "pointclouds/male02/male02.mtl"

@app.spawn(start=True)
async def main(sess):
    sess.set @ DefaultScene(
        Obj(
            key="model",
            src="http://localhost:8012/workspace/" + obj_file,
            mtl="http://localhost:8012/workspace/" + mtl_file,
            position=[0, 0, 0],
            scale=0.01,
        ),
        bgChildren=[
            OrbitControls(key="OrbitControls")
        ],
    )

    await sess.forever()

Key Parameters

Parameter	Type	Default	Description
`key`	str	-	Unique identifier for the model
`src`	str	-	URL to the OBJ file
`buff`	bytes	-	Binary OBJ data (alternative to src)
`text`	str	-	OBJ file content as string (alternative to src)
`mtl`	str	`[0,0,0]`	The source of the mtl file. Can be a url or a local file.
`materials`	list[string]	`[0,0,0]`	A list of materials to be used for the obj file.

Learn More

For detailed examples of using Obj, see:

Loading 3D Meshes - Multiple mesh loading methods