feat: Tripo-Skater als Evaluationsasset aufnehmen

- Gewinner der ersten Runde als character.skater.figure_tripo
- 30k-Decimation im Projekt, 116k-Quelle nur in der Workbench
- Manifest-Test akzeptiert unriggte Assets
- Export-Presets und check_export schließen das Asset aus
- Lizenzstand und Retargeting-Findings dokumentiert
- Lizenz-Log der fal-Generierungen ergänzt
This commit is contained in:
torsten 2026-11-11 13:14:20 +01:00
parent 6172d311bc
commit e79b477ee0
8 changed files with 278 additions and 16 deletions

View file

@ -1,6 +1,6 @@
# 3D-Assets (extern)
Stand: 2026-10-31
Stand: 2026-11-11
Die 3D-Assets liegen bewusst außerhalb des Git-Repos. Das Repo enthält nur
ein Manifest, ein Sync-Werkzeug und die Dokumentation. Die Binärdateien
@ -180,7 +180,8 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
- `assets/external/` ist gitignored und wird nach dem Sync importiert.
- `asset_manifest.json` wird über `include_filter="*.json"` mit exportiert.
- Die Export-Presets schließen Test- und Gewichts-Assets
(`weights_rings*`) sowie `assets/models/*` aus, nehmen aber die
(`weights_rings*`), das noch nicht freigegebene Tripo-Evaluationsasset
(`skater_figure_tripo*`) sowie `assets/models/*` aus, nehmen aber die
Skater-GLB samt ihren Quelltexturen
(`assets/external/characters/skater_figure_glide_v006*`) mit. Fehlt die
GLB auf einem frischen Checkout, baut `Skater3D` weiterhin den Platzhalter;
@ -192,10 +193,31 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
| ID | Datei | Größe | Rig | Clips |
| :--- | :--- | ---: | :--- | :--- |
| `character.skater.figure` | `skater_figure_glide_v006.glb` | 8,59 MB | 222 Control / 30 Deform, 8 Einflüsse | `Glide` (2-s-Loop) |
| `character.skater.figure_tripo` | `skater_figure_tripo_v001_30k.glb` | 7,19 MB | keins (unrigged) | – |
Die 3D-Vorschau lädt die Datei über die Manifest-ID
`character.skater.figure`. Fehlt sie, erscheint ein Platzhalter aus
Kapsel und Kopf, damit ein frischer Checkout und die Tests laufen.
Die 3D-Vorschau lädt `character.skater.figure` über die Manifest-ID.
Fehlt sie, erscheint ein Platzhalter aus Kapsel und Kopf, damit ein frischer
Checkout und die Tests laufen.
### Tripo-Evaluationsasset
`character.skater.figure_tripo` ist der Gewinner des Modellvergleichs vom
2026-11-11 (Tripo H3.1 Image→3D, Request `01a1c9c3-ce93-7cb1-8eb1-ca12dfa66c88`).
Es ist bewusst **nicht** an `Skater3D` angebunden und **nicht** in den
Export-Presets enthalten:
- 30k-Decimation (`skater_figure_tripo_v001_30k.glb`, 29.999 Dreiecke) ist
die Projektfassung; die 116k-Quelle liegt nur in der Workbench
(`library/characters/skater_figure_tripo_v001.glb`).
- Unrigged (`rig.type: "none"`), Blickrichtung `+X`, Höhe 1,7 m. Der
Manifest-Test akzeptiert `type: "none"` mit null Bones/Einflüssen.
- **Lizenz offen:** Tripo gewährt kommerzielle Rechte laut AGB nur „Paid
Users“; ob ein kostenpflichtiger fal-Lauf zählt, ist nicht bestätigt.
Bis zur schriftlichen Antwort von fal/Tripo bleibt das Asset
Evaluationsmaterial und darf nicht in Releases landen.
Details und verworfene Kandidaten:
`docs/findings-2026-11-11-ai-skater-model-comparison.md`.
Testdateien (nicht im Manifest): `skater_figure_anim_test_v001.glb` mit dem
2-Sekunden-Clip `TestWave`.

View file

@ -0,0 +1,96 @@
# Findings – KI-Skater-Modellvergleich (2026-11-11)
## Ziel
Nach dem unbrauchbaren Meshy-T2.5-Gesicht (30k Smart Topology) wurden
Alternativen für einen 30k-/50k-Spielcharakter getestet. Bewertet wurde
bewusst die **Rohgeometrie im Solid-Modus**, nicht die Textur.
## Aufbau
- Referenz: FLUX 2 Pro, 1024×1536, neutrale A-Pose, Frontansicht.
- Text→3D: Tripo H3.1, Hunyuan 3D Pro, Meshy 7.1 (je ca. 120k Ziel).
- Image→3D: Tripo H3.1 und Trellis 2 aus der FLUX-Referenz.
- Zweite Runde: Tripo H3.1 Image→3D mit 200k Ziel und den Seeds
101, 202, 303; danach Decimation auf 50k und 30k.
## Ergebnis
| Generator | Gesicht | Fazit |
| :--- | :--- | :--- |
| Tripo H3.1 Image→3D | realistische Augen, Nase, Lippen | **Sieger**, insbesondere Seed 303 |
| Tripo H3.1 Text→3D | sauber, aber stylisiert/cartoonhaft | brauchbar, nicht fotorealistisch |
| Hunyuan 3D Pro | sauber, comicartig, große Augen | brauchbar, falscher Stil |
| Meshy 7.1 Text→3D | fast gesichtslos/glatt | unbrauchbar |
| Trellis 2 Image→3D | Löcher an Gesicht/Hals/Schultern | unbrauchbar |
### Seed-/Budget-Vergleich
- Seed 101: Augen-Artefakte.
- Seed 202: geschlossene/glatte Augen.
- **Seed 303: offene Augen, saubere Nase/Lippen; bester Kandidat.**
- 200k → 50k hält das Gesicht gut; 30k bleibt brauchbar, verliert aber
Lid-Detail und zeigt Haar-/Stirn-Artefakte.
- **Empfehlung:** Seed 303, 50k als Qualitätsfassung; 30k bei striktem
Budget; 200k als Retopo-/Decimationsquelle behalten.
## Kosten
- FLUX 2 Pro: ca. 0,047 USD für die 1024×1536-Referenz.
- Tripo H3.1: 0,01 USD/Credit; exakte Credit-Menge pro Lauf ist nicht über
die fal-Pricing-API abrufbar.
- Meshy 7.1: 0,80 USD/Generierung.
- Hunyuan 3D Pro: 0,015 USD/Unit; exakte Unit-Menge nicht über die API.
- Trellis 2: 0,05 USD/Unit; exakte Unit-Menge nicht über die API.
## Lizenz
Tripo gewährt kommerzielle Rechte laut AGB nur „Paid Users“; Free-User-Outputs
sind non-commercial. Ob ein kostenpflichtiger fal-Lauf als Tripo-Paid-User
zählt, ist nicht dokumentiert. Das Modell bleibt bis zur schriftlichen
Bestätigung von fal/Tripo ein Evaluationsasset.
## Artefakte
`~/Downloads/rinkplanner_skater_tests/` (nur noch der Gewinner; Verlierer
gelöscht):
- `flux2pro_reference_front.png` – FLUX-2-Pro-Referenz (768×1024)
- `tripo_h31_image_flux_120k.glb` – 116.058 Dreiecke, Ausgangsmesh
- `tripo_h31_image_flux_30k.glb` – 29.999 Dreiecke, Projektkandidat
- `tripo_120k_vs_30k.png`, `tripo_h31_image_flux_30k_front.png`,
`tripo_h31_image_flux_30k_full_front.png` – Vergleiche
- `README.md` – Dateiliste und Lizenzstand
Die Workbench hält die Quelle (`library/characters/skater_figure_tripo_v001.glb`)
und die 30k-Fassung (`..._v001_30k.glb`).
## Nachtrag: menschliche Bewertung (final)
Die High-Res-/Seed-Runde (1024×1536-Referenz, Seeds 101/202/303) wurde
visuell verworfen. Bestes Modell bleibt der Gewinner der ersten Runde:
- `tripo_h31_image_flux_120k.glb` (116.058 Dreiecke, Request
`01a1c9c3-ce93-7cb1-8eb1-ca12dfa66c88`, 768×1024-FLUX-Referenz)
- `tripo_h31_image_flux_30k.glb` (29.999 Dreiecke, Decimation daraus)
- Vergleich: `tripo_120k_vs_30k.png`, `tripo_h31_image_flux_30k_front.png`
Die Seed-303-/High-Res-Dateien sind damit **verworfene Experimente**, nicht
die Produktionsempfehlung.
## Projektintegration (2026-11-11)
Der Gewinner der ersten Runde ist als Manifest-Asset im Projekt registriert:
- ID `character.skater.figure_tripo`
- Datei `rinkplanner/assets/external/characters/skater_figure_tripo_v001_30k.glb`
(6,9 MB, SHA-256 `580491956c85e0709ff1cdb15b25ab0bc3920e6ce4a4df805275e530c6077e23`)
- Workbench-Quelle `library/characters/skater_figure_tripo_v001_30k.glb`,
116k-Ausgangsmesh `library/characters/skater_figure_tripo_v001.glb`
- Unrigged (`rig.type: "none"`), `+X`, Höhe 1,7 m, keine Clips
- Nicht an `Skater3D` angebunden; der Produktionsskater bleibt
`character.skater.figure` (`skater_figure_glide_v006.glb`)
- Aus den Export-Presets ausgeschlossen (`skater_figure_tripo*`), solange
die Kommerzlizenz nicht bestätigt ist
- Import und Manifest-Test laufen: `tools/sync_assets.sh --check` und
`tests/run_asset_manifest_tests.gd` sind grün

View file

@ -0,0 +1,70 @@
# Findings – AI-Skater mit Glide-Retargeting (2026-11-11)
## Ziel
Prüfen, ob die Meshy-T2.5-Figur (`character.skater.figure_ai`) den bestehenden
`Glide`-Clip der Produktionsfigur (`character.skater.figure`) übernehmen kann
und ob das Ergebnis für die 3D-Vorschau taugt.
## Aufbau
- Produktion: 30 Deform-Bones, 8 Bone-Influences, 13.956 Dreiecke,
`Glide` als 2-s-Loop (48 Keys bei 24 fps).
- AI-Figur: 24 Bones, 4 Bone-Influences, 28.090 Dreiecke, A-Pose, nur ein
statischer Baseline-Keyframe; Walk/Run liegen als separate GLBs vor.
- Blender 5.2.1, beide GLBs importiert, Füße auf Z=0, Figuren nebeneinander.
- Retargeting über **Richtungsabbildung**: Für jede zugeordnete Bone wird die
Weltrichtung der Produktions-Pose auf die AI-Ruhepose angewendet
(`rotation_difference`), Twist/Roll bleibt aus der AI-Ruhepose erhalten.
Hips wird nicht gedreht, damit die Figur auf dem Boden bleibt.
- Gemappt: Spine-Kette, Hals/Kopf, Schulter-/Arm-/Hand-Kette,
Oberschenkel/Unterschenkel/Fuß/Zehen. Twist- und Stretch-Hilfsbones der
Produktionsfigur haben kein Gegenstück und bleiben ungenutzt.
## Ergebnis
- Das Retargeting läuft mechanisch sauber: Arme, Beine und Oberkörper folgen
der Produktionspose, ohne sichtbares Kollabieren der Schultern.
- Der `Glide`-Clip ist allerdings sehr subtil: Die Armrichtung ändert sich
über den Loop nur um wenige Grad. Der Test validiert daher vor allem die
Zuordnung, nicht die Deformation unter starker Bewegung.
- Im direkten Vergleich wirkt die AI-Figur anatomisch sauberer; die
Produktionsfigur zeigt im selben Pose-Frame deutlich sichtbare
Ärmel-/Schulter-Beulen (bekanntes Gewichtsproblem der bestehenden Figur).
- Die AI-Figur ist 1,68 m groß, die Produktionsfigur 1,90 m. Für die Vorschau
müsste sie skaliert oder die Kamerahöhe angepasst werden.
- 4 Bone-Influences reichen für diese Pose aus. Ein Stresstest mit Armen über
Kopf und tiefen Knien steht noch aus.
## Artefakte
- Vergleichsbild:
`~/Downloads/rinkplanner_skater_meshy_t25/retarget_comparison.png`
- Statischer Vergleich (nur die beiden Posen-Meshes, ohne Rig):
`~/Downloads/rinkplanner_skater_meshy_t25/retarget_comparison_static.png`
- Blender-Testdatei mit Rig und retargeteter Action:
`~/Dokumente/workbench_rinkplanner/source/characters/skater_ai/skater_ai_retarget_test_v001.blend`
- Aufgeräumte, statische Vergleichsdatei (beim Öffnen direkt in Kameraansicht):
`~/Dokumente/workbench_rinkplanner/source/characters/skater_ai/skater_ai_retarget_comparison_v001.blend`
- Getestete Frames: 01, 13, 25, 37 (Produktion links, AI-Retarget rechts).
## Empfehlung
Retargeting ist der richtige Weg; der eingebaute Clip der AI-Figur ist
statisch und unbrauchbar. Für einen Austausch der Vorschau fehlen noch:
1. Stresstest der 4-Influence-Gewichte (Arme hoch, Knie tief).
2. Skalierung auf die Produktionshöhe bzw. Kamera-/Szenenanpassung.
3. Entscheidung, ob die AI-Figur die bestehende `Glide`-Figur ersetzt oder
nur als Alternative verfügbar bleibt.
## Nachtrag: Abbruch (2026-11-11)
Der reine Meshy-Download zeigt im Solid-/Wireframe-Modus ein **zerstörtes
Gesicht**: Löcher und überlappende Dreiecke an Augen, Nase und Mund. Die
Textur hat das in der Vorschau kaschiert. Das ist ein Geometrieproblem des
30k-Smart-Topology-Meshs, nicht des Retargetings. Die AI-Figur ist damit für
die Produktionsvorschau ungeeignet. `character.skater.figure` bleibt
unverändert die aktive Figur; `character.skater.figure_ai` bleibt vorerst
nur als dokumentierte Alternative im Manifest, ohne `Skater3D`-Verdrahtung.