f9fa3eb5e8
Vertex attribute binding strides must be aligned to 4 bytes, so says MoltenVK. So we'll create the quad as R32G32_SFLOAT instead of R8G8_SNORM. Also when running a debug build of the core in a debug build of retroarch in the debugger, the dynamic linker gets very confused about which spirv-cross functions to call. The easiest way to give it a clue is to reduce the exported symbol list. Also fix the debug build on Apple. |
||
|---|---|---|
| .. | ||
| shaders_gl | ||
| README.md | ||
| rsx_dump.cpp | ||
| rsx_dump.h | ||
| rsx_intf.cpp | ||
| rsx_intf.h | ||
| rsx_lib_gl.cpp | ||
| rsx_lib_gl.h | ||
| rsx_lib_vulkan.cpp | ||
| rsx_lib_vulkan.h | ||
RSX API and OpenGL 3.3 Renderer
RSX API
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.
OpenGL 3.3 Renderer
The OpenGL renderer is currently implemented in rsx_lib_gl.cpp and can be called via the functions exposed in rsx_lib_gl.h.
Building
The RSX API and 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/
Credits
The OpenGL renderer was originally authored by simias as a port/plugin of Rustation's GL renderer to Beetle PSX.