summaryrefslogtreecommitdiff
path: root/platformer/src/controls.c
diff options
context:
space:
mode:
authorSchark <jordan@schark.online>2026-09-23 23:09:55 -0400
committerSchark <jordan@schark.online>2026-09-23 23:09:55 -0400
commitdab65412376d1b73381446f969c1461c24169811 (patch)
tree27adfec438a9bd9f3c96a740ab54016df5f68b80 /platformer/src/controls.c
parentaf03f388cbcff795158ea8345b5c876470229e8b (diff)
downloadgamedev-dab65412376d1b73381446f969c1461c24169811.tar.gz
gamedev-dab65412376d1b73381446f969c1461c24169811.zip
Base prompts
Diffstat (limited to '')
-rw-r--r--platformer/src/controls.c75
1 files changed, 75 insertions, 0 deletions
diff --git a/platformer/src/controls.c b/platformer/src/controls.c
new file mode 100644
index 0000000..850a1ae
--- /dev/null
+++ b/platformer/src/controls.c
@@ -0,0 +1,75 @@
+/*
+ * ============================================================
+ * FILE: controls.c
+ *
+ * PURPOSE: Turns the physical gamepad (primary) or keyboard (fallback)
+ * into the abstract Input struct from controls.h. Getting
+ * the analog feel right here (the deadzone and stick scaling)
+ * matters as much as the player code for movement feel.
+ *
+ * FITS IN: main.c calls controls_poll() once per fixed tick. It uses
+ * GLFW's gamepad API directly and window_handle() (window.h)
+ * only for keyboard reads. It's the only file that reads raw
+ * input devices.
+ *
+ * IMPLEMENT:
+ * - Private state: the previous tick's button states (for the "pressed"
+ * edges), e.g. `static bool s_prev_jump, s_prev_reset, s_prev_quit;`
+ *
+ * - Finding a gamepad (keep it simple; this also handles hot-plugging):
+ * each poll, loop GLFW_JOYSTICK_1..GLFW_JOYSTICK_LAST and use the first
+ * jid where glfwJoystickIsGamepad(jid) is true, then read it with
+ * glfwGetGamepadState(jid, &state). GLFW 3.4 has SDL's controller
+ * mapping database built in, so Xbox/PlayStation/Switch pads all show
+ * up in the standard layout. Print a line to stdout when the active
+ * pad connects or disconnects (glfwGetGamepadName), so it's clear
+ * which device is in use.
+ *
+ * - Gamepad mapping:
+ * move.x = GLFW_GAMEPAD_AXIS_LEFT_X
+ * move.y = -GLFW_GAMEPAD_AXIS_LEFT_Y (GLFW reports up as NEGATIVE,
+ * so flip it: up = forward = +y)
+ * look.x = GLFW_GAMEPAD_AXIS_RIGHT_X
+ * look.y = -GLFW_GAMEPAD_AXIS_RIGHT_Y
+ * jump = GLFW_GAMEPAD_BUTTON_A
+ * reset = GLFW_GAMEPAD_BUTTON_BACK
+ * quit = GLFW_GAMEPAD_BUTTON_START
+ *
+ * - RADIAL deadzone (write a small static helper, used for both sticks):
+ * len = length of the raw (x, y)
+ * if len < deadzone -> (0, 0)
+ * else rescale so the edge of the deadzone maps to 0 and full tilt maps
+ * to 1: new_len = (len - deadzone) / (1 - deadzone), clamped to 1,
+ * keeping the original direction.
+ * WHY radial and not per-axis: a per-axis deadzone snaps diagonals
+ * to the cardinal directions and makes slow walking feel "sticky". SM64
+ * also computes one magnitude from the whole stick and uses it for speed.
+ * Also clamp the final length to 1, because some pads report corners past 1.
+ * Use MOVE_DEADZONE / LOOK_DEADZONE from config.h.
+ *
+ * - Keyboard fallback, used ONLY when no gamepad is connected:
+ * W/S/A/D -> move (normalize diagonals so the length is <= 1)
+ * Arrow keys -> look
+ * Space -> jump, R -> reset, Esc -> quit
+ * Read keys with glfwGetKey(window_handle(), key).
+ * Esc also quits when a gamepad IS connected (so you can always exit).
+ *
+ * - Edge detection: pressed = down_now && !down_last_tick. Then store
+ * down_now for next tick.
+ *
+ * - Zero the whole Input at the start of controls_poll so no stale data leaks.
+ *
+ * CONVENTIONS: `s_` prefix for statics. <GLFW/glfw3.h> is included here (not
+ * in controls.h).
+ *
+ * NOT IN SCOPE: Rebinding, loading an external gamecontrollerdb.txt,
+ * rumble, triggers/shoulder buttons (add them when a move needs
+ * them), input recording/replay.
+ *
+ * DONE WHEN: With a pad: a small stick tilt gives a small |move|, full
+ * tilt gives ~1.0, the resting stick gives exactly (0, 0), and each
+ * A press sets jump_pressed for exactly one tick. Unplugging the
+ * pad switches to the keyboard without a crash, and plugging it back
+ * in switches back.
+ * ============================================================
+ */