mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 10:19:47 -04:00
Matthew Stanley
218 lines
9.9 KiB
C
218 lines
9.9 KiB
C
/* internal_resolution.h — the internal resolution: presets, their ids (the
|
|
* game.toml [video] internal_resolution spellings and the built-in Internal
|
|
* Resolution mod's option values), and the integer scale each one asks the
|
|
* renderer for.
|
|
*
|
|
* Pure (no SDL, no GL) so the config loader, the mod plugin and a test can
|
|
* use it.
|
|
*
|
|
* VALUE ENCODING:
|
|
* 0 unset: the legacy [video] supersampling factor stands
|
|
* 1 native (1x)
|
|
* -1 match display: the target is the monitor's pixel height
|
|
* -2 auto: Match display as the ceiling with dynamic resolution on (the
|
|
* scale steps down to the title's dynamic_resolution_min floor only
|
|
* while the game would miss frames). Every scale helper below resolves
|
|
* it exactly like Match display; only the dynamic-resolution switch
|
|
* differs, and that is the caller's (psx_ir_is_auto).
|
|
* N (N >= 2) a target output height in lines (720, 1080, ... or a
|
|
* legacy "Nx" entry expressed as reference_lines * N)
|
|
*
|
|
* SCALE. The renderer only does integer scales (the pack of the hr surface
|
|
* back to native VRAM is exact only then), so a target height becomes
|
|
* S = ceil(target_lines / reference_lines)
|
|
* clamped to [1, s_max]. reference_lines is the title's usual display height
|
|
* ([video] resolution_reference_lines, default 240): R4's races are 320x240,
|
|
* so 1080p is S = 5 (1200 lines, area-resolved to 1080) and 4K is S = 9.
|
|
* A 480-line mode (interlaced menus) renders at twice the target and is
|
|
* resolved down. The backend then clamps S again to what it can allocate. */
|
|
#pragma once
|
|
|
|
#include <stddef.h>
|
|
|
|
#define PSX_IR_UNSET 0
|
|
#define PSX_IR_NATIVE 1
|
|
#define PSX_IR_DISPLAY (-1)
|
|
#define PSX_IR_AUTO (-2)
|
|
#define PSX_IR_DEFAULT_REF_LINES 240
|
|
/* Custom line counts accepted from config (a 16K panel is 8640 lines). */
|
|
#define PSX_IR_MIN_LINES 2
|
|
#define PSX_IR_MAX_LINES 8640
|
|
|
|
typedef struct PsxIrPreset {
|
|
const char *id; /* stable id: game.toml and the mod option value */
|
|
const char *label; /* display label (the mod option's) */
|
|
int value; /* encoding above */
|
|
} PsxIrPreset;
|
|
|
|
static const PsxIrPreset k_psx_ir_presets[] = {
|
|
{ "native", "Native", PSX_IR_NATIVE },
|
|
{ "720p", "720p", 720 },
|
|
{ "1080p", "1080p", 1080 },
|
|
{ "1440p", "1440p", 1440 },
|
|
{ "4k", "4K", 2160 },
|
|
{ "5k", "5K", 2880 },
|
|
{ "8k", "8K", 4320 },
|
|
{ "display", "Match display", PSX_IR_DISPLAY },
|
|
{ "auto", "Auto", PSX_IR_AUTO },
|
|
};
|
|
#define PSX_IR_PRESET_COUNT ((int)(sizeof(k_psx_ir_presets) / sizeof(k_psx_ir_presets[0])))
|
|
|
|
static inline int psx_ir_lower_eq(const char *a, const char *b) {
|
|
for (; *a && *b; a++, b++) {
|
|
char ca = (*a >= 'A' && *a <= 'Z') ? (char)(*a - 'A' + 'a') : *a;
|
|
if (ca != *b) return 0;
|
|
}
|
|
return *a == 0 && *b == 0;
|
|
}
|
|
|
|
/* 1 if value is a legal encoding (unset excluded). */
|
|
static inline int psx_ir_value_valid(int value) {
|
|
return value == PSX_IR_NATIVE || value == PSX_IR_DISPLAY || value == PSX_IR_AUTO ||
|
|
(value >= PSX_IR_MIN_LINES && value <= PSX_IR_MAX_LINES);
|
|
}
|
|
|
|
/* Auto: Match display with dynamic resolution on. */
|
|
static inline int psx_ir_is_auto(int value) { return value == PSX_IR_AUTO; }
|
|
|
|
/* The fixed target a value renders at, its ceiling for Auto: Auto resolves
|
|
* as Match display, everything else as itself. */
|
|
static inline int psx_ir_ceiling(int value) {
|
|
return value == PSX_IR_AUTO ? PSX_IR_DISPLAY : value;
|
|
}
|
|
|
|
/* Parse a persisted value: a preset id (case-insensitive, "auto" included) or
|
|
* a decimal line count in [PSX_IR_MIN_LINES, PSX_IR_MAX_LINES]. Returns 1 and
|
|
* stores the value on success; 0 for anything else (the caller keeps its
|
|
* default). A dynamic-resolution floor is a fixed height: its callers reject
|
|
* PSX_IR_AUTO themselves. */
|
|
static inline int psx_ir_parse(const char *s, int *out) {
|
|
if (!s || !*s) return 0;
|
|
for (int i = 0; i < PSX_IR_PRESET_COUNT; i++)
|
|
if (psx_ir_lower_eq(s, k_psx_ir_presets[i].id)) { *out = k_psx_ir_presets[i].value; return 1; }
|
|
long v = 0;
|
|
const char *p = s;
|
|
while (*p >= '0' && *p <= '9') { v = v * 10 + (*p - '0'); p++; if (v > PSX_IR_MAX_LINES) return 0; }
|
|
if (p == s || *p) return 0;
|
|
if (v < PSX_IR_MIN_LINES) return 0; /* a number is always lines, never "1 = native" */
|
|
*out = (int)v;
|
|
return 1;
|
|
}
|
|
|
|
/* The preset id for a value, or NULL for a custom line count (persist those
|
|
* as an integer). */
|
|
static inline const char *psx_ir_id_for(int value) {
|
|
for (int i = 0; i < PSX_IR_PRESET_COUNT; i++)
|
|
if (k_psx_ir_presets[i].value == value) return k_psx_ir_presets[i].id;
|
|
return NULL;
|
|
}
|
|
|
|
static inline const char *psx_ir_label_for(int value) {
|
|
for (int i = 0; i < PSX_IR_PRESET_COUNT; i++)
|
|
if (k_psx_ir_presets[i].value == value) return k_psx_ir_presets[i].label;
|
|
return NULL;
|
|
}
|
|
|
|
/* Unclamped scale a value asks for. display_px_h <= 0 (unknown) makes Match
|
|
* display 1 until the caller can measure the monitor. */
|
|
static inline int psx_ir_scale_for(int value, int ref_lines, int display_px_h) {
|
|
if (ref_lines < 1) ref_lines = PSX_IR_DEFAULT_REF_LINES;
|
|
value = psx_ir_ceiling(value);
|
|
int target;
|
|
if (value == PSX_IR_DISPLAY) target = display_px_h;
|
|
else if (value >= PSX_IR_MIN_LINES) target = value;
|
|
else return 1; /* native / unset */
|
|
if (target <= ref_lines) return 1;
|
|
return (target + ref_lines - 1) / ref_lines;
|
|
}
|
|
|
|
/* The scale to request: psx_ir_scale_for clamped to [1, s_max]. */
|
|
static inline int psx_resolve_internal_scale(int value, int ref_lines,
|
|
int display_px_h, int s_max) {
|
|
int s = psx_ir_scale_for(value, ref_lines, display_px_h);
|
|
if (s_max >= 1 && s > s_max) s = s_max;
|
|
return s < 1 ? 1 : s;
|
|
}
|
|
|
|
/* ---- Supersample ([video] supersample, PSX_SUPERSAMPLE) ----------------------
|
|
* A factor on the TARGET of a line-count preset or Match display, in
|
|
* thousandths (1000 = 1.0, the historical behaviour; range 1000..4000). The
|
|
* renderer already area-resolves an internal image taller than the output, so
|
|
* asking for 2x the display's lines is ordered-grid SSAA of the whole frame:
|
|
* Match display at 1080 px with 2.0 renders 2160 lines (S = 9) and resolves
|
|
* to 1080. Native and the legacy integer factor are left alone. Dynamic
|
|
* resolution takes the result as its ceiling and steps under it as usual. */
|
|
#define PSX_SS_MILLI_MIN 1000
|
|
#define PSX_SS_MILLI_MAX 4000
|
|
|
|
static inline int psx_ss_milli_clamp(int m) {
|
|
return m < PSX_SS_MILLI_MIN ? PSX_SS_MILLI_MIN
|
|
: m > PSX_SS_MILLI_MAX ? PSX_SS_MILLI_MAX : m;
|
|
}
|
|
|
|
/* "1.5", "2", "2x" -> 1500, 2000, 2000. 0 for anything else. */
|
|
static inline int psx_ss_parse_milli(const char *s) {
|
|
if (!s || !*s) return 0;
|
|
long whole = 0, frac = 0, div = 1;
|
|
const char *p = s;
|
|
while (*p >= '0' && *p <= '9') { whole = whole * 10 + (*p - '0'); p++; if (whole > 100) return 0; }
|
|
if (p == s) return 0;
|
|
if (*p == '.') { p++; while (*p >= '0' && *p <= '9') { if (div < 1000) { frac = frac * 10 + (*p - '0'); div *= 10; } p++; } }
|
|
if (*p == 'x' || *p == 'X') p++;
|
|
if (*p) return 0;
|
|
long m = whole * 1000 + frac * (1000 / div);
|
|
if (m < PSX_SS_MILLI_MIN || m > PSX_SS_MILLI_MAX) return 0;
|
|
return (int)m;
|
|
}
|
|
|
|
/* Opt-in display policy; keep the saved factor intact for smaller displays. */
|
|
static inline int psx_ir_display_supersample(int ss_milli, int display_px_h,
|
|
int disable_at_lines) {
|
|
return disable_at_lines > 0 && display_px_h >= disable_at_lines
|
|
? PSX_SS_MILLI_MIN : ss_milli;
|
|
}
|
|
|
|
/* psx_resolve_internal_scale with the supersample factor on the target. */
|
|
static inline int psx_resolve_internal_scale_ss(int value, int ref_lines,
|
|
int display_px_h, int s_max,
|
|
int ss_milli) {
|
|
ss_milli = psx_ss_milli_clamp(ss_milli);
|
|
value = psx_ir_ceiling(value);
|
|
if (ss_milli != PSX_SS_MILLI_MIN) {
|
|
if (value == PSX_IR_DISPLAY) {
|
|
if (display_px_h > 0)
|
|
display_px_h = (int)(((long long)display_px_h * ss_milli + 999) / 1000);
|
|
} else if (value >= PSX_IR_MIN_LINES) {
|
|
long long t = ((long long)value * ss_milli + 999) / 1000;
|
|
value = t > 4LL * PSX_IR_MAX_LINES ? 4 * PSX_IR_MAX_LINES : (int)t;
|
|
}
|
|
}
|
|
return psx_resolve_internal_scale(value, ref_lines, display_px_h, s_max);
|
|
}
|
|
|
|
/* A Match display cap bounds the final target, including supersampling.
|
|
* Fixed presets and the legacy integer scale retain their own ceilings. */
|
|
static inline int psx_resolve_internal_scale_ss_cap(int value, int ref_lines,
|
|
int display_px_h, int s_max, int ss_milli, int max_display_lines) {
|
|
int s = psx_resolve_internal_scale_ss(value, ref_lines, display_px_h, s_max, ss_milli);
|
|
if (psx_ir_ceiling(value) == PSX_IR_DISPLAY && max_display_lines > 0) {
|
|
int cap = psx_resolve_internal_scale(max_display_lines, ref_lines, 0, s_max);
|
|
if (s > cap) s = cap;
|
|
}
|
|
return s;
|
|
}
|
|
|
|
/* ---- Dynamic resolution floor ([video] dynamic_resolution_min) -------------
|
|
* A preset or line count resolves as usual. "display" (PSX_IR_DISPLAY) is the
|
|
* output's own lines: the selected internal resolution WITHOUT the supersample
|
|
* factor (Match display = the monitor's pixel height). With supersample > 1
|
|
* the controller then trades only supersampling and never drops below the
|
|
* output. Clamped to [1, ceiling]. */
|
|
static inline int psx_dynres_floor_scale(int min_value, int selected_ir, int ref_lines,
|
|
int display_px_h, int ceiling) {
|
|
const int v = (min_value == PSX_IR_DISPLAY && selected_ir != PSX_IR_UNSET)
|
|
? psx_ir_ceiling(selected_ir) : min_value;
|
|
int s = psx_resolve_internal_scale(v, ref_lines, display_px_h, ceiling);
|
|
return s > ceiling ? ceiling : s;
|
|
}
|