Known Issues
Errors in the console after installation
Try performing a clean (re)installation of the asset:
Remove any objects containing the HTrace AO script from the scene, or open a scene that doesn't contain such objects.
Remove the HTrace AO Renderer Feature from the Renderer (for URP pipeline).
Delete the asset.
Reload the Unity Editor.
Reinstall the asset.
Right-click the folder containing the asset files and choose "Reimport".
Clear the console log if necessary.
Unstable RTAO with TAA enabled (URP)
RTAO mode produces flickering / jittering when Unity's TAA is enabled.
Solution: Increase the Max Ray Bias parameter.
Objects leave trails (URP, Forward)
Solution: enable Depth Priming mode in URP Render Data.
Effect isn't visible in build (URP)
This is a known URP shader stripping problem. If URP doesn't detect its own native SSAO render feature, it assumes Ambient Occlusion is not needed at all and strips it from all shaders.
Solution:
Create a second Universal Renderer Data.
Add the native SSAO Renderer Feature to it.
Add this second Renderer Data to the Renderer List in your URP asset.
Make your original Renderer Data (the one without the SSAO Render Feature) default.
Scene view flickers (BIRP)
Scene view goes black / flickers when HTrace AO is active, but Game view works without issues.
Solution: Make sure you have added the AO script as instructed in the Quick-Start guide. If added directly to camera it will lead to incorrect results.
Effect isn't working in the Scene window (BIRP)
In the BIRP pipeline, ambient occlusion output is disabled in the Scene view. Use the Game view to inspect the effect's appearance
Moving objects flicker in the Scene window
In the HDRP and URP pipelines, Unity does not write object motion vectors in the Scene view. As a result, moving objects may fail to accumulate correct ambient occlusion.
Installation into a project with WSGI overwrites files (HDRP)
In rare cases, trying to import the asset into a project where the HTrace: World Space Global Illumination asset is already installed (and vice versa) may result in a wrong merge / file replacement due to Unity's asset importer issues.
Solution: first unpack the asset to a separate project and then manually copy the folder with the asset to the project where HTrace WSGI is installed.
Last updated