feat: Ultra-Skater im Kürkleid und Rig-Werkzeug

Zweiter Durchlauf für Geometrie und Outfit: Referenzbild per Tripo-Image-Edit
auf ein petrolfarbenes Kürkleid umgestellt (20 Credits), daraus ein
Ultra-Image→3D (geometry_quality=detailed, 50 Credits).

- v008: 59.488 Dreiecke, 1,7 m, 222 Control-/30 Deform-Bones, Glide
  unverändert per Rotations-Retargeting
- Lider, Ohren und Haaransatz deutlich besser als v007; Finger bleiben
  verschmolzen
- Manifest-Eintrag auf Version 2 (v008), Skater3D-Fallback und
  check_export.sh nachgezogen
- tools/blender/build_skater.py: Rig, Retarget und Export in einem Befehl,
  reproduziert die manuelle GLB byte-identisch
- Lizenz-Log um Bild-Edit und Ultra-Lauf ergänzt, Doku und AGENTS.md aktualisiert
This commit is contained in:
torsten 2026-11-12 06:04:47 +01:00
parent 9f115764d0
commit 135f4ce040
8 changed files with 434 additions and 26 deletions

View file

@ -184,7 +184,7 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
(`skater_figure_tripo*`) sowie `assets/models/*` aus, nehmen aber beide
Skater-GLB samt Quelltexturen mit
(`assets/external/characters/skater_figure_glide_v006*` und
`skater_figure_glide_v007*`). Fehlt die GLB auf einem frischen Checkout,
`skater_figure_glide_v008*`). Fehlt die GLB auf einem frischen Checkout,
baut `Skater3D` weiterhin den Platzhalter; `tools/check_export.sh` weist
darauf hin und prüft die Texturen im Build.
- Phase 1 bleibt unberührt: Der 2D-Code lädt keine 3D-Ressourcen.
@ -193,7 +193,7 @@ eine still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
| ID | Datei | Größe | Rig | Clips |
| :--- | :--- | ---: | :--- | :--- |
| `character.skater.figure_tripo_glide` | `skater_figure_glide_v007.glb` | 2,71 MB | 222 Control / 30 Deform, 4 Einflüsse | `Glide` (2-s-Loop) |
| `character.skater.figure_tripo_glide` | `skater_figure_glide_v008.glb` | 3,08 MB | 222 Control / 30 Deform, 4 Einflüsse | `Glide` (2-s-Loop) |
| `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) | – |
@ -201,24 +201,35 @@ Die 3D-Vorschau lädt `character.skater.figure_tripo_glide` über die
Manifest-ID. Fehlt sie, erscheint ein Platzhalter aus Kapsel und Kopf, damit
ein frischer Checkout und die Tests laufen.
### Tripo-Skater mit Glide (v007, aktiv)
### Tripo-Skater mit Glide (v008, aktiv)
`character.skater.figure_tripo_glide` ist die erste geriggte Fassung des
Tripo-Meshes und seit 2026-11-12 die Figur, die `Skater3D` lädt:
`character.skater.figure_tripo_glide` ist seit 2026-11-12 die Figur, die
`Skater3D` lädt. Version 2 (v008) entstand im Ultra-Modus und trägt ein
petrolfarbenes Kürkleid mit Pailletten statt des Trainingskleids:
- 59.350 Dreiecke, Textur v3.5, Höhe 1,7 m, Blickrichtung `+Z`, Pivot Füße.
- Tripo-Task `d8ee7a30-c1dc-4873-8770-4747d98a62ff` (Image→3D aus
`flux2pro_reference_front.png`, Modell v3.1, 60k-Face-Budget, 30 Credits,
über die Tripo-Pay-as-you-go-API statt fal).
- 59.488 Dreiecke, Textur v3.5, Höhe 1,7 m, Blickrichtung `+Z`, Pivot Füße.
- Referenzbild per Tripo-Image-Edit aus `flux2pro_reference_front.png`
erzeugt (Task `316752d8-16e7-49c8-beb1-d2223afc9f79`, 20 Credits).
- Mesh: `geometry_quality=detailed`, 60k-Face-Budget, Task
`834f0e29-65db-49d2-a02b-7a6239a4d07a`, 50 Credits.
- Rig lokal in Blender mit AutoRigPro: 222 Control-Bones, 30 Deform-Bones,
Bind `PSEUDO_VOXELS`, 4 Einflüsse pro Vertex.
- `Glide` per reinem Rotations-Retargeting von `skater_figure_glide_v006`
übernommen (2-s-Loop, 48 Frames bei 24 fps).
- Klingenabstand in der Vorschau: ±0,154 m (Konstante
`BLADE_LATERAL_OFFSET_M` in `skater_3d.gd`).
- Bekannte Schwächen: Lider ohne Augengeometrie, spitz zulaufende Ohren,
Finger als verschmolzene Blobs. Bei der Vorschau-Distanz unsichtbar, bei
Nahaufnahmen sichtbar.
- Bekannte Schwächen: Lider ohne Augengeometrie, Finger als verschmolzene
Blobs. Im Ultra-Modus sind Ohren und Gesichtsform deutlich besser, die
Finger bleiben aber ungetrennt.
Der komplette Weg vom Mesh zum geriggten Export ist als ein Befehl
reproduzierbar:
```bash
blender --python tools/blender/build_skater.py -- \
model.glb skater_figure_glide_v008.glb \
--source-rig rinkplanner/assets/external/characters/skater_figure_glide_v006.glb
```
Ablauf, Stolpersteine und Messwerte:
`docs/findings-2026-11-12-tripo-skater-rig.md`.
@ -238,7 +249,7 @@ angebunden und **nicht** in den Export-Presets enthalten:
- **Lizenz:** Erzeugt über fal (`tripo3d/h3.1/image-to-3d`); fal Support
hat am 2026-11-12 bestätigt, dass der Vertrag mit fal besteht und Tripos
Free-/Paid-User-AGB nicht greifen. Seit der Umstellung auf die
Tripo-Pay-as-you-go-API (siehe v007) gilt: kommerzielle Nutzung ist über
Tripo-Pay-as-you-go-API (siehe v008) gilt: kommerzielle Nutzung ist über
den bezahlten API-Zugang abgedeckt; fal erhebt keine Rechte an Outputs,
garantiert aber keine Originalität oder Nichtrechtsverletzung. Details in
`docs/findings-2026-11-11-ai-skater-model-comparison.md`. Aus den

View file

@ -114,3 +114,44 @@ neben den Schlittschuhen.
`~/Downloads/rinkplanner_skater_tripo_v002/`
(`arp_markers_v2.blend`, `arp_matched.blend`, `arp_bound.blend`,
`arp_glide.blend`, `glide_new_sheet.png`, `arp_ik_test.png`)
## Nachtrag: Ultra-Lauf mit Kürkleid (v008)
Zweiter Durchlauf am selben Tag, zwei Wünsche auf einmal: bessere Geometrie
und ein Kürkleid statt des Trainingsdresses.
**Referenzbild.** Statt neu zu text→image ging ein Image-Edit auf die
bestehende FLUX-Referenz (`chat_image_2.5_sunburst`, quality `high`, Größe
768×1024). Der Prompt hielt Gesicht, Pose, Bildausschnitt und Beleuchtung fest
und tauschte nur das Outfit: langärmliges Kürkleid, Paillettenverlauf von
Türkis nach Petrol, kurzer Rock, blickdichte Strumpfhose, dieselben weißen
Schlittschuhe. Task `316752d8-16e7-49c8-beb1-d2223afc9f79`, **20 Credits**.
Ergebnis war direkt brauchbar: gleiche Läuferin, gleiche Pose.
**Mesh.** `tripo_image_to_3d` mit `geometry_quality=detailed` (Ultra),
face_limit 60.000, Textur v3.5, Task
`834f0e29-65db-49d2-a02b-7a6239a4d07a`, **50 Credits**. Ergebnis: 59.488
Dreiecke, 1,70 m.
**Was Ultra gebracht hat:**
- Lider haben jetzt Form und eine Lidfalte – vorher eine glatte Fläche.
- Ohren sind normale Ohren, keine Elfenohren.
- Haaransatz und Dutt zeigen Strähnen statt einer Naht.
- Finger bleiben verschmolzene Blobs; die Trennung ist im Mesh angelegt,
aber nicht durchgezogen.
**Rig und Clip** liefen unverändert: gleiche Marker-Kalibrierung, gleiche
Erkennung, gleicher Bind (`PSEUDO_VOXELS`, 30 Deform-Bones), gleiches
Rotations-Retargeting. Der Klingenabstand bleibt bei ±0,154 m.
**Werkzeug.** Der Ablauf steckt jetzt in `tools/blender/build_skater.py`:
ein Aufruf riggt, retargetet und exportiert. Das Skript startet nach dem Bind
einen zweiten, headless Blender-Prozess für Retarget und Export, weil der
glTF-Importer in derselben Datei an der zweiten Armatur namens `rig`
scheitert (`KeyError: 'arm_stretch.l'`). Mit der Trennung ist der Lauf
deterministisch: das Werkzeug erzeugt byte-identisch dieselbe GLB wie der
manuelle Lauf.
**Kosten gesamt:** 30 Credits (v007) + 20 (Bild-Edit) + 50 (Ultra) = 100
Credits von 1.000; Rest 900.