Skip to content

Remove old F2/F3 keys #50

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
digarok merged 2 commits into from
Jul 6, 2026
Merged

Remove old F2/F3 keys #50

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8f41b8c
remove/free up hotkeys natively handled in sdl port
digarok Jul 6, 2026
7e79add
update wording
digarok Jul 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 31 additions & 31 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,32 +92,29 @@ Some features that are a part of the SDL3 build:

## Controls

**Additional GSplus hotkeys** — handled by the app (the SDL build), not sent to the
emulated IIgs:

| Key | Action |
|---|---|
| **F10** | Save a screenshot |
| **F11** | Toggle fullscreen |
| **Shift + F11** | Toggle the CRT scanline effect |
| **Ctrl + F11** | Toggle the CRT curved screen effect |
| **Drag & drop** | Drop a disk image on the window to mount it (slot guessed from size) |

**Emulator hotkeys** — inherited from KEGS and handled by the emulator core:

| Key | Action |
|---|---|
| **F4** | Open the configuration menu (mount disks, pick a ROM, settings) |
| **F5** | Toggle the status line |
| **F6** | Cycle emulation speed (1 MHz / 2.8 MHz / fast) |
| **F7** | Toggle the debugger · **Shift + F7** toggles fast disk emulation |
| **F8** | Grab / release the mouse (warp + hide pointer) |
| **F9** | Invert paddles · **Shift + F9** swap paddles · **Ctrl + F9** copy screen text |
| **Ctrl + F12** | Reset the IIgs (Ctrl-Reset) |

On keyboards without Apple keys, **F1** acts as Open-Apple (⌘), **F2** as
Option/Closed-Apple, and **F3** as Escape. On macOS, ⌘ key combos are forwarded
to the emulated machine.
The following hotkeys let you dynamically change many of the emulator settings,
but you can also edit most settings by hitting `F4` for the configuration menu.

| Key | Action | Source |
|---|---|---|
| **F1** | Open-Apple (⌘) modifier, for keyboards without an Apple/Command key | KEGS/GS+ |
| **F4** | Open the configuration menu (mount disks, pick a ROM, settings) | KEGS/GS+ |
| **F5** | Toggle the status line | KEGS/GS+ |
| **F6** | Cycle emulation speed (1 MHz / 2.8 MHz / fast) | KEGS/GS+ |
| **F7** | Toggle the debugger | KEGS/GS+ |
| **Shift + F7** | Toggle fast disk emulation | KEGS/GS+ |
| **F8** | Grab / release the mouse (warp + hide pointer) | KEGS/GS+ |
| **F9** | Invert paddles | KEGS/GS+ |
| **Shift + F9** | Swap paddles | KEGS/GS+ |
| **Ctrl + F9** | Copy screen text to the clipboard | KEGS/GS+ |
| **F10** | Save a screenshot | GS+ |
| **F11** | Toggle fullscreen | GS+ |
| **Shift + F11** | Toggle the CRT scanline effect | GS+ |
| **Ctrl + F11** | Toggle the CRT curved screen effect | GS+ |
| **Ctrl + F12** | Reset the IIgs (Ctrl-Reset) | KEGS/GS+ |

You can also **drag & drop** a disk image onto the window to mount it (slot
guessed from size).

## Building from source

Expand Down Expand Up @@ -181,12 +178,15 @@ what I see in every modern development shop. Things have changed dramatically
over the past few years. But I want to be clear about AI usage, and that I
feel comfortable using it as a tool that needs a lot of oversight.

KEGS is a brilliant piece of pure C, and is living proof that you don't need
AI to write great software. Kent Dickey did the hard, beautiful work. The AI
here is just a pragmatic crutch to keep *my* reboot alive between the demands
of real life.
KEGS is a brilliant piece of pure C, and is proof that you don't need AI to
write great software. Kent Dickey did the hard, beautiful work. The AI here
is a pragmatic crutch to keep *my* reboot alive between the demands of real
life.

So what does GSplus actually add? A handful of **features I want for myself**.
If you want the canonical emulator, go straight to KEGS. It's great!

I'm just over here having fun making the emulator extensions that I find
useful or interesting. I hope it helps some other people connect to the
incredible machine that is the Apple IIgs. Peace!

- Dagen
12 changes: 4 additions & 8 deletions gsplus/src/adb.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2029,14 +2029,6 @@ adb_physical_key_update(Kimage *kimage_ptr, int raw_a2code, word32 unicode_c,
a2code = 0x37;
special = 0;
break;
case 0x02: /* F2 - remap to option */
a2code = 0x3a;
special = 0;
break;
case 0x03: /* F3 - remap to escape for OS/2 */
a2code = 0x35;
special = 0;
break;
case 0x0c: /* F12 - remap to reset */
a2code = 0x7f;
special = 0;
Expand All @@ -2056,6 +2048,10 @@ adb_physical_key_update(Kimage *kimage_ptr, int raw_a2code, word32 unicode_c,

if(special && !is_up) {
switch(special) {
case 0x02: /* F2 - nothing */
break;
case 0x03: /* F3 - nothing */
break;
case 0x04: /* F4 - Emulator config panel */
cfg_toggle_config_panel();
break;
Expand Down
Loading