basic advanced example

docs/validation.md

@@ -100,3 +100,76 @@ Nie sprawdzano retargetingu, Animation Blueprintów ani eksportu wielu akcji/NLA
   nakładania; stykające się klipy nie dostają fade. Sprawdzone łańcuchy trzech
   klipów oraz odrzucanie niejednoznacznych zakresów i dodawania w odwrotnej kolejności.
 - Parametr `blend_in` usunięty z API i przykładów. Zakresy scen pozostają takie same.
+
+## Katalog enumów i długości dostępnych offline
+
+- 34 testy poza UE: statyczne enumy obejmują wszystkie pliki źródłowe, importują
+  się bez `unreal`, udostępniają sekundy i przeliczenie klatek z FPS i prędkością.
+- Sprawdzone zaokrąglanie czasu float32 bez dodawania zbędnej klatki, automatyczny
+  koniec dla enuma, jawny koniec oraz odrzucenie sekcji dłuższej niż sekwencja.
+- `tools/smoke_animation_catalog.py` w UE: porównane długości wszystkich 63 klipów
+  z rzeczywistym `get_play_length()`, odtworzone enumy, w tym `speed=2`, oraz render
+  klatki ze środka automatycznego przejścia. Katalog pochodzi z eksportu assetów UE.
+- Po przypisaniu parametrów sekcji przywracany jest zakres podany w Pythonie,
+  ponieważ edytor może przeskalować go przy zmianie prędkości.
+
+## Automatyczne katalogi własnych modeli
+
+- 41 testów poza UE: generowanie nowej klasy, metadane bez `unreal`, zachowanie
+  innych modeli, aktualizacja podzbioru, usuniętych klipów i niezmienionych danych.
+- Sprawdzone odrzucanie kolizji nazw i nieprawidłowych czasów bez naruszenia pliku
+  oraz dodanie nowej klasy do już załadowanego modułu.
+- `tools/smoke_automatic_catalog.py` zaliczony w UE: pierwszy import pod nazwą
+  StudentCatalogSmoke, automatyczny zapis dwóch klipów, odczyt wygenerowanego enuma
+  i użycie go do animacji z automatycznym końcem. Katalog testowy zapisano w build.
+- Zwykły hook odświeżył także pełne katalogi Fighter i Creature z istniejących assetów.
+
+## keep_end_position
+
+- 45 testów poza UE: dodatkowo pozioma interpolacja ruchu, sumowanie pętli,
+  włączenie przeniesienia do Transform i ponowne użycie jednej kopii klipu.
+- `tools/smoke_keep_end_position.py` zaliczony w UE: slash_2 od klatki 57 przy
+  30 FPS, wejście slash_3 w klatce 161. Zapisane rzeczywiste klucze rodzica;
+  po klatce 163 aktor zachowuje około 354 cm przesunięcia dla modelu wysokości 200 cm.
+- Sprawdzone ciągłe położenie bioder przy przejściu, brak podwojenia przesunięcia,
+  niezmieniona źródłowa animacja, ponowne wykonanie i render klatki po ataku.
+- Przenoszony jest poziomy ruch pierwszej kości szkieletu (Hips w tym modelu).
+  Pionowe ruchy i obroty kości zostają w klipie; kopie są w wygenerowanym folderze RootMotion.
+
+## Odczyt pozycji i ruch względny
+
+- 49 testów poza UE: odczyt istniejących kanałów pozycji, pozycja startowa bez
+  ścieżki, dodanie względnego offsetu oraz walidacja bez tworzenia częściowych kluczy.
+- `tools/smoke_relative_move.py` zaliczony w UE: creature wysokości 300 cm,
+  start `(0, -850, 0)`, MUTANT_RUN z keep_end_position, swiping i walking.
+- Pozycja w klatce 80 odczytana z natywnych krzywych Sequencera. Ruch 80–120
+  zwiększył Y dokładnie o 50 cm, zachował punkt początkowy i pozycję po klatce 120.
+  Sprawdzono też interpolowaną pozycję w środku ruchu.
+
+## Cofanie i zastępowanie trasy
+
+- 53 testy poza UE: odwrócone odtwarzanie, cofanie ruchu po nierównomiernej krzywej,
+  sumowanie pętli do tyłu, usuwanie kluczy wewnątrz move i przesuwanie późniejszych.
+- `tools/smoke_reverse_walk.py` zaliczony w UE: run → swiping → walking z reverse,
+  naturalny ruch wstecz oraz zastąpienie trasy cofnięciem o 200 cm.
+- Sprawdzone pozycje początkowa, środkowa i końcowa, brak wewnętrznych kluczy
+  z poprzedniej trasy i zachowanie względnego ruchu późniejszego klucza.
+
+## Zachowanie końcowej pozy
+
+- 55 testów poza UE: natywne Keep State, zamrożony odcinek końcowej pozy oraz
+  skracanie tego odcinka, gdy pojawi się następny klip tej samej postaci.
+- `tools/smoke_keep_end_pose.py`: śmierć mutanta od klatki 0 przy 30 FPS, render
+  klatki 299 po zakończeniu klipu. Wizualnie sprawdzono, że mutant leży na ziemi.
+- Samo Keep State dawało w takim renderze pozę referencyjną; dodatkowy odcinek
+  z prędkością 0 i przesunięciem czasu do końca klipu utrzymuje właściwą pozę.
+
+## Rodzaje świateł i klucze światła
+
+- 60 testów poza UE: klucze koloru i jasności, ponowne użycie tracków oraz
+  odrzucanie błędnych argumentów bez tworzenia tracka.
+- `tools/smoke_lights.py` w UE: point, spot i sun w jednej scenie, render klatek
+  0, 24 i 47. Wizualnie sprawdzono zmianę koloru reflektora z czerwonego na niebieski
+  oraz wzrost jasności reflektora i żarówki.
+- Domyślne `intensity=500` słońca dobrano do stałej ekspozycji `camera.create`;
+  przy `intensity=1` słońce nie było widoczne na renderze.