From 9714bfca2ee0010dc98ce7f90a3425938b95ddef Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 3 Sep 2026 14:39:48 +0000 Subject: [PATCH] Document TI-99/4A controller limits and keyboard shortcuts in README Joystick buttons beyond the first only reach digit keys 1-9 in ti99sim-sdl's own source (src/sdl/ti994a-sdl.cpp) - there's no path to 0, Enter, Q, or Esc from a gamepad. Documents the real Esc-to-exit behavior and full FCTN key row (Alt+1 through Alt+9, Alt+=), both confirmed against the emulator's own bundled doc/README.html. Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_01VLX1yYKJExGSXmgUhxKQG6 --- services/wolf.sh | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/services/wolf.sh b/services/wolf.sh index c273cb4..9419822 100644 --- a/services/wolf.sh +++ b/services/wolf.sh @@ -3824,6 +3824,19 @@ when the TI-99/4A prompt ran, the installer offered to copy it there for you (tab-completing path prompt); otherwise copy it there by hand. Then just drop \`.ctg\`/\`.rpk\`/\`.bin\` cartridge files into \`roms/ti994a/\`. +**Controls.** \`ti99sim-sdl\` maps a real gamepad's stick to the TI-99 +joystick directly, and any joystick button beyond the first (the fire +button) to the number keys 1-9 (confirmed against its own source — +\`( VIRTUAL_KEY_E ) ( VK_0 + std::clamp(( int ) event.jbutton.button, 1, 9 ))\` +in \`src/sdl/ti994a-sdl.cpp\`) — there's no source-level path from a +joystick button to 0, Enter, Q, or Esc, so those need a real keyboard +reaching the stream. **Esc exits the emulator** (confirmed against its +own bundled \`doc/README.html\`) and hands focus back to ES-DE once the +process closes. The TI-99/4A's own FCTN function-key row, for anything +needing keys beyond what a joystick provides, is (also confirmed +against that same doc): Alt+1 DEL, Alt+2 INS, Alt+3 ERASE, Alt+4 CLEAR, +Alt+5 BEGIN, Alt+6 PROC'D, Alt+7 AID, Alt+8 REDO, Alt+9 BACK, Alt+= QUIT. + ## MAME: sample packs showing up as games MAME sample packs (audio for a handful of older analog-sound games) use the exact same \`.zip\`-per-game naming as real ROMs, so if they're sitting in