mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 18:25:35 -04:00
Matthew Stanley
fe42da2744
Keeps both lines: master's PGXP session, draw-distance clamps, masked rejects and saturated-winding NCLIP; the release's render-pass kit additions, verified media/disc extents, timeline/present rings, cull-scale sites. Overlay ABI v30. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
62 lines
2.6 KiB
C
62 lines
2.6 KiB
C
/* code_provider.h — the backend-agnostic code-production seam.
|
|
*
|
|
* One interface the overlay capture/dispatch spine talks to instead of calling
|
|
* a specific backend directly. The validated gcc/tcc spawn->DLL->rescan path is
|
|
* its implementation. Everything that makes overlays correct — content-keyed
|
|
* multi-candidate dispatch, per-call live-byte validation, the self-mod
|
|
* blacklist, the coverage manifest — is backend-blind.
|
|
*
|
|
* Production is BATCH / ASYNC (request / busy / poll_main): kicked by the
|
|
* autocapture tick, spawns a compiler off-thread, applied later via a cache
|
|
* rescan on the emu thread. Seconds of latency; many fragments per run. A
|
|
* provider sets the hooks it supports and leaves the rest NULL; callers
|
|
* null-check before invoking.
|
|
*
|
|
* (The in-process sljit JIT provider — a synchronous on-miss producer with a
|
|
* compile_fragment hook — was removed 2026-07-15; it had been disabled by
|
|
* default since 2026-06-25 due to an emitter bug. Gaps gcc/tcc have not yet
|
|
* covered fall to the interpreter, the always-safe precision-over-recall floor.)
|
|
*/
|
|
#ifndef PSXRECOMP_CODE_PROVIDER_H
|
|
#define PSXRECOMP_CODE_PROVIDER_H
|
|
|
|
#include "cpu_state.h"
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Native shard ABI — identical to overlay_loader's OverlayFn. */
|
|
typedef void (*CodeProviderFn)(CPUState *);
|
|
|
|
typedef struct CodeProvider {
|
|
const char *name; /* "gcc" (spawns gcc OR tcc) */
|
|
int (*available)(void); /* a compile cmd is configured */
|
|
|
|
/* Batch/async production (autocapture-driven). request() returns 1 if a
|
|
* compile was started. busy() is 1 while one is in flight. poll_main() runs
|
|
* on the emu thread to apply a finished compile (cache rescan). Any may be
|
|
* NULL on a provider that does not do batch production. */
|
|
int (*request)(void);
|
|
int (*busy)(void);
|
|
void (*poll_main)(void);
|
|
} CodeProvider;
|
|
|
|
/* Resolve the active backend (overlay_backend_resolve) and cache the matching
|
|
* provider. cfg_backend = [runtime] overlay_backend ("auto"|"gcc"|"tcc"|
|
|
* "auto-no-gcc", may be NULL/empty for auto); gcc_configured =
|
|
* autocompile_configured(). Call once at overlay-cache init, on the emu thread,
|
|
* before the run loop starts. */
|
|
void code_provider_init(const char *cfg_backend, int gcc_configured);
|
|
|
|
/* The active/primary provider (owns the batch path + default selection). Never
|
|
* NULL — defaults to the gcc provider before code_provider_init() runs. */
|
|
const CodeProvider *code_provider_active(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* PSXRECOMP_CODE_PROVIDER_H */
|