Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.Sign up
The Contact Shadows Volume Override specifies properties which control the behavior of Contacts Shadows. Contact Shadows are shadows that HDRP ray marches in screen space inside the depth buffer. The goal of using Contact Shadows is to capture small details that regular shadow mapping algorithms fail to capture.
To use Contact Shadows in your Scene, you must enable them for your Cameras. In the Inspector for your HDRP Asset, go to the Default Frame Settings > Lighting Section and enable the Contact Shadows checkbox. All Cameras now render Contact Shadows unless you override a Camera’s Frame Settings.
You can enable Contact Shadows on a per Light basis for Directional, Point, and Spot Lights. Tick the Enable checkbox under the Contact Shadows drop-down in the Shadows section of each Light to indicate that HDRP should calculate Contact Shadows for that Light.
Only one Light can cast Contact Shadows at a time. This means that, if you have more than one Light that casts Contact Shadows visible on the screen, only the dominant Light renders Contact Shadows. HDRP chooses the dominant Light using the screen space size of the Light’s bounding box. A Directional Light that casts Contact Shadows is always the dominant Light.
Note: For Mesh Renderer components, setting Cast Shadows to Off does not apply to Contact Shadows.
Contact shadow have a variable cost between 0.5 and 1.3 ms on the base PS4 at 1080p.
|Enable||Enable this checkbox to make HDRP process Contact Shadows for this Volume.|
|Length||Use this slider to set the length of the rays, in meters, that HDRP uses for tracing. It also functions as the maximum distance at which the rays can captures details.|
|Distance Scale Factor||HDRP scales Contact Shadows up with distance. Use the slider to set the value that HDRP uses to dampen the scale to avoid biasing artifacts with distance.|
|Max Distance||The distance from the Camera, in Unity units, at which HDRP begins to fade Contact Shadows out to zero.|
|Fade Distance||The distance, in Unity units, over which HDRP fades Contact Shadows out when at the Max Distance.|
|Sample Count||Use this slider to set the number of samples HDRP uses for ray casting. Increasing this increases quality at the cost of performance.|
|Opacity||Use this slider to set the opacity of the Contact Shadows. Lower values result in softer, less prominent shadows.|