reshade accessibility shaders

visual post-processing effects to aid people with visual disabilities in playing 3d games

about

these effects were the project for my bachelors thesis and have been made in collaboration with inclusive gaming. they have been developed for and are so far only tested with the game Doom (2016), but they should work with other games aswell. the effects are experimental and not all of them work perfectly.

effects include:

• outlines around objects
• lines highlighting geometric edges
• colored highlight of horizontal, potentially walkable, surfaces
• high-contrast crosshair
• zoom for HUD (very experimental)

all of these can be mixed and matched aswell as further customized individually.

usage

installation

1. download and install reshade for your game. as of writing, only version 6.3.3 is verified to work with Doom and it's demo version. with other games the latest version might work aswell. make sure to choose the graphics-api used by your game. for Doom, OpenGL is recommended, this also has to be set in the advanced graphics settings.
2. clone this repository or download it as a zip (unpack before the next step)
3. place the whole directory or its contents in reshade-shaders/ in your games directory. unless reshade is set up otherwise, reshade-shaders/ needs to contain the Shaders and Textures directories.

configuration

0. when starting the game you should see a message from reshade at the top of the screen, this means it has successfully loaded. any errors will appear in red.
1. after loaded into a game, press home to open the menu and configure the effects
2. load the provided preset profile from Accessibility.ini
3. if the outline effects do not line up with the objects displayed by your game, some setup may still be required

• if a resolution scale has been set in the game's graphics settings, set the preprocessor definition RESOLUTION_SCALE under Preset to the percentage set there (integer number)
• if the outlines appear to be upside down, add or remove the preprocessor definition DEPTH_UPSIDE_DOWN under Preset (does not require a value)

4. when configuring the effects or setting them up manually, make sure they stay in the right order. HUD top should be first in the list, Combine needs to come after most other effects, HUD bottom needs to follow that and Crosshair should be the last effect

development

editing the shaders is completely possible in the reshade overlay by right-clicking any effect you want to edit and choosing the file to edit. however using a text editor or IDE is recommended for eadier development. Visual Studio Code with the HLSL Tools extension is good for this.

documentation for the reshade shader language can be found here

contributions

modifications and development is always welcome. pull requests can always be made, but i will not commit to keeping up with maintaining this repository. feel free to make your own fork of the project!

license

this project is licensed under GPL-3.0, that means:

• you are free to make any changes and re-distribute the project
• use of this for commercial purposes is permitted
• you must credit the original author(s), aswell as use the same license
• the license does not include any liability or warranties

for full details read the license text