Files
goldeneye-pc-port/port/include/optionsoverlay.h
T
James Dansereau 413014b8f6 D343: file-select Options label opens the settings overlay; F10 idle-timer fix
One Rule-2 #ifdef PORT draw hook in constructor_menu05_fileselect (user
sign-off 2026-09-27). The label's hit test and open request live in
optionsoverlay.c; the open is applied on the input thread. While the
overlay is open on file select, g_MenuTimer is held at 0 so the screen no
longer drops to the legal screen after 30 s.
2026-09-27 10:01:27 -04:00

60 lines
2.1 KiB
C

#ifndef PORT_OPTIONSOVERLAY_H
#define PORT_OPTIONSOVERLAY_H
/*
* F10 in-game options overlay (approach C from docs/dev/OPTIONS-MENU-PLAN.md).
*
* A self-contained port-layer immediate-mode overlay: it draws its own 2D
* display list on top of the game's frame (appended in fast3d's gfx_run,
* after the game DL) and handles its own keyboard/mouse nav. It edits the
* port-owned config.c options directly, so changes apply live for the live
* ones. When closed it renders NOTHING (zero bytes appended) -- golden dumps
* stay byte-identical.
*
* Hooks:
* video.c videoPumpEvents : F10 -> optionsOverlayToggle(); ESC closes;
* wheel -> optionsOverlayScroll()
* input.c inputComputePad : controller 0 swallowed while open;
* nav routed to optionsOverlayHandleInput()
* gfx_pc.cpp gfx_run : optionsOverlayEmit() appended after the game DL
*/
#include <PR/ultratypes.h>
#include <PR/gbi.h>
#ifdef __cplusplus
extern "C" {
#endif
/* Toggle open/closed. On the closing edge the config is saved. */
void optionsOverlayToggle(void);
/* 1 while the overlay is on screen. */
int optionsOverlayIsOpen(void);
/* Called from inputComputePad(0) while open: reads SDL keyboard edges and
* drives the cursor / value adjustments. */
void optionsOverlayHandleInput(void);
/* Mouse-wheel notch -> move the selection (host event pump). */
void optionsOverlayScroll(int dir);
/* Build the overlay's 2D display list for this frame, or return NULL when the
* overlay is closed. Called by fast3d after running the game DL. */
Gfx *optionsOverlayEmit(void);
/* D343: file-select "Options" label. Called from the one #ifdef PORT hook in
* constructor_menu05_fileselect (game thread): draws the label, and on a
* click posts an open request. */
Gfx *optionsFileSelectLabel(Gfx *gdl);
/* Applies a pending label-open request. Called from the input poll
* (scheduler thread, controller 0) before the overlay's swallow gate. */
void optionsOverlayPollRequests(void);
#ifdef __cplusplus
}
#endif
#endif /* PORT_OPTIONSOVERLAY_H */