beetle-psx-libretro/rsx

RSX API and RSX OpenGL Renderer

The RSX API is the means by which components of the Beetle PSX libretro core interface with the hardware renderers. The RSX API offers two general classes of functions for the core. The first class consists of various functions used to perform libretro-specific actions such as reading core options or preparing/finalizing the current emulation loop frame. The second class of functions consists of RSX interface functions that the emulated PSX GPU uses to issue commands to the hardware renderer. Not every emulated PSX GPU command has a corresponding RSX interface function, but the set of available functions can be extended or modified as necessary when bugs are discovered and higher accuracy is required.

Each unique hardware renderer will implement RSX interface functions as another layer of function calls, typically but not necessarily one per RSX interface function. The RSX interface should then select the correct function to call based on the currently running hardware renderer.

The RSX API also includes support for dumping RSX API calls to file, which can be utilized for debugging purposes by any renderers that implement RSX playback.

The RSX OpenGL renderer is currently implemented alongside the RSX API in rsx_intf.cpp. OpenGL renderer functions are prefixed with rsx_gl.

Building

The RSX API and RSX OpenGL renderer are components of the Beetle PSX libretro core. To build with OpenGL support, run make HAVE_OPENGL=1 in the repository's top level directory. To build with all possible hardware renderers, instead run make HAVE_HW=1. To build with dump support, additionally pass RSX_DUMP=1.

Coding Style

The preferred coding style for the rsx subdirectory is the libretro coding style. See: https://docs.libretro.com/development/coding-standards/