Postprocessing commands for use within Naninovel. To be used with Naninovel 1.19+
Please note that the extension won't work in projects that use URP or HDRP.
You can find information on the functions and parameters of each effect in the Effects section in the Post Processing documentation. https://docs.unity3d.com/Packages/[email protected]/manual/index.html
Notice that the ColorGrading effect has been split into three different parts: HDR, LDR and External. Check the documentation for info on which one suits you best.
Installation
- In Unity's Package Manager, click the plus sign and navigate to Add package from git URL.... If you don't have git installed, install it and restart the computer.
- Type in https://github.com/idaocracy/NaninovelPostProcess.git and it should install automatically. For 1.20 users, type in https://github.com/idaocracy/NaninovelPostProcess.git#1.20 instead.
- Follow step 3 and onwards in the old installation instructions. For 1.20 users, start from step 4.
- If "Add Post Processing Layer to Camera" is enabled, you need to add a PostProcessResources asset. You can find the built-in one by searching PostProcessResources with the All filter.
- Add the included prefabs to the list of Spawn resources. You are free to name them however you want. (Note that in the new version (V2) the extension folder is located under the Packages folder)
- Use my other extension, NaninovelSceneAssistant, or special editor tools in the spawn object inspector to modify the effect and copy the values over to the clipboard
NaninovelSceneAssistant: https://github.com/idaocracy/NaninovelSceneAssistant
NOTE: In case you want to make changes to the default settings of an effect prefab, make a copy of it and assign it to the Spawn resources instead.
Check this video for a quick guide on installation and usage:
Bloom, Chromatic Aberration, ColorGradingLDR, ColorGradingEXT and Vignette have a Texture parameter which needs to be set in the editor in prefab mode. Once you have added your textures to the list, you can refer to them by their file name.
All float, color, vector and int values can be tweened, however some effects won't tween in a seamless manner. This is a PostProcessing design issue and not related to this extension.
As with most built-in spawn effects, you can spawn multiple instances of the effect. Consider doing this to create more seamless transitions.
Example:
@despawn Bloom#1 params:2 wait:false
@spawn Bloom#2 params:2,1
Some of the effects may not be designed for lower end platforms. Be sure to profile your game to see if they're a fit. In particular, consider using Naninovel's built in Depth of Field (https://naninovel.com/guide/special-effects.html#depth-of-field-bokeh) or Blur (https://naninovel.com/guide/special-effects.html#blur) over the PostProcessing equivalent as that one seems to have the biggest impact on overall performance (and doesn't look particularly good in orthographic/2D setups)
If you need help with the extension, you can contact me on here or on Discord. I am the tech support person (only yellow username) on the official Naninovel discord.