mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 02:11:36 -04:00
Shokunin
e21226feb7
psx_host_set_input_sink: an overlay provider sees host SDL events first, in the event drain and the host pause loop, and may consume them. psx_host_set_ui_capture: while on, local game input reads released and centred (netplay included, so peers receive "nothing pressed") and the external-input gate stays closed. Debug builds gain host_key, which pushes a real SDL key event for scripted runs. Inert without a provider. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
95 lines
4.9 KiB
C
95 lines
4.9 KiB
C
#pragma once
|
|
/* Ordered external-input resolution for one offline player's pad.
|
|
*
|
|
* (1) physical/local capture -> buttons, device presence; host extras
|
|
* of the port (gamepad present, LT/RT values)
|
|
* (2) offline controller source (psx_mod_set_controller_source), if any:
|
|
* buttons = source & physical; sticks/type from the source, through
|
|
* the controller presentation policy (hook)
|
|
* (2b) title pad transform (psx_mod_set_pad_transform), if any: sees the
|
|
* pad of (1)/(2) plus the host extras (a digital pad with no source
|
|
* as its host pad: real sticks, no stick->D-pad fold); may rewrite
|
|
* buttons, sticks and the presented type (NeGcon packed as PsxNetPad
|
|
* documents). Declining delivers the stock pad of (1)/(2).
|
|
* (3) local mouse policy (psx_mod_set_local_mouse_policy), P1 only: may
|
|
* override ONLY the right analog axes of whatever (1)-(2b) produced;
|
|
* a NeGcon result has no right stick, so it resets the mouse.
|
|
*
|
|
* Precedence: a source never suppresses the mouse policy. The mouse sees the
|
|
* RESOLVED pad (final buttons, final analog flag, final right stick), so a
|
|
* capture is never taken and then discarded, and an active source whose right
|
|
* stick is deflected, whose pad is digital, or whose Start is held disables
|
|
* the mouse exactly as a physical stick/digital pad/Start would. The mouse
|
|
* is reset (capture released) on a released/declined frame, no device, or an
|
|
* armed savestate input guard.
|
|
*
|
|
* Pure: every side effect goes through PadExtHooks, so the order is testable
|
|
* without SDL/SIO. Main (emulation) thread only. */
|
|
#include <stdint.h>
|
|
#include "mod_plugins.h"
|
|
#include "psx_netplay.h"
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct PadExtHooks {
|
|
void *ctx;
|
|
/* Input guard (savestate close/load): all external input delivers
|
|
* neutral and the mouse is reset. Queried once per resolve. */
|
|
int (*guard_active)(void *ctx);
|
|
/* (1) Physical capture of port `s`; NO mouse side effects. Returns 1 if a
|
|
* device is present, else 0 (*out released/disconnected). With
|
|
* `guarded`, buttons/sticks are neutral but type/presence still resolve. */
|
|
int (*capture_local)(void *ctx, int s, PsxNetPad *out, int guarded);
|
|
/* (2) Source for port `s`: returns 0 when none; else fills *state and
|
|
* *released (a one-frame neutral release after detach/reset). */
|
|
int (*source_sample)(void *ctx, int s, PSXModControllerState *state, int *released);
|
|
/* Release frame: neutral pad + the port's real SIO state restored. */
|
|
void (*source_release)(void *ctx, int s, PsxNetPad *out);
|
|
/* Live source frame: pad->buttons is already source&physical; fill
|
|
* sticks/analog (presentation policy, multitap rule) and claim the port. */
|
|
void (*source_resolve)(void *ctx, int s, const PSXModControllerState *state,
|
|
int guarded, PsxNetPad *pad);
|
|
/* (3) Mouse policy. Only P1 (s == 0) is ever offered to it. */
|
|
void (*mouse_reset)(void *ctx);
|
|
void (*mouse_fold)(void *ctx, int connected, int analog, uint16_t buttons,
|
|
uint8_t *rx, uint8_t *ry);
|
|
/* (1) Host extras of port `s`: PSX_MOD_PAD_HOST_* flags and LT/RT
|
|
* 0..255. NULL = none (all zero). Queried only when a transform exists. */
|
|
void (*host_extras)(void *ctx, int s, uint32_t *flags, uint32_t *lt,
|
|
uint32_t *rt);
|
|
/* (2b) Title transform: mod_pad_transform_run semantics (0 = none,
|
|
* 1 = deliver *out; `stock` is the pass-through). NULL = no stage. */
|
|
int (*pad_transform)(void *ctx, int s, const PSXModPadFrame *frame,
|
|
const PSXModPadOutput *stock, PSXModPadOutput *out);
|
|
/* (1) Host pad of port `s` before presentation: buttons without the
|
|
* digital stick->D-pad fold and the real sticks, whatever the configured
|
|
* mode. Queried only for the transform frame of a digital stage-1 pad
|
|
* with no source; 0 = unavailable (the frame keeps the stock pad). */
|
|
int (*host_pad)(void *ctx, int s, uint16_t *buttons, uint8_t st[4]);
|
|
} PadExtHooks;
|
|
|
|
/* Resolve one port. Returns 1 = deliver *out, 0 = no device/source here. */
|
|
int pad_ext_resolve(const PadExtHooks *h, int s, PsxNetPad *out);
|
|
|
|
/* Host conditions under which NO external input (mouse capture) may be live.
|
|
* Mirrors the gates every other local-only feature obeys. 1 = live. */
|
|
typedef struct PadExtGate {
|
|
int injected_input; /* debug-server set_input / axis override */
|
|
int headless;
|
|
int netplay_active;
|
|
int netplay_resim; /* rollback resimulation */
|
|
int selfcheck_locked; /* selfcheck record/replay input lock */
|
|
int selfcheck_resim;
|
|
int render_pass; /* eye / extra render pass */
|
|
int savestate_menu_open;
|
|
int rewind_open;
|
|
int input_guard; /* savestate input guard armed */
|
|
int ui_capture; /* host overlay owns input (host_overlay.h P3) */
|
|
} PadExtGate;
|
|
int pad_ext_live(const PadExtGate *g);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|