Troubleshooting
intermediate troubleshootingEdge Fusion (HDRP) · Troubleshooting & FAQ
Solutions to common issues when setting up or using Edge Fusion in HDRP projects.
Effect Not Visible
| Possible Cause | Solution |
|---|---|
| Custom Pass not added | Verify a Custom Pass Volume exists in the scene with the Edge Fusion pass added to its list. |
| Intensity is 0 | Set Intensity to 1 in the Edge Fusion pass settings. |
| Wrong Injection Point | Set the injection point to After Opaque And Sky or Before Transparent. Other injection points may not have the required depth data. |
| Blend Layers exclude target objects | Check that the objects you want blended are on a layer included in Blend Layers. |
| Volume mode is Local but camera is outside | If using Local mode, ensure the camera is inside the volume's collider trigger, or switch to Global. |
Blending Looks Wrong or Produces Artifacts
| Symptom | Solution |
|---|---|
| Banding or repetitive patterns | Enable Jitter and activate TAA on the camera to smooth sampling noise. |
| Blending bleeds light into shadows | Increase the Shadow Protection threshold to prevent the effect from adding lighting over shadowed areas. |
| Excessive blur at close range | Lower the Max Screen Radius value to cap on-screen blur extent. |
| Double-sided meshes not blending | Add the mesh's layer to Double-Sided Layers under Additional Object Groups. |
| Animated vegetation not blending | Add the vegetation layer to Special Group Layers under Additional Object Groups. |
Terrain Issues
| Symptom | Solution |
|---|---|
| Terrain does not blend with objects | Terrains using Draw Instanced are not supported directly. Exclude the terrain layer from Blend Layers and keep Blend With Others enabled. Edge Fusion will reconstruct terrain data from the camera depth texture. |
Performance Issues
| Symptom | Solution |
|---|---|
| Low frame rate | Reduce Sample Count, lower Early Exit Hits, and decrease Max Blend Distance. See Performance Tips. |
| GPU spikes with Jitter enabled | Jitter breaks cache locality. Lower sample count when using Jitter, or disable it if TAA is not active. |
If your issue is not listed here, visit our support forum or contact support.
Was this page helpful?
Suggest an improvement
Help us improve this documentation page.