Skip to content

A post-processing shader add-on for Kerbal Space Program

License

Notifications You must be signed in to change notification settings

DGerry83/CinematicShaders

Repository files navigation

Cinematic Shaders main banner showing the raw GTAO effect on one side and composited scene on the other A shader mod for Kerbal Space Program 1.12 - GTAO currently available, more planned...

Available Shaders

  • GTAO (Ground-Truth Ambient Occlusion) – Horizon-based occlusion with normal-aware filtering

Screenshots and Comparisons

A screenshot comparing "no Ambient Occlusion" to the GTAO effect provided by the mod A screenshot comparing "MSVO" to the GTAO effect provided by the mod Note that GTAO may not provide the more dramatic, soft shadows MSVO can - you can enable both, and use both, if you want! MSVO exposed by TUFX for KSP. A screenshot comparing Marty Mcfly's MXAO to the GTAO effect provided by the mod Here you can see the difference between Cinematic Shaders GTAO and the AO provided through ReShade and the MXAO shader. The MXAO shader is an amazing piece of work, it can provide GTAO across a wide array of titles. The comparison here is to highlight the fact that it's easier to pull off the effect in-engine because you can get the right data from the engine directly. MXAO rebuilds that data after the fact, inferring it from the scene - a huge technical hurdle I didn't have to cross.

Requirements

  • KSP 1.12.x
  • Deferred – Required for effects to function.

Installation

Unzip the archive into your Kerbal Space Program/ folder.

The folder structure should be: GameData/CinematicShaders/

Usage

  1. Open UI: Click the wireframe sphere icon on the toolbar
  2. Enable: Check "Enable Ground-Truth AO" in the GTAO tab (only functional if Deferred is installed)
  3. Adjust:
    • Radius: Search distance for occluders (0.5m–10m)
    • Intensity: Shadow strength multiplier (0.0–2.0)
    • Shadow Spread: Maximum pixel radius for shadows
    • Quality: Preset controlling sample count (Low/Ultra)
  4. Debug: Use the "Debug Visualization" dropdown for Raw AO or normal buffer inspection

Known Issues

There's currently an issue with the AO processing that I'll detail in a separate KnownIssues.md file. It affects the overall rendering and may be more noticeable in some scenes than others.

License

MIT License – See included LICENSE.txt file.

Credits

  • GTAO implementation based on XeGTAO

About

A post-processing shader add-on for Kerbal Space Program

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors