mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 02:11:36 -04:00
Shokunin
67 lines
2.7 KiB
C
67 lines
2.7 KiB
C
#pragma once
|
|
/* quality_tier.h -- graphics preset autodetection (docs/QUALITY_PRESETS.md).
|
|
*
|
|
* Pure policy: describe the host (CPU, cores, RAM, GPU name, Steam Deck)
|
|
* and get the preset a title's [quality.*] tables should start from. The
|
|
* probes that fill PsxHostInfo live in quality_probe.c; this file does no
|
|
* I/O so the rules are unit-testable (tests/test_quality_tier.c). */
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
enum {
|
|
PSX_QUALITY_LOW = 0,
|
|
PSX_QUALITY_MEDIUM = 1,
|
|
PSX_QUALITY_HIGH = 2,
|
|
PSX_QUALITY_ULTRA = 3,
|
|
PSX_QUALITY_COUNT = 4,
|
|
PSX_QUALITY_CUSTOM = 4, /* the player changed a preset-governed setting */
|
|
PSX_QUALITY_NONE = -1
|
|
};
|
|
|
|
typedef struct PsxHostInfo {
|
|
char cpu[128]; /* CPU brand string ("Apple M1", "AMD Custom APU 0405") */
|
|
char gpu[128]; /* GPU name ("NVIDIA GeForce RTX 4080 SUPER"); "" unknown */
|
|
char gpu_id[32]; /* stable id used for the fingerprint when gpu is unknown */
|
|
int logical_cores; /* 0 unknown */
|
|
uint64_t ram_mb; /* 0 unknown */
|
|
int steam_deck; /* 1: Steam Deck hardware (DMI / SteamDeck env) */
|
|
} PsxHostInfo;
|
|
|
|
/* "low" .. "ultra", "custom"; NULL for anything else. */
|
|
const char *psx_quality_name(int tier);
|
|
/* Case-insensitive; PSX_QUALITY_NONE when unknown. */
|
|
int psx_quality_from_name(const char *name);
|
|
|
|
/* The preset this host should start from, and one line saying why
|
|
* ("AMD integrated GPU: Low"). Recognised hardware: Low or Ultra. Unknown
|
|
* GPU: Medium. Never High (manual only). The caller maps the result onto the
|
|
* title's offered presets with psx_quality_pick_offered. */
|
|
int psx_quality_classify(const PsxHostInfo *h, char *reason, size_t reason_cap);
|
|
|
|
/* Nearest preset the title offers (bit i of offered_mask = tier i): the
|
|
* highest offered tier <= want, else the lowest offered above it. NONE when
|
|
* the mask is empty. */
|
|
int psx_quality_pick_offered(int want, unsigned offered_mask);
|
|
|
|
/* 16 hex digits identifying CPU, core count, RAM (to the GB) and GPU, so a
|
|
* new machine or GPU triggers a fresh detection. Driver updates do not. */
|
|
void psx_quality_fingerprint(const PsxHostInfo *h, char out[17]);
|
|
|
|
/* quality_probe.c: OS facts only (CPU brand, threads, RAM, Windows/macOS
|
|
* GPU name, Linux GPU PCI id, Steam Deck DMI). Cheap; runs every launch. */
|
|
void psx_quality_probe_host(PsxHostInfo *h);
|
|
/* GL_RENDERER from a hidden 1x1 window; needs SDL video initialised.
|
|
* 1 on success. Only for a due detection with no OS GPU name. */
|
|
int psx_quality_probe_gl_renderer(char *out, size_t cap);
|
|
|
|
/* Human summary for the launcher: "Apple M1 · 8 cores · 8 GB". */
|
|
void psx_quality_summary(const PsxHostInfo *h, char *out, size_t cap);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|