# Ferrari 458 Italia — AvtoPoisk 3D garage asset

Real authored automotive model by **vicent091036**. This is a visual catalog demonstration vehicle; it is not a representation of a buyer’s selected Chevrolet, Daewoo, BYD, or other vehicle, and does not establish part compatibility.

## Attribution and provenance

- Original model: [Ferrari 458 Italia by vicent091036](https://sketchfab.com/models/57bf6cc56931426e87494f554df1dab6).
- License: [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/).
- The [official Three.js asset license audit](https://github.com/mrdoob/three.js/issues/23089) records `gltf/ferrari.glb` as CC-BY 4.0. The original Sketchfab URL no longer returns public model metadata; the retained attribution and license evidence are from the distributing project's own records.
- Creator credit is preserved in the [official Three.js r180 example](https://github.com/mrdoob/three.js/blob/r180/examples/webgl_materials_car.html).
- Downloaded from the pinned [Three.js r180 GLB](https://raw.githubusercontent.com/mrdoob/three.js/r180/examples/models/gltf/ferrari.glb) on 2026-11-18.
- Display credit in the garage: **Ferrari 458 Italia · vicent091036 · CC BY 4.0** with source and license links. Do not imply endorsement by Ferrari or the model author.
- `asset-info.json` records file sizes, SHA-256 hashes, sources, and geometry statistics.

## Runtime asset

Use **`/models/ferrari-458/ferrari-optimized.glb`**. It is self-contained and requires no external image files, Draco decoder, CDN request, Web Worker, or additional CSP permissions. Three.js GLTFLoader supports its `KHR_mesh_quantization` extension directly.

The runtime asset preserves every original triangle, position, node transform and material name. The preparation decodes Draco offline, removes unused UVs (the source has no image textures), packs normals to normalized signed 16-bit integers, and packs indices to unsigned 16-bit integers. Lighting and PBR material adjustments are applied by the application. The original `ferrari.glb` remains available for provenance and regeneration.

- Runtime file: 8,959,908 bytes (8.54 MiB), before HTTP compression.
- Source file: 1,681,572 bytes, Draco compressed.
- 337,834 decoded vertices; 358,788 triangles; 51 mesh primitives; zero texture images.
- Up axis: **+Y**. Car front: **−Z**. Car rear: **+Z**.
- Ground is already at Y ≈ 0; no car geometry needs procedural replacement.
- Bounds: approximately X ±1.129 m, Y 0…1.236 m, Z ±2.267 m.
- Dimensions: **2.257 × 1.236 × 4.534 m**.
- Suggested initial camera: `[4.25, 1.4, -4.5]`, targeting `[0, 0.5, 0]`.

`ferrari_ao.png` is the 39,350-byte baked ground-occlusion texture distributed alongside the original Three.js example. The application can instead calculate a contact shadow and need not request this file. `source-gltf-metadata.json` is the extracted source GLB JSON for inspection.

## Node mapping

| Component | Exact names / mapping |
| --- | --- |
| Body paint | `body` |
| Windows and light covers | `glass` (combined original mesh) |
| Front lights | `lights`, `leds` |
| Red/rear lights | `lights_red`, **`brakes`** |
| Rims | `rim_fl`, `rim_fr`, `rim_rl`, `rim_rr` |
| Complete wheels | `wheel_fl`, `wheel_fr`, `wheel_rl`, `wheel_rr` groups |
| Tires | `tire` children inside wheel groups (GLTFLoader disambiguates duplicates with suffixes) |
| Brake discs | `brake` children inside wheel groups (GLTFLoader disambiguates duplicates with suffixes) |
| Other details | `trim`, `chrome`, `metal`, `grills`, `plastic_gray`, `yellow_trim` |

**The top-level `brakes` mesh is the rear brake light, not the wheel brake discs.** Use parent groups and material names as well as mesh names for part picking. Mechanical engine/suspension detail is not individually modeled; those categories need labeled spatial hotspots and accessible category buttons, not invented replacement geometry.

Wheel centers (world-space meters):

| Wheel | X | Y | Z |
| --- | ---: | ---: | ---: |
| Front left | −0.843 | 0.358 | −1.155 |
| Front right | 0.829 | 0.361 | −1.154 |
| Rear left | −0.821 | 0.358 | 1.495 |
| Rear right | 0.824 | 0.358 | 1.496 |

## Replacing the model

Place a properly licensed, self-contained GLB in `public/models/<vehicle>/`, retain attribution and license evidence, then change the model URL and node-to-category mapping in the garage model configuration. Normalize its units, Y-up orientation, ground contact and front direction, and re-check all spatial hotspots and camera limits. Replacing only the URL is insufficient when node names or proportions differ. Keep the accessible catalog fallback available when the model or WebGL fails.
