# XWUI3DObject

Simple single-object 3D host - brand isometric cross, a gltf/glb/obj URL, or a
primitive mesh. Transparent canvas by default. Companion to `XWUI3DScene`.

## Render modes

| `renderMode` | Behavior |
|---|---|
| `live` (default) | Continuous WebGL / `requestAnimationFrame` loop (orbit, intro). |
| `snapshot` | Render once to a **transparent PNG**, show an `<img>`, pause the loop. Theme/style changes re-render **exactly one frame** and swap the image. |

Snapshot is the right choice for static chrome logos (nav/footer). Call
`recapture()` / `invalidateSnapshot()` to force a refresh.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Brand logo object
description: Isometric XWUI cross via preset logo (live WebGL).
```

```example
file: examples/FromUrl.ts
html: examples/FromUrl.html
title: Load from URL
description: Load any gltf/glb/obj via data.url (or data.source).
```

```example
file: examples/SnapshotMode.ts
html: examples/SnapshotMode.html
title: Snapshot (static PNG)
description: renderMode snapshot - one transparent PNG, no continuous WebGL loop.
```

```api
```