mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-28 02:56:36 -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>
93 lines
4.0 KiB
C
93 lines
4.0 KiB
C
#ifndef PSX_SEGMENT_MISS_H
|
|
#define PSX_SEGMENT_MISS_H
|
|
|
|
/* Segment misses in static game code (docs/SEGMENT_AWARE_CODE.md §5.5; §10
|
|
* decision 2: interpret loudly until the title is regenerated), and in the
|
|
* compiled BIOS (§5.4).
|
|
*
|
|
* A PC carries a segment (KUSEG 0x0..., KSEG0 0x8..., KSEG1 0xA...), and the
|
|
* game dispatch table is keyed by the full PC: each compiled body bakes the
|
|
* links, EPCs, fetch tags and store PCs of the segment it was compiled for.
|
|
* A PC whose physical word has a row only in another segment (a KSEG1 alias
|
|
* of KUSEG-linked text, a KSEG0 call into it) therefore has no body of its
|
|
* own. Dispatch interprets it through the clean-text-miss path and records it
|
|
* here, with the full PC and the row that exists, so a run names each
|
|
* (segment, entry) that needs a segment-qualified seed (§5.4). Visible over
|
|
* TCP (`segment_misses`, `dispatch_stats`) and in psx_last_run_report.json. */
|
|
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct {
|
|
uint64_t seq;
|
|
uint32_t addr; /* the PC that has no body of its own */
|
|
uint32_t home; /* the compiled row at the same physical word */
|
|
uint32_t ra;
|
|
uint32_t sp;
|
|
uint32_t frame;
|
|
uint32_t kind; /* PSX_SEGMENT_MISS_GAME or PSX_SEGMENT_MISS_BIOS */
|
|
} PsxSegmentMissEntry;
|
|
|
|
#define PSX_SEGMENT_MISS_RING_CAP 4096u /* power of two */
|
|
#define PSX_SEGMENT_MISS_UNIQUE_CAP 1024u
|
|
|
|
/* The other segment's PC with a compiled row at addr's physical word, or 0
|
|
* when there is none (addr itself is not consulted). KUSEG, KSEG0 and KSEG1
|
|
* are tried in that order. is_entry is the game dispatch's
|
|
* psx_game_is_function_entry. */
|
|
uint32_t psx_segment_miss_home(uint32_t addr, int (*is_entry)(uint32_t));
|
|
|
|
/* What a segment miss ran. GAME: static game text, interpreted at its own
|
|
* PC (§5.5). BIOS: a relocated BIOS window (kernel, shell) or the ROM entered
|
|
* in another segment than the one its body was compiled for, with no segment
|
|
* variant of its own. The BIOS dispatch is keyed by the normalized address,
|
|
* so the window's home body ran, with its own segment's links, EPCs, fetch
|
|
* tags and store PCs; the fix is a segment-qualified seed in the BIOS seeds
|
|
* file (§5.4), not in the game's. */
|
|
#define PSX_SEGMENT_MISS_GAME 0u
|
|
#define PSX_SEGMENT_MISS_BIOS 1u
|
|
|
|
/* Record one segment miss of static game code (kind GAME). */
|
|
void psx_segment_miss_record(uint32_t addr, uint32_t home, uint32_t ra,
|
|
uint32_t sp, uint32_t frame);
|
|
|
|
/* Record one segment miss of either kind. A PC keeps the kind it was first
|
|
* recorded with in the per-PC counts. */
|
|
void psx_segment_miss_record_kind(uint32_t addr, uint32_t home, uint32_t ra,
|
|
uint32_t sp, uint32_t frame, uint32_t kind);
|
|
|
|
/* The dispatch hook: dirty_ram_dispatch_inner calls this for every clean
|
|
* game-text miss (a PC in the EXE's text that no compiled body ran). It
|
|
* records a segment miss when addr has no row of its own but another
|
|
* segment's alias does, and returns that row; otherwise (addr has a row, e.g.
|
|
* its bytes diverged, or no segment has one: an interior PC) it records
|
|
* nothing and returns 0. */
|
|
uint32_t psx_segment_miss_note(uint32_t addr, int (*is_entry)(uint32_t),
|
|
uint32_t ra, uint32_t sp, uint32_t frame);
|
|
|
|
uint64_t psx_segment_miss_total(void);
|
|
uint32_t psx_segment_miss_unique(void);
|
|
|
|
/* The i-th recorded entry, i < total; only the last RING_CAP are kept. */
|
|
PsxSegmentMissEntry psx_segment_miss_get(uint64_t seq);
|
|
|
|
/* Per-PC counts, highest first: up to max rows, returns the number written.
|
|
* Counts are exact for the first UNIQUE_CAP distinct PCs; later new PCs are
|
|
* counted in the total and the ring only. Any output array may be NULL. */
|
|
uint32_t psx_segment_miss_summary(uint32_t *addrs, uint32_t *homes,
|
|
uint64_t *counts, uint32_t *kinds, uint32_t max);
|
|
|
|
/* "game" or "bios", for reports. */
|
|
const char *psx_segment_miss_kind_name(uint32_t kind);
|
|
|
|
void psx_segment_miss_reset(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* PSX_SEGMENT_MISS_H */
|