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. 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.