| name | implement-pyray-input-camera |
| description | Implement semantic input mapping, virtual resolution, Camera2D control, and inverse isometric pointer picking in a pyray game. Use for the input-and-camera phase only. |
Implement input and camera
Scope
Implement only G22 device-to-semantic action mapping, virtual viewport,
Camera2D state, coordinate conversion, and inverse-isometric pointer picking.
Inputs
- Absolute
FORGE_ROOT and external GAME_ROOT with passing G20-G21 gates.
- Current source-tree/runtime/platform/catalog hashes and G22 writable surface.
- Selected world ID, release ID, and verified bundle hash for picking fixtures.
- Semantic action schema, platform input classes, viewport/zoom policy, and G21
tested inverse projection.
- Representative keyboard, pointer, gamepad, resize, DPI, and tile-edge fixtures.
Outputs
- Game-owned input/camera adapter and pure coordinate-conversion helpers.
- Semantic edge/deadzone, viewport, camera, picking, and native-availability tests.
- Forge-owned G22 completion record outside
GAME_ROOT.
Invariants
- Keep
src/isoworld, locks, bundles, projection definition, and simulation immutable.
- Keep camera state in presentation; pass semantic actions only to simulation.
- Do not draw maps, load assets, or implement gameplay reduction.
- Let G20 invoke this polling port; let G24 interpret UI focus/navigation actions.
- Never copy
AGENTS.md, .agents, Forge skills, or phase evidence into GAME_ROOT.
Workflow
- Read the input/camera gate in
docs/GAME_IMPLEMENTATION_PHASES.md.
- Map keyboard, pointer, and gamepad state to semantic typed actions.
- Distinguish pressed, released, held, and analog values with deadzones.
- Compute letterboxing and virtual coordinates from the real window size.
- Apply Camera2D inverse transform, then consume G21's tested inverse projection.
- Test resize, zoom limits, tile edges, letterbox bars, and action edge delivery.
Completion
Complete when action edges/deadzones, resize/DPI conversion, camera bounds, and
tile-edge picking pass in semantic tests and required native probes, followed by
the shared headless suite and clean-game audit.
