ShuriZma
/
RetroArch
mirror of https://github.com/libretro/RetroArch.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

begin updates pre-migration to libretro-docs

markwkidd 2017-09-11 20:17:08 -04:00
parent d804174bf6
commit 00457135c3
1 changed files with 1 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
RGUI.md

@ -96,42 +96,6 @@ You can then browse for a ROM with `Load Game`. To control where RGUI starts to
The browser will filter out extensions for the last core set in `Core`, and use that core when a ROM is loaded. If `libretro_path` in config is set with a full path to a core, this core is automatically selected once RGUI boots up (but you can still change the core afterwards).
### Loading game from history
As ROMs are loaded, ROM and libretro core combinations are saved to history.
To load these recently loaded games, use `Load Game (History)`.
The history is saved to a file in same directory as RetroArch config file. If no config file was loaded in startup, history will not be saved or loaded, and will not exist in the main menu.
The format of this history file is a simple plaintext file with format:
rom-path1
libretro-core-path1
core-name1
rom-path2
libretro-core-path2
core-name2
...
If rom-path is blank (just a newline), RetroArch will attempt to load the core without a game.
#### Old format consideration
The old format for history was `rom-path1;libretro-core-path1;core-name1`.
However, this was found to be a bad idea as ';' is a valid path name.
The behavior was fixed, and RetroArch used a new default path for history files (`.retroarch-game-history.txt` instead of `.retroarch-history.txt`). To convert to the new format, just rename the old history file, and replace ';' with newlines directly.
## Configuring shaders
RGUI allows you to mix and match various shaders with arbitrary (up to 8) shader passes,
with custom hardware filters and scale factors.
### Downloading shaders
Shaders are user-supplied, and therefore not shipped with RetroArch on PC.
We maintain a fairly large repository of various shaders in [common-shaders](https://github.com/libretro/common-shaders). You can download a .zip of the repo on Github.
### Important Notice on XML shaders
While RetroArch supports XML shaders in .shader format, they are deprecated as of 0.9.9-wip1. They will still be supported as before (in `video_shader`), but they are considered second class citizen now.
RGUI does not support mixing and matching with XML shaders as they don't fit well into a mixing and matching scenario. Cg shaders (.cg), and straight GLSL formats (.glsl) are supported. Their multi-pass preset variants (.cgp for Cg, .glslp for GLSL) are also supported.
### Applying shaders
Shader settings can be found in `Video Options`. The fundamental options are:
@ -229,5 +193,4 @@ Replacing the disk inside RGUI is "physically" speaking the same as ejecting, sw
To work around this, set `Disk Index` to `No Disk`, and exit RGUI. The game will pick up that the tray has been ejected/missing disk after half a second or so. Now you can go back to RGUI, pick the correct disk index and return to the game.
### Note
This feature is still fairly new, and might change behavior over time as kinks (as noted above) are worked out.
**Note: This feature is still fairly new, and might change behavior over time as kinks (as noted above) are worked out.**