feat: externe 3D-Assets, AutoRigPro-Rig und Asset-Sync
- Asset-Manifest mit Hash, Platzierung und Rig-Metadaten - tools/sync_assets.sh prueft Quelle und Ziel und kopiert aus dem Workbench-Archiv nach assets/external (gitignored) - Skater mit AutoRigPro geriggt: 226 Control-, 30 Deform-Bones - glTF-Export inkl. gebackenem Testclip, Godot-Import verifiziert - Manifest-Test mit 48 Assertions (1123 gesamt) - Phase-1-Exporte schliessen assets/external aus - Doku, Roadmap und Findings aktualisiert
This commit is contained in:
parent
05dee8da2b
commit
8861cbae92
16 changed files with 949 additions and 8 deletions
|
|
@ -3,8 +3,8 @@
|
|||
Stand: 2026-10-31
|
||||
Grundlage: `rinkplanner/rinkplanner_definition_agent_guidelines.md`
|
||||
Übergeordnete Reihenfolge: `docs/roadmap.md`
|
||||
Letzte Session: `docs/findings-2026-10-31-sprungkombinationen.md`
|
||||
(Session davor: `docs/findings-2026-10-31-adult-2026-27.md`)
|
||||
Letzte Session: `docs/findings-2026-10-31-arp-rig.md`
|
||||
(Session davor: `docs/findings-2026-10-31-sprungkombinationen.md`)
|
||||
|
||||
## 1. Leitentscheidung
|
||||
|
||||
|
|
@ -30,6 +30,8 @@ wird nicht weiterentwickelt. Phase 2 konsumiert später dasselbe Datenmodell
|
|||
│ └── whiteboard/ # Phase 1: view / ctrl / io
|
||||
├── scenes/ # dünne Szenen, die Views zusammensetzen
|
||||
├── assets/
|
||||
│ ├── asset_manifest.json # externe 3D-Assets (Metadaten)
|
||||
│ └── external/ # synchronisiert, gitignored
|
||||
├── tests/ # headless GDScript-Tests
|
||||
└── prototype/3d_test/ # alter 3D-Test, eingefroren
|
||||
```
|
||||
|
|
@ -170,6 +172,17 @@ Text erhalten. Sprungfolgen verlangen einen Axel als zweiten oder dritten
|
|||
Sprung. Der Export verwendet die zusammengesetzte Caption (`3Lz+2T`,
|
||||
`3Lz+2A+SEQ`).
|
||||
|
||||
**D13 – 3D-Assets liegen extern, das Repo hält nur das Manifest.**
|
||||
Die Binärdateien (GLB, `.blend`, Texturen) liegen im Workbench-Archiv unter
|
||||
`~/Documents/workbench_rinkplanner`, nicht im Git-Repo. Das Repo enthält
|
||||
`assets/asset_manifest.json` mit ID, Quell-/Zielpfad, SHA-256, Größe,
|
||||
Platzierungsdaten und Rig-Metadaten. `tools/sync_assets.sh` prüft beide
|
||||
Seiten gegen den Hash, kopiert nach `assets/external/` (gitignored) und stößt
|
||||
den Godot-Import an. Damit bleiben Checkout und Build klein, während die
|
||||
Arbeitsdateien versioniert und reproduzierbar bleiben. Phase 1 lädt keine
|
||||
3D-Ressourcen; die Pipeline ist Vorbereitung für Phase 2. Details:
|
||||
`docs/assets.md`.
|
||||
|
||||
## 4. View- und Controller-Grenzen
|
||||
|
||||
- **View** (`Node2D`/`Control`) liest das Modell und zeichnet. Sie verändert
|
||||
|
|
@ -439,6 +452,9 @@ Aktueller Stand:
|
|||
PASV/EPSV/MDTM-Parsing, Sync-Stand und die Einstellungs-Verdrahtung.
|
||||
Der FTP-Client wurde zusätzlich gegen den echten Zielserver geprüft
|
||||
(Upload, Download, Übernahme, Konflikt, Aufräumen).
|
||||
- **3D-Assets:** 48 Assertions für Manifest-Schema, Pfade, Platzierung,
|
||||
Rig-Metadaten, Hashes und – falls synchronisiert – Größe und SHA-256 der
|
||||
GLB-Datei.
|
||||
|
||||
Autosave/Restore wird zusätzlich in einem isolierten `XDG_DATA_HOME`
|
||||
end-to-end geprüft.
|
||||
|
|
|
|||
160
docs/assets.md
Normal file
160
docs/assets.md
Normal file
|
|
@ -0,0 +1,160 @@
|
|||
# 3D-Assets (extern)
|
||||
|
||||
Stand: 2026-10-31
|
||||
|
||||
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
|
||||
bleiben im Workbench-Archiv.
|
||||
|
||||
## Verzeichnisse
|
||||
|
||||
```
|
||||
/home/torsten/Documents/workbench_rinkplanner/
|
||||
├── inbox/ # Eingang, unverändert lassen
|
||||
├── library/ # kuratiert, vom Manifest referenziert
|
||||
│ └── characters/
|
||||
├── source/ # .blend, Rig, Rohdaten
|
||||
│ └── characters/skater/
|
||||
└── archive/ # alte Stände, Videos, Bilder
|
||||
```
|
||||
|
||||
```
|
||||
rinkplanner/
|
||||
├── assets/
|
||||
│ ├── asset_manifest.json # versioniert
|
||||
│ └── external/ # gitignored, per Sync befüllt
|
||||
└── tests/run_asset_manifest_tests.gd
|
||||
tools/sync_assets.sh
|
||||
```
|
||||
|
||||
`assets/external/` wird nie committet. Ein frischer Checkout braucht einmal
|
||||
`./tools/sync_assets.sh --sync`, sonst fehlen die 3D-Dateien.
|
||||
|
||||
## Workflow
|
||||
|
||||
1. Neue Datei in `inbox/` ablegen.
|
||||
2. Prüfen, bei Bedarf konvertieren und als versionierte Datei nach
|
||||
`library/` legen (`..._v001.glb`, `..._v002.glb`).
|
||||
3. Die bearbeitbare Quelle (`.blend`, Rig, Referenzvideo) nach `source/`.
|
||||
4. Eintrag in `rinkplanner/assets/asset_manifest.json` ergänzen:
|
||||
ID, Quelle, Ziel, SHA-256, Größe, Platzierung, Rig, Animationen.
|
||||
5. `./tools/sync_assets.sh --sync` kopiert und importiert.
|
||||
6. Vor dem Commit `./tools/sync_assets.sh --check` laufen lassen.
|
||||
|
||||
### Befehle
|
||||
|
||||
```bash
|
||||
./tools/sync_assets.sh --check # Standard: nur prüfen
|
||||
./tools/sync_assets.sh --sync # fehlende Dateien kopieren + Godot-Import
|
||||
./tools/sync_assets.sh --sync --force # abweichendes Ziel überschreiben
|
||||
```
|
||||
|
||||
Umgebungsvariablen:
|
||||
|
||||
| Variable | Standard | Zweck |
|
||||
| :--- | :--- | :--- |
|
||||
| `RINKPLANNER_WORKBENCH` | `~/Documents/workbench_rinkplanner` | Archivpfad |
|
||||
| `GODOT` | `/opt/godot/Godot_v4.7.2-stable_linux.x86_64` | Import-Binary |
|
||||
|
||||
Das Skript prüft **Quelle und Ziel** gegen den Hash aus dem Manifest. Eine
|
||||
still veränderte Workbench-Datei wird nicht kopiert, sondern gemeldet.
|
||||
|
||||
## Manifest
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "character.skater.figure",
|
||||
"version": 2,
|
||||
"kind": "character",
|
||||
"format": "glb",
|
||||
"source": "library/characters/skater_figure_rigged_deform_v002.glb",
|
||||
"target": "assets/external/characters/skater_figure_rigged_deform_v002.glb",
|
||||
"sha256": "1c1f0646…",
|
||||
"bytes": 8345424,
|
||||
"source_scene": "source/characters/skater/skater_rig_v002.blend",
|
||||
"placement": {
|
||||
"up_axis": "Y",
|
||||
"facing": "+Z",
|
||||
"pivot": "feet",
|
||||
"height_m": 1.898,
|
||||
"ground_offset_m": 0.0
|
||||
},
|
||||
"rig": {
|
||||
"type": "humanoid",
|
||||
"control_bones": 226,
|
||||
"deform_bones": 30,
|
||||
"bind": "PSEUDO_VOXELS"
|
||||
},
|
||||
"animations": []
|
||||
}
|
||||
```
|
||||
|
||||
| Feld | Bedeutung |
|
||||
| :--- | :--- |
|
||||
| `id` | stabile Kennung; Code und Szenen referenzieren die ID, nicht den Dateinamen |
|
||||
| `version` | Zähler der kuratierten Fassung |
|
||||
| `source` | Pfad relativ zum Workbench-Archiv |
|
||||
| `target` | Pfad relativ zum Godot-Projekt, immer unter `assets/external/` |
|
||||
| `sha256` / `bytes` | Integritätsprüfung |
|
||||
| `source_scene` | bearbeitbare Quelle (`.blend`) für Rig/Animation |
|
||||
| `placement` | Up-Achse, Blickrichtung, Pivot und Höhe für die 3D-Szene |
|
||||
| `rig` | Control-/Deform-Bones und Bind-Verfahren |
|
||||
| `animations` | Liste der exportierten Clipnamen |
|
||||
|
||||
## Versionierung
|
||||
|
||||
- Dateinamen tragen `_vNNN`; vorhandene Versionen werden nicht überschrieben.
|
||||
- Eine neue Fassung ist eine neue Datei plus neuer Manifest-Eintrag bzw.
|
||||
aktualisierte `version` und `sha256`.
|
||||
- Alte Versionen bleiben in `library/` und im Archiv nachvollziehbar.
|
||||
- Nicht parsebare oder verworfene Experimente gehören nicht ins Manifest.
|
||||
|
||||
## Godot und Export
|
||||
|
||||
- `assets/external/` ist gitignored und wird nach dem Sync importiert.
|
||||
- `asset_manifest.json` wird über `include_filter="*.json"` mit exportiert.
|
||||
- Die aktuellen Phase-1-Export-Presets schließen `assets/external/*` aus.
|
||||
Für einen 3D-Build muss bewusst ein eigenes Preset die Dateien einschließen.
|
||||
Desktop kann die GLB einbetten; für Android sind 1K-Texturen oder ein
|
||||
separater Asset-Pack vorgesehen.
|
||||
- Phase 1 bleibt unberührt: Der 2D-Code lädt keine 3D-Ressourcen.
|
||||
|
||||
## Aktueller Bestand
|
||||
|
||||
| ID | Datei | Größe | Rig | Clips |
|
||||
| :--- | :--- | ---: | :--- | :--- |
|
||||
| `character.skater.figure` | `skater_figure_rigged_deform_v002.glb` | 8,35 MB | 226 Control / 30 Deform | keine (Produktion) |
|
||||
|
||||
Testdateien (nicht im Manifest): `skater_figure_anim_test_v001.glb` mit dem
|
||||
2-Sekunden-Clip `TestWave`.
|
||||
|
||||
## Rig-Pipeline (AutoRigPro)
|
||||
|
||||
1. GLB in Blender importieren, Füße auf Z=0, Transform anwenden.
|
||||
2. ARP Smart Rig: Marker für Neck, Chin, Shoulder, Hand, Root, Foot setzen.
|
||||
3. `PSEUDO_VOXELS` als Bind-Engine; das Mesh hat 37 Inseln und offene Kanten,
|
||||
Heat-Map-Weighting ist dafür ungeeignet.
|
||||
4. **`Match to Rig` ist Pflicht:** Erst danach sitzen Knie, Füße und Arme
|
||||
exakt auf dem Mesh. Der erste Auto-Rig-Lauf hatte die Füße bei x = 0,24
|
||||
statt 0,10.
|
||||
5. Animationen auf dem Control-Rig erstellen (IK/FK, Fußrollen, Root Motion).
|
||||
6. Export mit `export_def_bones=True`; der Exporter backt Constraints
|
||||
automatisch. Im GLB landen nur die 30 Deform-Bones.
|
||||
7. Ergebnis in Godot prüfen (`tests/manual/inspect_rig.gd`,
|
||||
`tests/manual/capture_rig.gd`).
|
||||
|
||||
Details und Messwerte: `docs/findings-2026-10-31-arp-rig.md`.
|
||||
|
||||
## Backup und Lizenz
|
||||
|
||||
- Das Workbench-Archiv liegt außerhalb des Repos und wird **nicht** vom
|
||||
Git-Remote gesichert. `library/` und `source/` separat sichern
|
||||
(restic/rsync).
|
||||
- Die Skaterin ist ein eigenes GenAI-Asset; das Rig wurde mit AutoRigPro
|
||||
erstellt. Vor einer Veröffentlichung die Lizenz der Basistexturen prüfen.
|
||||
|
||||
## Tests
|
||||
|
||||
`tests/run_asset_manifest_tests.gd` prüft Schema, Pfade, Hashes und – falls
|
||||
synchronisiert – Größe und SHA-256 der Zieldatei. Fehlt das Asset (z. B. in
|
||||
CI), wird der Dateicheck übersprungen, der Schema-Test bleibt aktiv.
|
||||
120
docs/findings-2026-10-31-arp-rig.md
Normal file
120
docs/findings-2026-10-31-arp-rig.md
Normal file
|
|
@ -0,0 +1,120 @@
|
|||
# Findings 2026-10-31 – AutoRigPro, Skater-Rig und Asset-Pipeline
|
||||
|
||||
## Ziel
|
||||
|
||||
Prüfen, ob sich die GenAI-Skaterin mit AutoRigPro in Blender 5.2 riggen
|
||||
lässt, ob der Export nach Godot trägt und wie die externen Assets
|
||||
reproduzierbar ins Projekt kommen.
|
||||
|
||||
## Ausgangsdatei
|
||||
|
||||
`workbench_rinkplanner/inbox/figure_skater_blades_aligned.glb`
|
||||
|
||||
| Eigenschaft | Wert |
|
||||
| :--- | :--- |
|
||||
| Mesh | 8.188 Vertices, 13.956 Dreiecke, 1 Objekt |
|
||||
| Topologie | 37 zusammenhängende Inseln, 2.346 offene/Non-Manifold-Kanten |
|
||||
| Texturen | 3 × 2048² PNG (BaseColor, Normal, MetallicRoughness) |
|
||||
| Maße | 1,66 × 0,35 × 1,90 m, Füße bei Z = 0 |
|
||||
| Ausrichtung | T-Pose, Blick +Z, Pivot Körpermitte |
|
||||
| Animation | keine, kein Skelett |
|
||||
|
||||
## AutoRigPro
|
||||
|
||||
- ARP liegt als Blender-5.2-Extension unter
|
||||
`~/.config/blender/5.2/extensions/superhivemarket_com/`.
|
||||
- Die AI-Marker-Dateien fehlen (`~/Documents/AutoRigPro/AI` existiert nicht).
|
||||
Die Marker wurden deshalb skriptbasiert gesetzt:
|
||||
Neck, Chin, Head Tip, Root, Thigh, Knee, Foot, Shoulder, Elbow, Hand,
|
||||
Hand Tip.
|
||||
- Smart Rig mit `arp_smart_sym = True`, Finger aus, Bind-Engine
|
||||
`PSEUDO_VOXELS`.
|
||||
- Ergebnis: 226-Bone-Control-Rig, 33 Deform-Bones, Bindung in 1,3 s.
|
||||
|
||||
### Befund: erste Platzierung war falsch
|
||||
|
||||
Der erste Lauf setzte die Beinkette zu weit außen:
|
||||
|
||||
| Knochen | erster Lauf | korrekt |
|
||||
| :--- | ---: | ---: |
|
||||
| Fuß x | 0,24 | 0,10 |
|
||||
| Knie x | 0,17 | 0,095 |
|
||||
| Hand z | 1,17 | 1,50 |
|
||||
|
||||
Die Reference-Bones waren bereits korrekt; nur die Deform-/IK-Kette wich ab.
|
||||
**`arp.match_to_rig` („Match to Rig")** baut die Deform-Kette aus den
|
||||
Reference-Bones neu, aktualisiert die Gewichte und setzt die Armature-Scale
|
||||
auf 1,0. Danach sitzen Fuß, Knie, Hand und Schulter exakt auf dem Mesh.
|
||||
Dieser Schritt ist bei diesem Mesh-Typ Pflicht.
|
||||
|
||||
### Testpose
|
||||
|
||||
Arm hoch/tief, Bein gehoben, Kopf gedreht, Oberkörper geneigt. Rock, Haare
|
||||
und Schlittschuhe folgen ohne sichtbare Artefakte. Die Bindung wurde nicht
|
||||
manuell nachgearbeitet.
|
||||
|
||||
## Export
|
||||
|
||||
| Variante | Bones | Größe |
|
||||
| :--- | ---: | ---: |
|
||||
| vollständiger Control-Rig | 226 | 8,41 MB |
|
||||
| nur Deform-Bones (`export_def_bones`) | 30 | 8,35 MB |
|
||||
|
||||
Der Exporter meldet:
|
||||
|
||||
- mehr als 4 Joint-Einflüsse → auf die 4 stärksten gekürzt und normalisiert
|
||||
- mehrere Shader-Tex-Image-Knoten → Sampler-Warnung, visuell unauffällig
|
||||
- Constraints nicht glTF-fähig → Animationen werden gebacken
|
||||
|
||||
## Godot
|
||||
|
||||
- Import über `res://assets/external/characters/`.
|
||||
- `Skeleton3D` mit 30 Bones, eine skinnende `MeshInstance3D`, AABB
|
||||
1,659 × 1,898 × 0,352 m, Material `model`.
|
||||
- Testclip `TestWave`: 2,0 s, 90 Kanäle (3 pro Joint), als
|
||||
`AnimationPlayer` mit Länge 2,0 s importiert und bei t = 1,0 gerendert.
|
||||
- Prüfwerkzeuge: `tests/manual/inspect_rig.gd`, `tests/manual/capture_rig.gd`.
|
||||
|
||||
## Asset-Pipeline
|
||||
|
||||
- `assets/asset_manifest.json` beschreibt ID, Quelle, Ziel, SHA-256, Größe,
|
||||
Platzierung und Rig-Metadaten.
|
||||
- `tools/sync_assets.sh --check|--sync [--force]` prüft Quelle und Ziel gegen
|
||||
den Hash, kopiert nach `assets/external/` und importiert in Godot.
|
||||
- `assets/external/` ist gitignored.
|
||||
- Die Phase-1-Export-Presets schließen `assets/external/*` aus; 3D-Builds
|
||||
brauchen ein eigenes Preset.
|
||||
- Neuer Test `tests/run_asset_manifest_tests.gd`: 48 Assertions für Schema,
|
||||
Pfade, Platzierung, Rig-Daten und optional die synchronisierte Datei.
|
||||
- Gesamtsuite: **1123 Assertions** grün.
|
||||
|
||||
## Dateien
|
||||
|
||||
```
|
||||
workbench/source/characters/skater/
|
||||
├── skater_rig_v002.blend # Produktions-Rig, ohne Testaktion
|
||||
├── skater_anim_test.blend # Rig + TestWave
|
||||
├── skater_rig_v001.blend # erster Lauf (vergleichen)
|
||||
└── skater_rig_test_01.blend # vor dem Rig
|
||||
|
||||
workbench/library/characters/
|
||||
├── skater_figure_rigged_deform_v002.glb # 30 Bones, 8,35 MB
|
||||
├── skater_figure_anim_test_v001.glb # + TestWave
|
||||
└── ... (Vergleichsversionen)
|
||||
```
|
||||
|
||||
## Entscheidungen
|
||||
|
||||
- **D13:** 3D-Assets bleiben extern; das Repo hält Manifest und Sync-Werkzeug.
|
||||
- Der Produktions-Rig bleibt im `.blend`; exportiert werden nur Deform-Bones.
|
||||
- Animationen werden beim glTF-Export gebacken, nicht als Constraints
|
||||
mitgeschleppt.
|
||||
- Der Testclip bleibt aus dem Produktions-Rig und aus dem Manifest.
|
||||
|
||||
## Offen
|
||||
|
||||
- 3D-Rink und Skater im Godot-Prototyp bewegen (Kurven-Sampling aus Phase 1).
|
||||
- Rotoscoping-Workflow: Referenzvideo, Kamera, Action-/NLA-Konventionen.
|
||||
- Erste echte Clips (Vorwärtsgleiten, Rückwärts, Pirouette).
|
||||
- Android: Texturen auf 1K reduzieren oder separater Asset-Pack.
|
||||
- Workbench-Backup außerhalb des Repos sicherstellen.
|
||||
|
|
@ -182,10 +182,14 @@ UI-Feedback der Tester ohnehin noch ausstehen.
|
|||
|
||||
## Phase 2 – 3D-Präsentation
|
||||
|
||||
- [ ] 3D-Rink und Skater auf Basis desselben Datenmodells
|
||||
- [x] Externe Asset-Pipeline (Manifest, Hash-Prüfung, Sync nach `assets/external/`)
|
||||
- [x] Geriggter Skater (AutoRigPro, 226 Control-/30 Deform-Bones, glTF-Export)
|
||||
- [x] Animations-Bake und Godot-Import eines Testclips (`TestWave`)
|
||||
- [ ] 3D-Rink und Skater auf Basis desselben Datenmodells im Godot-Prototyp
|
||||
- [ ] Rotoscoping-Workflow und erste echte Animationsclips
|
||||
- [ ] NLA-/Animations-Tracks aus Blender
|
||||
- [ ] Blender-MCP und Godot-Editor-MCP für den Asset-Workflow
|
||||
- [ ] Klare Trennung: Phase 1 bleibt ohne 3D-Abhängigkeiten lauffähig
|
||||
- [x] Klare Trennung: Phase 1 bleibt ohne 3D-Abhängigkeiten lauffähig
|
||||
|
||||
## Bewusst nicht jetzt
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue