From 08915f9612df861e291bc9dd72c16d2a291185c5 Mon Sep 17 00:00:00 2001 From: Nico de Poel Date: Wed, 14 Jun 2023 11:50:47 +0200 Subject: [PATCH] Updated readme with a section about the custom post-processing V2 package. --- README.md | 16 ++++++++++++++++ images/ppv2layer.png | Bin 0 -> 55725 bytes 2 files changed, 16 insertions(+) create mode 100644 images/ppv2layer.png diff --git a/README.md b/README.md index df6f461..16e73f8 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,8 @@ Focus of this project lies initially on making FSR2 work with the traditional Un - [Requirements](#requirements) - [Integration](#integration) + - [Built-in Render Pipeline](#built-in-render-pipeline) + - [Post-Processing Stack V2](#post-processing-stack-v2) - [Callbacks](#callbacks) - [Resource management](#resource-management) - [Mipmap biasing](#mipmap-biasing) @@ -63,6 +65,8 @@ Note that OpenGL on MacOS does not support compute shaders, so it will never be Integration generally follows the same guidelines as the [FSR2 documentation on Github](https://github.com/GPUOpen-Effects/FidelityFX-FSR2#integration-guidelines), with a few specifics for the Unity implementation. +### Built-in Render Pipeline + To apply FSR2 to a camera, simply add the `Fsr2ImageEffect` script to your camera game object. It should be placed at the bottom of the components list, to ensure that it's the last image effect in the chain. ![Simple Camera Setup](images/camera-simple.png) @@ -75,6 +79,18 @@ If you have any other post-processing effects on your camera that make use of th Also make sure that any other anti-aliasing methods (MSAA, FXAA, SMAA, TAA) are disabled when enabling FSR2. +### Post-Processing Stack V2 + +FSR2 for Unity is also available as a full integration into the Post-Processing Stack V2 (PPV2) from Unity. This integration gets closer to the ideal placement in the render pipeline [as recommended by the FSR2 documentation](https://github.com/GPUOpen-Effects/FidelityFX-FSR2#placement-in-the-frame). The post-processing effects from PPV2 are split into groups before and after upscaling, meaning that effects that should be applied at full resolution (e.g. film grain, bloom, depth of field, motion blur) are indeed applied on the full resolution upscaled image. + +Post-Processing Stack V2 with FSR2 is intended to be used as a drop-in replacement package for the official PPV2 package from Unity. It can be [downloaded from the Releases page](https://github.com/ndepoel/FSR2Unity/releases/latest) and should be extracted into the `Packages` directory of your project. From there it will automatically get picked up by Unity when you refresh your project. + +When the package is installed correctly, FSR2 should appear as an Anti-aliasing Mode on the Post-process Layer component: + +![FSR2 Anti-aliasing Mode](images/ppv2layer.png) + +From here you can configure the usual FSR2 settings, including quality mode, sharpness, exposure and reactive mask. + ### Callbacks FSR2 for Unity requires the application to provide a few services that it can't make any assumptions about itself. For this purpose, it exposes an `IFsr2Callbacks` interface with a default implementation `Fsr2CallbacksBase`. The application can provide these callbacks by either implementing the `IFsr2Callbacks` interface or inheriting the `Fsr2CallbacksBase` class and overriding one or more methods. Assign these callbacks to the `Callbacks` property on the `Fsr2ImageEffect` script component, before the script is enabled. diff --git a/images/ppv2layer.png b/images/ppv2layer.png new file mode 100644 index 0000000000000000000000000000000000000000..7904d1c46cc89be333d4cfef1c83d87be9323c40 GIT binary patch literal 55725 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 Axc~qF literal 0 HcmV?d00001