BVH Viewer

Zweck & Benutzerintention: Der BVH Viewer löst das Problem der Überprüfung von BVH-Bewegungserfassungsdaten ohne ein vollständiges 3D-Tool. Zielnutzer sind 3D-Animatoren, Spieleentwickler, VFX-Techniker und Forscher, die BVH-Assets aus Maya, Blender oder Motion-Capture-Systemen exportieren. Verwenden Sie, wenn Sie die Integrität der Hierarchie überprüfen, Kanäle Gelenken zuordnen, Bewegungen über Aufnahmen hinweg vergleichen oder Daten für Pipelines vorbereiten müssen.

Kernlogik & Funktionen: Das Tool parst eine BVH-Datei, baut eine Gelenkhierarchie auf und dekodiert pro-Frame-Kanäle in Gelenktransforms. Erforderliche Funktionen: BVH-Parsing, Hierarchieextraktion, Kanal-zu-Gelenk-Zuordnung, Pro-Frame-Transformationsberechnung. Erweiterte Funktionen (optional): Skalierung der Einheiten, Koordinatenkonvertierung, Frame-Bereich-Filterung, Frame-Rate-Normalisierung, Gelenk-Umbau, Export von Skelett- oder Bewegungszusammenfassungen als JSON/CSV. Es unterstützt gängige BVH-Varianten und meldet Strukturfehler.

Eingaben & Ausgaben: Eingaben: bvh_file (erforderlich), frame_rate (optional, fps), time_range (optional, Start/Ende in Sekunden), scale (optional). Ausgaben: Skelettdaten und Bewegungsdaten plus eine Zusammenfassung mit frame_count und Dauer. Validierung erfordert eine gültige Hierarchie mit mindestens einem Bewegungs-Channel; beschädigte Dateien führen zu Parsing-Fehlern und Abbruch.

Algorithmen & Berechnungen: Parsing baut einen Gelenkbaum, speichert Ruhezustand und wandelt Kanäle in Pro-Frame-Transformationswerte um. Globale Transformationen werden durch Konkatenation von Eltern-Transforms mit lokalen Offsets berechnet. Optionales Interpolieren behandelt fehlende Frames bei Angabe eines Zeitbereichs; Koordinatentransformation kann Up-Axis an die Zielwelt ausrichten; Skalierung multipliziert Entfernungen.

Fehler & Randfälle: Ungültige Dateiformate, fehlende Wurzel oder essenzielle Gelenke, nicht monotone oder Null-Frames oder zu viele Gelenke lösen strukturierte Fehlerdiagnose aus. Große BVH-Dateien erfordern ggf. chunked parsing.
Industrie/Region & Lokalisierung: BVH ist ein globaler Standard; Maßeinheiten meist Meter und Sekunden; Bildraten variieren; keine locale-spezifische Handhabung außer numerischer Formatierung.
Annahmen & Ausschlüsse: Geht davon aus, dass BVH dem Biovision-Standard mit definierter Hierarchie und Kanälen entspricht. Ausschluss von Rendering, UI-Bearbeitung oder Echtzeit-Streaming; Fokus auf Data Extraction, Validation und exportbereite Outputs.