mirror of
https://github.com/daniel-lynch/ovrplugin-openxr-shim.git
synced 2026-10-06 00:00:06 +02:00
Daniel LynchandClaude Opus 4.8
a72a79ad29
An independent reimplementation of Meta's libOVRPlugin ABI on top of OpenXR, so VrApi-era Meta Quest VR titles can run on non-Meta OpenXR runtimes (Monado, Steam Frame) instead of being locked to Meta hardware. Original code only — no Meta/Epic/Capcom binaries, headers, or assets. Includes a desktop harness that drives the shim against Monado headless. Scope/legal: interoperability; entitlement handling is out of scope. See README for the legal/scope section and docs/ for the research trail and design notes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01D6sFYGXZPsq3v7xtcDES6g
34 lines
2.1 KiB
C
34 lines
2.1 KiB
C
#ifndef PASSTHRU_H
|
|
#define PASSTHRU_H
|
|
/* P4 passthru — run the REAL (SONAME-patched) libOVRPlugin inside our app and forward
|
|
* every game-called export to it, so we can LOG native's per-eye poses/FOV/submit and
|
|
* diff them against our clean-but-ghosting values. Gate: debug.re4vr.passthru=1.
|
|
*
|
|
* All-or-nothing: the real lib owns the WHOLE session, so every export the game calls
|
|
* must forward (partial forwarding crashes mid-frame because state lives in the real
|
|
* lib). Fully-prototyped exports (core.c/layers.c) forward via PT_FWD below; the handful
|
|
* of no-arg () stubs the game also hits forward via signature-agnostic asm trampolines
|
|
* in passthru.c. See HANDOFF-2026-06-27-native-parity.md. */
|
|
|
|
int pt_active(void); /* lazily inits on first call; 1 if real lib owns the session */
|
|
void *pt_real(const char *name); /* dlsym from the real lib (NULL if !passthru or not found) */
|
|
void pt_log_call(const char *name, long ret); /* rate-limited native call census (PTC log) */
|
|
|
|
/* Forward a fully-prototyped export to the real lib and return its result, caching the
|
|
* resolved pointer per call site. Drop as the FIRST statement of each game-called export
|
|
* in core.c / layers.c. Compiles to nothing reachable when passthru is off. Logs the
|
|
* native return value (rate-limited) so we can diff the full call surface vs our shim. */
|
|
#define PT_FWD(fn, ...) do { \
|
|
if (pt_active()) { \
|
|
static __typeof__(&fn) _pt_p; static int _pt_got; \
|
|
if (!_pt_got) { _pt_p = (__typeof__(&fn))pt_real(#fn); _pt_got = 1; } \
|
|
if (_pt_p) { \
|
|
__typeof__(_pt_p(__VA_ARGS__)) _pt_r = _pt_p(__VA_ARGS__); \
|
|
pt_log_call(#fn, (long)_pt_r); \
|
|
return _pt_r; \
|
|
} \
|
|
} \
|
|
} while (0)
|
|
|
|
#endif /* PASSTHRU_H */
|