Add male toddler character model in GLB format
All checks were successful
Deploy to production / deploy (push) Successful in 3m27s
All checks were successful
Deploy to production / deploy (push) Successful in 3m27s
This commit is contained in:
89
frontend/public/models/3d/falukant/characters/README.md
Executable file → Normal file
89
frontend/public/models/3d/falukant/characters/README.md
Executable file → Normal file
@@ -1,87 +1,16 @@
|
||||
# 3D-Charakter-Modelle
|
||||
# Falukant 3D Web Models
|
||||
|
||||
## Verzeichnisstruktur
|
||||
Dieses Verzeichnis enthaelt nur die ausgelieferten, optimierten Web-Modelle.
|
||||
|
||||
Dieses Verzeichnis enthält die 3D-Modelle für Falukant-Charaktere.
|
||||
- Dateien in diesem Ordner werden vom Frontend und vom Backend-Proxy ausgeliefert.
|
||||
- Sie werden aus `frontend/models-src/3d/falukant/characters/` erzeugt.
|
||||
- Quelldateien gehoeren nicht hierher.
|
||||
|
||||
## Dateinamen-Konvention
|
||||
|
||||
### Basis-Modelle (Fallback)
|
||||
- `male.glb` - Basis-Modell männlich
|
||||
- `female.glb` - Basis-Modell weiblich
|
||||
|
||||
### Altersspezifische Modelle
|
||||
|
||||
#### Altersbereich-Modelle (Fallback für Altersgruppen)
|
||||
- `male_toddler.glb` - Männlich, Kleinkind (0-3 Jahre)
|
||||
- `male_child.glb` - Männlich, Kind (4-7 Jahre)
|
||||
- `male_preteen.glb` - Männlich, Vor-Teenager (8-12 Jahre)
|
||||
- `male_teen.glb` - Männlich, Teenager (13-17 Jahre)
|
||||
- `male_adult.glb` - Männlich, Erwachsen (18+ Jahre)
|
||||
- `female_toddler.glb` - Weiblich, Kleinkind (0-3 Jahre)
|
||||
- `female_child.glb` - Weiblich, Kind (4-7 Jahre)
|
||||
- `female_preteen.glb` - Weiblich, Vor-Teenager (8-12 Jahre)
|
||||
- `female_teen.glb` - Weiblich, Teenager (13-17 Jahre)
|
||||
- `female_adult.glb` - Weiblich, Erwachsen (18+ Jahre)
|
||||
|
||||
#### Genaue Alters-Modelle (optional, für spezifische Altersstufen)
|
||||
- `male_1y.glb`, `male_2y.glb`, `male_3y.glb`, etc. - Männlich, genaues Alter in Jahren
|
||||
- `female_1y.glb`, `female_2y.glb`, `female_5y.glb`, etc. - Weiblich, genaues Alter in Jahren
|
||||
|
||||
**Hinweis:** Genaue Alters-Modelle haben Vorrang vor Altersbereich-Modellen. Wenn z.B. für Alter 1 sowohl `female_1y.glb` als auch `female_toddler.glb` existieren, wird `female_1y.glb` verwendet.
|
||||
|
||||
## Fallback-Verhalten
|
||||
|
||||
Die Komponente verwendet eine dreistufige Fallback-Hierarchie:
|
||||
|
||||
1. **Genaues Alter:** Zuerst wird nach einem Modell für das genaue Alter gesucht (z.B. `female_1y.glb` für Alter 1)
|
||||
2. **Altersbereich:** Falls kein genaues Alters-Modell existiert, wird das Altersbereich-Modell verwendet (z.B. `female_toddler.glb` für Alter 1-3)
|
||||
3. **Basis-Modell:** Falls auch kein Altersbereich-Modell existiert, wird das Basis-Modell verwendet (`male.glb` / `female.glb`)
|
||||
|
||||
## Dateigröße
|
||||
|
||||
- **Aktuell:** ~14–17 MB pro Modell → lange Ladezeiten
|
||||
- **Empfohlen:** < 500 KB pro Modell
|
||||
- **Maximal:** ~1–2 MB pro Modell (Web, 60 FPS)
|
||||
|
||||
## Optimierung (wichtig für kürzere Ladezeiten)
|
||||
|
||||
### Option A: gltf-transform (CLI, Draco + Textur-Optimierung)
|
||||
Erzeugung:
|
||||
|
||||
```bash
|
||||
npm install -g @gltf-transform/cli
|
||||
# Pro Modell (Beispiel):
|
||||
gltf-transform optimize male_adult.glb male_adult_opt.glb --compress draco --texture-size 1024
|
||||
cd frontend
|
||||
npm run optimize-models
|
||||
```
|
||||
|
||||
Danach optimierte Dateien z. B. als `*_opt.glb` ablegen und im Frontend verwenden.
|
||||
**Hinweis:** Bei Draco-Compression muss im Frontend `DRACOLoader` von Three.js genutzt werden (siehe Three.js-Doku zu `KHR_draco_mesh_compression`).
|
||||
|
||||
### Option B: Blender
|
||||
|
||||
1. Modell in Blender öffnen
|
||||
2. Decimate-Modifier anwenden (Polygonanzahl reduzieren)
|
||||
3. Texturen komprimieren (WebP, max. 1024×1024)
|
||||
4. GLB-Export mit aktivierter Kompression
|
||||
5. Optional: Online-Tools (z. B. [glb.babylonpress.org](https://glb.babylonpress.org)) für Draco-Kompression
|
||||
|
||||
### Option C: Nur Texturen verkleinern (ohne Draco)
|
||||
|
||||
Ohne Draco-Extension reicht oft schon:
|
||||
|
||||
```bash
|
||||
gltf-transform optimize input.glb output.glb --texture-size 1024
|
||||
```
|
||||
|
||||
## Model-Proxy (Backend)
|
||||
|
||||
Das Frontend lädt Modelle über **`GET /api/models/3d/falukant/characters/:filename`**. Ein Backend-Proxy:
|
||||
|
||||
1. Liest die angeforderte `.glb`-Datei aus diesem Verzeichnis.
|
||||
2. Optimiert sie bei Bedarf mit gltf-transform (Draco + Textur 1024).
|
||||
3. Legt das Ergebnis in `backend/data/model-cache/` ab (File-Cache).
|
||||
4. Liefert die optimierte Datei aus und setzt `Cache-Control` für Browser-Caching.
|
||||
|
||||
- **Service:** `backend/services/modelsProxyService.js`
|
||||
- **Router:** `backend/routers/modelsProxyRouter.js`
|
||||
- **Cache:** `backend/data/model-cache/` (wird bei neuerer Quelldatei automatisch neu erzeugt)
|
||||
Das Frontend laedt nur `*_opt.glb`.
|
||||
|
||||
Reference in New Issue
Block a user