# 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

![](figures/obj.png)

## 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/static/" + obj_file,
            mtl="http://localhost:8012/static/" + 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](../examples/meshes/mesh_loading.md) - Multiple mesh loading methods