psxrecomp/runtime/include/psx_keybinds.h

#pragma once
#include <stdint.h>
#include <SDL.h>

#ifdef __cplusplus
extern "C" {
#endif

/*
 * psx_keybinds — configurable KEYBOARD -> PlayStation DualShock keybinds.
 *
 * INI-driven, generated next to the exe as `keybinds.ini` on first run. Covers
 * every DualShock input: the D-pad, the four face buttons (Cross/Circle/
 * Square/Triangle), the shoulders (L1/L2/R1/R2), Start/Select, the stick
 * clicks (L3/R3), and — for the keyboard analog path — the left and right
 * analog-stick directions. Each input maps to one SDL_Scancode; "None"
 * (SDL_SCANCODE_UNKNOWN) leaves it unbound.
 *
 * This is the KEYBOARD map only. Game-controller (gamepad) button mapping is a
 * separate concern handled by input.ini (see main.cpp load_input_config).
 *
 * Two players. Player 1 defaults reproduce the framework's historical hardcoded
 * keyboard mapping (so out-of-the-box behaviour is unchanged); Player 2 is
 * unbound by default (fill it in to drive a second keyboard player).
 *
 * The launcher's Controls page edits these live through the rebind API below
 * (get/set/reset/save) and persists to the same keybinds.ini; the runtime
 * re-reads the file at startup via psx_keybinds_init.
 */

/* Button indices — stable order, matches the order keybinds.ini writes and the
 * order the launcher's rebind chips are laid out. Keep in sync with kButtons[]
 * in psx_keybinds.c. */
enum PsxKeybindButton {
    PSX_KB_UP = 0, PSX_KB_DOWN, PSX_KB_LEFT, PSX_KB_RIGHT,
    PSX_KB_CROSS, PSX_KB_CIRCLE, PSX_KB_SQUARE, PSX_KB_TRIANGLE,
    PSX_KB_L1, PSX_KB_R1, PSX_KB_L2, PSX_KB_R2,
    PSX_KB_L3, PSX_KB_R3,
    PSX_KB_START, PSX_KB_SELECT,
    PSX_KB_LS_UP, PSX_KB_LS_DOWN, PSX_KB_LS_LEFT, PSX_KB_LS_RIGHT,
    PSX_KB_RS_UP, PSX_KB_RS_DOWN, PSX_KB_RS_LEFT, PSX_KB_RS_RIGHT,
    PSX_KB_COUNT
};

typedef struct {
    SDL_Scancode up, down, left, right;
    SDL_Scancode cross, circle, square, triangle;
    SDL_Scancode l1, r1, l2, r2;
    SDL_Scancode l3, r3;
    SDL_Scancode start, select;
    SDL_Scancode ls_up, ls_down, ls_left, ls_right;   /* left analog stick */
    SDL_Scancode rs_up, rs_down, rs_left, rs_right;   /* right analog stick */
} PsxPlayerBinds;

typedef struct {
    PsxPlayerBinds p1;
    PsxPlayerBinds p2;
} PsxKeyBinds;

/* Initialize from <exe_dir>/keybinds.ini. Generates a default file if one does
 * not exist. exe_path may be NULL/argv[0]/the exe directory itself — the .ini is
 * placed in that file's directory (or the path itself when it is a directory). */
void psx_keybinds_init(const char *exe_path);

/* Read-only view of the current bindings. */
const PsxKeyBinds *psx_keybinds_get(void);

/* ── Runtime read helpers (keyboard -> PSX pad), player is 1 or 2 ──────────── */

/* Build the 16-bit ACTIVE-LOW PSX button word for `player` from the SDL
 * keyboard state (bits per the standard PSX pad word; unbound inputs never
 * assert). Returns 0xFFFF (all released) if `keys` is NULL or player is out of
 * range. AND this into the pad word (an unpressed source leaves bits high). */
uint16_t psx_keybinds_pad_word(const uint8_t *keys, int player);

/* Fill analog-stick bytes (0x80 centred): out[0]=LX, out[1]=LY, out[2]=RX,
 * out[3]=RY, from the player's stick-direction binds. A bound direction held
 * drives that axis to the extreme (0x00 / 0xFF). Untouched axes stay centred.
 * Only overwrites axes that have a live bound press, so callers can pre-seed. */
void psx_keybinds_sticks(const uint8_t *keys, int player, uint8_t out[4]);

/* True if any of the player's D-pad direction binds is currently held (used by
 * the hybrid pad-mode auto-switch: a D-pad press flips the pad to digital). */
int psx_keybinds_dpad_active(const uint8_t *keys, int player);

/* ── Rebind API (launcher Controls page) ──────────────────────────────────── */
/* Buttons are indexed 0..PSX_KB_COUNT-1 (see PsxKeybindButton). Scancodes, not
 * keycodes (keybinds.ini stores SDL scancode names). */
int          psx_keybinds_button_count(void);
const char  *psx_keybinds_button_name(int button);          /* "up".."rs_right" */
const char  *psx_keybinds_button_label(int button);         /* pretty, e.g. "Cross" */
SDL_Scancode psx_keybinds_get_button(int player, int button);
void         psx_keybinds_set_button(int player, int button, SDL_Scancode sc);
/* Reset one player's bindings to the built-in defaults (P2 = all unbound). */
void         psx_keybinds_reset_player(int player);
/* Persist the current bindings to keybinds.ini (path resolved by
 * psx_keybinds_init; call that first). */
void         psx_keybinds_save(void);

#ifdef __cplusplus
}
#endif