# XWUIGameItemPreview3D

A square 3D item preview that renders into a canvas when a `modelUrl` is supplied (drawing an auto-rotating placeholder shape), or falls back to a CSS-spun `fallbackIcon` emoji/SVG when no model is available. The preview is `size` pixels (default 200) on a configurable `backgroundColor`, and `autoRotate` (default true) controls the spin for both the canvas and the fallback. Call `stopRotation()` to halt the animation, or `updateData({ modelUrl, fallbackIcon })` to swap what is shown.

## Basic Usage

Shows a rotating fallback item icon in a fixed-size preview box.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A 3D item preview box that auto-rotates a fallback icon when no model URL is set.
```

## Model Viewer

A larger canvas preview driven by a modelUrl, with a button that swaps the model live.

```example
file: examples/ModelViewer.ts
title: Model Viewer
description: A modelUrl-driven canvas preview on a tinted background; a button swaps the model via updateData().
```

## Static Trophy

A small, non-spinning preview that holds a trophy icon still as a showcase thumbnail.

```example
file: examples/StaticTrophy.ts
title: Static Trophy
description: autoRotate off holds the fallback icon still - a steady reward/achievement thumbnail.
```

```api
```