camera-debugging-qa
/camera-debugging-qa
Mierzy w gierach drgania kamery, błędy podążania, granice i teleportacje na podstawie śladów, bez budowania rigu kamery.
- Autor
- PixelWao ↗
- Repozytorium
- codex-gamedev-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 30.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 12
- Skrypty
- 2
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 30.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/camera_trace_qa.py, tests/test_camera_trace_qa.py
Co robi i kiedy
Mierzy w gierach drgania kamery, błędy podążania, granice i teleportacje na podstawie śladów, bez budowania rigu kamery.
Oryginalny opis (EN)
Use to measure camera jitter, follow errors, bounds, occlusion and teleport regressions from traces; not to build a camera rig.
Jak działa
- Procedure
- Built-in tools
- Measurement limitations
- Verification
Podgląd SKILL.md
---
name: camera-debugging-qa
description: Use to measure camera jitter, follow errors, bounds, occlusion and teleport regressions from traces; not to build a camera rig.
---
# Camera Debugging & QA
Diagnose camera behavior with falsifiable metrics and scene reproduction. Do not assert visual comfort or GPU performance based only on numeric traces.
## Procedure
1. State the camera's intended behavior and operating conditions (platformer look-ahead, RTS pan, target group, scripted shot). Select measurements appropriate to that design; a camera deliberately framing *ahead* of the player will not have zero follow error.
2. Collect telemetry from **the existing render loop**. Write one record per rendered frame: timestamp `t` in seconds, world `target` and visual `camera` positions, optional `teleport`, optional `occluded`. Never store user-identifying data.
3. For 2D bounds, record the effective logical viewport, zoom, and rectangular level bounds. Match units: world positions and viewport divided by zoom. Do not conflate CSS pixels with backing pixels.
4. Save as JSONL, JSON array / `{ "records": [...] }`, or CSV with flat fields; see `references/trace-schema.md`.
5. Run `python scripts/camera_trace_qa.py TRACE.jsonl --max-speed 500 --max-velocity-jump 60 --output report.json` (thresholds illustrative, must be adapted per game). Exit 0=pass, 2=threshold breach, 3=bad input.
6. Review failure frames and reproduce them visually. Rerun the same seed, scene, machine class and input trace after change. Include 30/60/144 Hz or frame-time variation, direction reversal, pause/resume, resize, teleports and obstructions.
7. Report summary, pass/fail thresholds, any intentional violations and any GPU/browser/mobile tests not performed.
## Built-in tools
- `scripts/camera_trace_qa.py` — standard-library Python 3, JSONL/JSON/CSV, robust input validation, p50/p95 following error, speed, velocity jump, occlusion and bounds.
- `tests/test_camera_trace_qa.py` — automated edge-case tests.
- `examples/trace.jsonl` — known-good demonstration trace.
- `references/trace-schema.md` — schema, metric semantics and constraints.
- `assets/camera-qa-report.md` — reusable report.
## Measurement limitations
- Velocity jump is `|v[n]-v[n-1]|`, **not** acceleration per second squared and **not** jerk.
- A camera is not meant to sit on its target for all game styles; following error is diagnostic, not universally a failure.
- Samples recorded directly after teleports are excluded from follow/speed checks for a configurable grace interval; other failures are still tracked.
- Occlusion flag requires a **real visibility or collision query** supplied by the game; this tool cannot infer it from camera/target positions alone.
- Unit tests alone cannot prove screen composition, image stability, comfort, input latency or CPU/GPU performance.
## Verification
Run `python -m unittest discover -s tests -v` from the skill root; invoke CLI on the example trace; inspect JSON report. Validate that missing fields, NaN, non-monotonic timestamps and impossible bounds fail closed.
Pliki w paczce (12)
- CHANGELOG.md 1 KB
- LICENSE 1 KB
- PROVENANCE.md 1 KB
- README.md 1 KB
- SKILL.md 3 KB
- assets/camera-qa-report.md 1 KB
- attribution/upstream/LICENSE 11 KB
- attribution/upstream/NOTICE 1 KB
- examples/trace.jsonl 1 KB
- references/trace-schema.md 2 KB
- scripts/camera_trace_qa.py 9 KB
- tests/test_camera_trace_qa.py 3 KB
Wersje
W bazie nie ma innych skilli o nazwie camera-debugging-qa.
Migawka bazy z 13.11.2026 · wersja paczki debbdba22f42 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100camera-system
Implementuje kamery 2D i 3D w grach: płynne śledzenie, drżenie ekranu, strefy kamery i przejścia. - 100camera-system
Pomaga implementować kamery w grach 2D i 3D: płynne śledzenie, wstrząsy ekranu, strefy kamery i przejścia. - 100browser-camera-2d
Ustawia w grze 2D lub pikselowej kamerę, która podąża za postacią, z martwą strefą, wyprzedzeniem i zoomem, bez 3D. - 100camera-systems
Buduje kamery w grach: podążanie 2D z martwą strefą, wyprzedzanie, wygładzanie, orbitę 3D, pierwszą osobę i kadrowanie wielu celów. - 100camera-systems
Buduje kamery do gier: śledzenie 2D z martwą strefą, orbita 3D z kolizjami, widok z pierwszej osoby, kadrowanie wielu celów i wstrząsy. - 90esp32-camera-xclk-timing-validation
Waliduje czas sygnału XCLK kamery w ESP32, z ograniczeniami układu, analizą awarii i pomiarami przed wydaniem produktu.