"; + + tooltip += $"Load Action: {kLoadActionNames[(int)block.load]}"; + } + + if (block.store != ResourceRWBlock.StoreAction.None) + { + if (tooltip.Length > 0) + tooltip += "
"; + + tooltip += $"Store Action: {kStoreActionNames[(int)block.store]}"; + } + if (block.usage != ResourceRWBlock.UsageFlags.None) { string resourceIconClassName = string.Empty; @@ -1334,6 +1428,66 @@ void CreateRWResourceBlockElement(int offsetPx, ResourceRWBlock block) tooltip += "
- Read is using framebuffer fetch."; if (block.usage.HasFlag(ResourceRWBlock.UsageFlags.UpdatesGlobalResource)) tooltip += "
- Updates a global resource slot."; + if (block.memoryless) + tooltip += "
- Memory usage is memoryless."; + } + + if (m_ViewOptions.HasFlag(ViewOptions.LoadStoreActions)) + { + if (block.load != ResourceRWBlock.LoadAction.None) + { + var loadActionBorder = new TriangleElement { useStyle = true }; + loadActionBorder.AddToClassList(Classes.kLoadAction); + loadActionBorder.AddToClassList(Classes.kLoadActionBorder); + + var loadAction = new TriangleElement { useStyle = true }; + loadAction.AddToClassList(Classes.kLoadAction); + + switch (block.load) + { + case ResourceRWBlock.LoadAction.Load: + loadAction.AddToClassList(Classes.kLoadActionLoad); + break; + case ResourceRWBlock.LoadAction.Clear: + loadAction.AddToClassList(Classes.kLoadActionClear); + break; + case ResourceRWBlock.LoadAction.DontCare: + loadAction.AddToClassList(Classes.kLoadActionDontCare); + break; + } + + block.element.Add(loadActionBorder); + block.element.Add(loadAction); + } + + if( block.store != ResourceRWBlock.StoreAction.None) + { + var storeActionBorder = new TriangleElement { useStyle = true }; + storeActionBorder.AddToClassList(Classes.kStoreAction); + storeActionBorder.AddToClassList(Classes.kStoreActionBorder); + + var storeAction = new TriangleElement { useStyle = true }; + storeAction.AddToClassList(Classes.kStoreAction); + + switch (block.store) + { + case ResourceRWBlock.StoreAction.Store: + storeAction.AddToClassList(Classes.kStoreActionStore); + break; + case ResourceRWBlock.StoreAction.Resolve: + storeAction.AddToClassList(Classes.kStoreActionResolve); + break; + case ResourceRWBlock.StoreAction.StoreAndResolve: + storeAction.AddToClassList(Classes.kStoreActionStoreAndResolve); + break; + case ResourceRWBlock.StoreAction.DontCare: + storeAction.AddToClassList(Classes.kStoreActionDontCare); + break; + } + + block.element.Add(storeActionBorder); + block.element.Add(storeAction); + } } block.tooltip = tooltip; @@ -1397,20 +1551,97 @@ VisualElement CreateResourceGridRow( foreach (var writePassId in res.producerList) blocks[writePassId].write = true; + var currentResource = m_CurrentDebugData.resourceLists[(int)resourceType][resourceIndex]; + HashSet
A: A sphere with a transparent compute thickness material intersecting an opaque plane. B: A sphere with an opaque compute thickness material intersecting an opaque plane. @@ -140,17 +138,17 @@ To visualize the compute thickness debug mode, perform the following actions: This view displays the thickness or overlap count of the objects in the layer you select in the **Layer Mask** property. - + A: The default appearance of the compute thickness debug view. -B: The compute thickness debug view when you enable **Show Overlap Count** . +B: The compute thickness debug view when you enable **Show Overlap Count**. | **Debug view color** | **Description** | | ------------------------------------------------------------ | ------------------------------------------------------------ | -| Vidris color scale | A gradient scale that represents thickness. Purple represents the minimum thickness and yellow represents the maximum thickness.
When you enable **Show Overlap Count,** yellow areas indicate a high number of overlapping triangles. | -| Red | Negative thickness caused by an open mesh, flipped triangles, or an odd number of triangles in the optical path. | -| Gray | The default background color.
Gray areas inside a mesh indicate pixels that are in a similar position (z-fight) or have no thickness. | -| Orange | Compute Thickness is not active in HDRP graphics settings. To fix this, [enable compute thickness](#computethickness-enable). | -| Pink | This layer is not assigned to the HDRP Asset’s Layer Mask property. To fix this, [enable compute thickness](#computethickness-enable). | +| Vidris color scale | A gradient scale that represents thickness. Purple represents the minimum thickness and yellow represents the maximum thickness.
When you enable **Show Overlap Count,** yellow areas indicate a high number of overlapping triangles. | +| Red | Negative thickness caused by an open mesh, flipped triangles, or an odd number of triangles in the optical path. | +| Gray | The default background color.
Gray areas inside a mesh indicate pixels that are in a similar position (z-fight) or have no thickness. | +| Orange | Compute Thickness is not active in HDRP graphics settings. To fix this, [enable compute thickness](#computethickness-enable). | +| Pink | This layer is not assigned to the HDRP Asset’s Layer Mask property. To fix this, [enable compute thickness](#computethickness-enable). | ## Limitations diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Frame-Debugger.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Frame-Debugger.md deleted file mode 100644 index 1ee40904548..00000000000 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Frame-Debugger.md +++ /dev/null @@ -1,11 +0,0 @@ -# Viewing a Custom Pass in the Frame Debugger - -You can use the [Frame Debugger](https://docs.unity3d.com/Manual/FrameDebugger.html) to examine every draw call you issued in the Custom Pass. To find your pass, look for the name you gave your Custom Pass in the Custom Pass Volume component. - -In this example, the Custom Pass is called **My Outline Pass**. The **Frame Debug** window (menu: - -**Window > Analysis > Frame Debugger**) displays the steps that **My Outline Pass** executes in the left window, highlighted in the image below: - - - -To learn more about the Frame Debugger, see the [Frame Debugger](https://docs.unity3d.com/Manual/FrameDebugger.html) documentation. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Injection-Points.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Injection-Points.md index 89bddeb728f..5f56f44eae3 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Injection-Points.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Injection-Points.md @@ -14,15 +14,12 @@ To learn when injection points happen in the render pipeline refer to [Execution Unity triggers the following injection points in a frame, in order from top to bottom: -| **Injection point** | **Available buffers** | **Description** | -|---------------------------| ------------------------------------------------------------ | ----------------------------------------------------------- | -| BeforeRendering | Depth (Write) | Unity clears the depth buffer immediately before this injection point.
In this injection point you can write to the depth buffer so that Unity doesn’t render depth-tested, opaque objects.
You can also clear the buffer you allocated or the `Custom Buffer`.
When you select this Injection point for a [FullscreenCustom Pass](custom-pass-create-gameobject.md#full-screen-custom-pass), Unity assigns the camera color buffer as the target by default. | -| AfterOpaqueDepthAndNormal | Depth (Read \| Write), Normal and roughness (Read \| Write), Motion Vectors (Write) | The available buffers for this injection point contain all opaque objects.
In this injection point you can modify the normal, roughness, depth, and motion vectors buffers. HDRP takes this into account in the lighting and the depth pyramid.
Normals and roughness are in the same buffer. You can use `DecodeFromNormalBuffer` and `EncodeIntoNormalBuffer` methods to read/write normal and roughness data.
The Motion Vectors buffer only includes object motion vector data when you use [forward rendering](Forward-And-Deferred-Rendering.md). To include object motion vector data in the Motion Vectors buffer when using deferred rendering, go to [Frame Settings](Frame-Settings.md) and enable **Depth Prepass within Deferred**. | -| AfterOpaqueAndSky | Color (no pyramid \| Read \| Write), Depth (Read \| Write), Normal and roughness (Read), Motion Vectors (Read \| Write) | The available buffers for this injection point contain all opaque objects and the sky. Note that the Fog is rendered just after this pass, so if you modify the color buffer, fog will be added on top of your effect. | -| BeforePreRefraction | Color (no pyramid \| Read \| Write), Depth (Read \| Write), Normal and roughness (Read), Motion Vectors (Read \| Write) | The available buffers for this injection point contain all opaque objects, the camera and object motion vectors, and the sky.
From this point, the motion vectors buffer is complete.
In this injection point you can render any transparent objects that require refraction. These objects are then included in the color pyramid that Unity uses for refraction when it renders transparent objects. | -| BeforeTransparent | Color (Pyramid \| Read \| Write), Depth (Read \| Write), Normal and roughness (Read), Motion Vectors (Read) | The available buffers for this injection point contain:
- All opaque objects.
- Transparent PreRefraction objects.
- Transparent objects with depth-prepass and screen space reflections (SSR) enabled.
In this Injection Point you can sample the color pyramid that Unity uses for transparent refraction. You can use this to create a blur effect. All objects Unity renders in this injection point will not be in the color pyramid.
You can also use this injection point to draw some transparent objects that refract the whole scene, like water. | -| BeforePostProcess | Color (Pyramid \| Read \| Write), Depth (Read \| Write), Normal and roughness (Read), Motion Vectors (Read) | The available buffers for this injection point contain all geometry in the frame that uses High Dynamic Range (HDR). | -| AfterPostProcess | Color (Read \| Write), Depth (Read) | The available buffers for this injection point contain the final render of the scene, including post-process effects.
This injection point executes the available buffers after Unity applies any post-processing effects.
If you select this injection point, objects that use the depth buffer display jittering artifacts.
When you select this injection point for a [FullscreenCustom Pass](custom-pass-create-gameobject.md#full-screen-custom-pass), Unity assigns the camera color buffer as the target by default. | - -The purple boxes correspond to the injection points above in this diagram representing the pass layout in HDRP: - \ No newline at end of file +| **Injection point** | **Available buffers** | **Description** | +|---------------------------| ------------------------------------------------------------ |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| BeforeRendering | Depth (Write) | Unity clears the depth buffer immediately before this injection point.
In this injection point you can write to the depth buffer so that Unity doesn’t render depth-tested, opaque objects.
You can also clear the buffer you allocated or the `Custom Buffer`.
When you select this Injection point for a [FullscreenCustom Pass](custom-pass-create-gameobject.md#full-screen-custom-pass), Unity assigns the camera color buffer as the target by default. | +| AfterOpaqueDepthAndNormal | Depth (Read \| Write), Normal and roughness (Read \| Write), Motion Vectors (Write) | The available buffers for this injection point contain all opaque objects.
In this injection point you can modify the normal, roughness, depth, and motion vectors buffers. HDRP takes this into account in the lighting and the depth pyramid.
Normals and roughness are in the same buffer. You can use `DecodeFromNormalBuffer` and `EncodeIntoNormalBuffer` methods to read/write normal and roughness data.
The Motion Vectors buffer only includes object motion vector data when you use [forward rendering](Forward-And-Deferred-Rendering.md). To include object motion vector data in the Motion Vectors buffer when using deferred rendering, go to [Frame Settings](Frame-Settings.md) and enable **Depth Prepass within Deferred**. | +| AfterOpaqueAndSky | Color (no pyramid \| Read \| Write), Depth (Read \| Write), Normal and roughness (Read), Motion Vectors (Read \| Write) | The available buffers for this injection point contain all opaque objects and the sky. Note that the Fog is rendered just after this pass, so if you modify the color buffer, fog will be added on top of your effect. | +| BeforePreRefraction | Color (no pyramid \| Read \| Write), Depth (Read \| Write), Normal and roughness (Read), Motion Vectors (Read \| Write) | The available buffers for this injection point contain all opaque objects, the camera and object motion vectors, and the sky.
From this point, the motion vectors buffer is complete.
In this injection point you can render any transparent objects that require refraction. These objects are then included in the color pyramid that Unity uses for refraction when it renders transparent objects. | +| BeforeTransparent | Color (Pyramid \| Read \| Write), Depth (Read \| Write), Normal and roughness (Read), Motion Vectors (Read) | The available buffers for this injection point contain:
- All opaque objects.
- Transparent PreRefraction objects.
- Transparent objects with depth-prepass and screen space reflections (SSR) enabled.
In this Injection Point you can sample the color pyramid that Unity uses for transparent refraction. You can use this to create a blur effect. All objects Unity renders in this injection point will not be in the color pyramid.
You can also use this injection point to draw some transparent objects that refract the whole scene, like water. | +| BeforePostProcess | Color (Pyramid \| Read \| Write), Depth (Read \| Write), Normal and roughness (Read), Motion Vectors (Read) | The available buffers for this injection point contain all geometry in the frame that uses High Dynamic Range (HDR). | +| AfterPostProcess | Color (Read \| Write), Depth (Read) | The available buffers for this injection point contain the final render of the scene, including post-process effects.
This injection point executes the available buffers after Unity applies any post-processing effects.
If you select this injection point, objects that use the depth buffer display jittering artifacts.
When you select this injection point for a [FullscreenCustom Pass](custom-pass-create-gameobject.md#full-screen-custom-pass), Unity assigns the camera color buffer as the target by default.**Note:** When sampling scene color using HDSceneColor node in a FullScreenShaderGraph at this injection point, consider using a temporary buffer to handle concurrent read/write operations. See [Scene Color Sampling in AfterPostProcess](Custom-Pass-Scene-Color-Read.md) for implementation details. | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Scene-Color-Read.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Scene-Color-Read.md new file mode 100644 index 00000000000..474594bf641 --- /dev/null +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Custom-Pass-Scene-Color-Read.md @@ -0,0 +1,58 @@ +# Scene Color Sampling in AfterPostProcess Custom Pass + +## Overview +When using AfterPostProcess injection point with FullScreenShaderGraph that samples scene color, you might need to handle concurrent read/write operations on the color buffer. This page explains the recommended implementation for proper scene color sampling. + +## Technical Details +At the AfterPostProcess injection point, the color buffer serves as both the render target and the source for scene color sampling. To ensure correct sampling, you can implement a solution using a temporary buffer. + +## Implementation Example + +Here's an example of how to properly sample scene color in an AfterPostProcess Custom Pass: + +```c# +class SceneColorSamplingPass : CustomPass +{ + RTHandle m_TempColorBuffer; + + protected override void Setup(ScriptableRenderContext renderContext, CommandBuffer cmd) + { + // Create temporary buffer with the same properties as camera color buffer + m_TempColorBuffer = RTHandles.Alloc( + Vector2.one, TextureXR.slices, dimension: TextureXR.dimension, + colorFormat: GetColorBufferFormat(), + name: "SceneColorSamplingBuffer" + ); + } + + protected override void Execute(CustomPassContext ctx) + { + // Copy the scene color to temporary buffer + ctx.cmd.CopyTexture(ctx.cameraColorBuffer, m_TempColorBuffer); + + // Bind temporary buffer for sampling + ctx.cmd.SetGlobalTexture("_AfterPostProcessColorBuffer", m_TempColorBuffer); + + // Your custom pass rendering code here + // ... + } + + protected override void Cleanup() + { + // Release the temporary buffer + RTHandles.Release(m_TempColorBuffer); + } +} +``` +## Performance Considerations + +When implementing this solution, keep in mind: +- This approach allocates an additional full-resolution color buffer +- Only implement this solution when you need to sample the scene color +- Consider using a different injection point if your use case allows it + +## See Also +- [Custom Pass Injection Points](Custom-Pass-Injection-Points.md) +- [Custom Pass Volume Workflow](Custom-Pass-Volume-Workflow.md) +- [Full Screen Custom Pass](custom-pass-create-gameobject.md) + diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Double-Sided.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Double-Sided.md index 40edb4a4311..c188e48d858 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Double-Sided.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Double-Sided.md @@ -2,7 +2,7 @@ This setting controls whether The High Definition Render Pipeline (HDRP) renders both faces of the geometry of GameObjects using this Material, or just the front face. -  +  This setting is disabled by default. Enable it if you want HDRP to render both faces of your geometry. When disabled, HDRP [culls](https://docs.unity3d.com/Manual/SL-CullAndDepth.html) the back-facing polygons of your geometry and only renders front-facing polygons. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Glossary.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Glossary.md index c2510eb6521..0a83106cb6c 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Glossary.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Glossary.md @@ -113,8 +113,6 @@ An anti-aliasing technique that uses frames from a history buffer to smooth edge A measure of the amount of light ([luminous flux](#LuminousFlux)) falling onto a given area. Differs from luminance because illuminance is a specific measurement of light whereas luminance describes visual perceptions of light. - - #### luminous flux: diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/HDRP-Features.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/HDRP-Features.md index 5f02b45770f..6ba9dc953c6 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/HDRP-Features.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/HDRP-Features.md @@ -76,19 +76,19 @@ HDRP Shaders allow you to use the following features: ### Lit Shader - + The Lit Shader is the default Shader in HDRP. Use the Lit Shader to create realistic Materials. The Lit Shader also includes options for effects including subsurface scattering, iridescence, and translucency. For more information, including the full list of Shader properties, see the [Lit Shader documentation](lit-material.md) and [Lit master stack](lit-master-stack-reference.md). ### Layered Lit Shader - + The Layered Lit Shader combines a main Material with other tileable Materials to produce visuals with a similar quality to a single high-resolution texture, but in a way that's less resource intensive than a [Lit Shader](lit-material.md) using the single high-resolution Texture. For more information, including a full list of Shader properties, see the [Layered Lit Shader documentation](layered-lit-material-inspector-reference.md). ### Unlit Shader - + The Unlit Shader allows you to create Materials that aren't affected by lighting. Unlit Shaders are perfect for visual effects. For more information, including a full list of Shader properties, see the [Unlit Shader documentation](unlit-shader.md) and [Unlit master stack](unlit-master-stack-reference.md). @@ -96,13 +96,13 @@ With the **Shadow Matte** option, you can have the surface receive shadow withou ### StackLit Shader - + The StackLit Shader is a higher quality than the Lit Shader, but more resource intensive. This Shader coats surfaces more accurately than the Lit Shader, and, unlike the Lit Shader, allows you to use multiple Material features like anisotropy, subsurface scattering iridescence, and hazy parametrization at the same time. For more information, including a full list of Shader properties, see the [Stacklit master stack](stacklit-master-stack-reference.md) ### Hair Shader - + The Hair Shader is purpose-built to accurately render realistic and stylized hair in your Unity Project. You can use the following modes: - Physically based: Uses the Marschner lighting model with multiple scattering to improve the realism of light-colored hair. @@ -112,13 +112,13 @@ For more information, including a full list of Shader properties, see the [Hair ### Fabric Shader - + The Fabric Shader allows you to render realistic fabric Materials in HDRP. You can use the cotton wool or silk lighting model to create a wide variety of fabrics. For more information, including a full list of Shader properties, see [Create a fabric material](create-a-fabric-material.md). ### Eye Shader - + The Eye Shader allows you to render realistic eye Materials in HDRP. The Eye shader can use the following material types: - Eye: Uses a low resource-intensity method to calculate caustics. @@ -130,13 +130,13 @@ For more information, including a full list of Shader properties, see the [Eye S ### AxF Shader - + The AxF Shader supports the [X-Rite AxF](https://www.xrite.com/axf) measured Material format. The AxF importer, available in [Unity Enterprise for Product Lifecylce](https://unity.com/products/unity-enterprise-product-lifecycle), automatically populates an AxF Material when it imports AxF Assets. For more information, including a full list of Shader properties, see the [AxF Shader documentation](AxF-material-inspector-reference.md). ### Decals - + Use Decals to apply a separate texture to surfaces in your Scene. To apply a decal to a surface, you can either use the [Decal Projector component](decal-projector-reference.md) to project the decal onto the surface, or assign the decal shader directly to a Mesh and then place the Mesh on the surface. @@ -146,17 +146,17 @@ For more information, see [Decals](decals.md). ### Terrain Shader - + The Terrain Lit Shader is compatible with the built-in terrain system and supports up to eight layers in a single draw call. This Shader uses the same lighting model as the Lit Shader. For more information, including the full list of Shader properties, see the [Terrain Lit Shader documentation](terrain-lit-material.md). ### Compute Thickness - + Compute Thickness is a screen-space pass that calculates the accumulated [thickness](Compute-Thickness.md) of objects in a specific Layer. HDRP calculates the optical path and overlap count, which you can use with [Subsurface Scattering](skin-and-diffusive-surfaces-subsurface-scattering.md) and [Refraction](Override-Screen-Space-Refraction.md). You can also use the overlap count to calculate compute thickness on non-closed or flat geometry like vegetation. Use the [HD Sample Buffer](https://docs.unity3d.com/Packages/com.unity.shadergraph@latest/index.html?preview=1&subfolder=/manual/HD-Sample-Buffer-Node.html) node to sample the thickness in a Shader Graph. ### Volumetric Materials - + In HDRP, you can control the density of fog in an area to create a Volumetric fog effect. Use a [local volumetric fog](create-a-local-fog-effect.md) volume override to set a 3D Mask texture or a shader graph that controls the fog color and the density. @@ -168,7 +168,7 @@ The Visual Effect Graph supports volumetric outputs, like the [Volume (Cone)](ht ### Light types - + The HDRP light types use [physical light units](#PLU) to help you light your Scene in the most realistic way possible. To assist you in creating physically accurate lights, the [Light component](Light-Component.md) Inspector includes icons alongside the **Intensity** and **Temperature** properties. Each icon displays the real-world light source that the value of each property currently represents. Each icon is also a button which you can click to access a list of preset values that match real-world light sources. For lights to behave properly when using PLU, you need to respect HDRP unit convention (1 Unity unit equals 1 meter). The HDRP light types are: @@ -205,7 +205,7 @@ For more information, including the full list of light properties, see the [Ligh ### Rendering Layers - + Rendering Layers are Layer Masks that you specify for Lights, Decals and Meshes. Lights only illuminate Meshes that are on the same Rendering Layer. You can also use Rendering Layers in the shadow map settings to decouple shadows from lighting. For more information on Rendering Layers, see the [Rendering Layers documentation](Rendering-Layers.md). @@ -213,20 +213,16 @@ You can use Rendering layers in the shadow map dropdown to control which GameObj ### IES Profiles and light cookies - + HDRP supports the Illuminating Engineering Society's (IES) file format for describing the distribution of light from a light source. HDRP supports the IES profile for Point, Spot (Cone, Pyramid, and Box), and rectangular Area [Lights](Light-Component.md). You can also mix the IES profile with [cookies](https://docs.unity3d.com/Manual/Cookies.html) and even use the profile and cookie mix for [light map baking](https://docs.unity3d.com/Manual/LightMode-Baked.html). ### Light Anchor - - HDRP's [Light Anchor component](light-anchor.md) allows you to manipulate a light from the Main Camera view. ### Light Explorer - - HDRP adds options to the [Light Explorer](https://docs.unity3d.com/Manual/LightingExplorer.html) that you can use to select and edit the following light sources: - Directional lights - Point lights @@ -238,32 +234,32 @@ HDRP adds options to the [Light Explorer](https://docs.unity3d.com/Manual/Lighti ### Lens Flare, data-driven - + Use HDRP's data-driven Lens Flare system provides a [lens flare asset](shared/lens-flare/lens-flare-asset.md) and a [lens flare component](shared/lens-flare/lens-flare-component.md) that you can attach to any GameObject. You can control each element of a Lens Flare individually. ### Lens Flare, Screen Space - + HDRP generates the Screen Space Lens Flare effect from screen information to create multiple types of flares based on the [Bloom](Post-Processing-Bloom.md) texture. This is useful for view-dependent bright spots (like specular reflection and overexposed areas) that don't have a defined position in world space. ### Reflection probes - + HDRP supports cubemap reflections that take surface smoothness into account. HDRP cubemap reflection optionally supports a fake distance based roughness. This helps you produce realistic reflections in your Scene in real time. You can control the reflection probe resolution for each probe. For more information, see [introduction to Reflection Probes](Reflection-Probes-Intro.md) ### Planar reflection probe - + HDRP supports Planar reflection probes that take surface smoothness into account. This allows you to create effects that mimic a shiny mirror or a wet floor. HDRP includes accurate filtering for planar reflection that's close to being physically based. For more information, see [Planar Reflection Probe](Planar-Reflection-Probe.md). ### Screen-space reflection and refraction - + HDRP provides a screen-space solution for reflection and refraction. It uses the depth and color buffer of the screen to help simulate the path that light travels to the Camera and uses this to calculate accurate reflection and refraction. You can use this feature for transparent materials too, such as windows or water. For more information, see [screen-space reflection](Override-Screen-Space-Reflection.md) and [screen-space refraction](Override-Screen-Space-Refraction.md). To see how to setup refractive materials and understand the limitations of Screen Space Refraction, download the [Material Sample](HDRP-Sample-Content.md#material-samples) from the Package Manager window and open the **Transparency** scenes. @@ -280,7 +276,7 @@ HDRP includes a [screen space ambient occlusion](Override-Ambient-Occlusion.md) Screen space ambient occlusion in HDRP can apply a direction to indirect specular lighting. To improve the specular occlusion approximation, you can use a texture that contains bent normal information that corresponds to the light direction. ### Adaptive Probe Volumes - + demo, with a woman sitting playing chess in a large ornate room.](Images/HDRPFeatures-APV.png) Adaptive Probe Volumes (APV) is a probe-based global illumination system that automatically places light probes based on the geometry density in your scene. APV features include: - Per-pixel probe selection and lighting. @@ -294,7 +290,7 @@ For more information, see [APV](probevolumes.md). ### Screen-space global illumination - + HDRP supports screen-space global illumination (SSGI). SSGI is an algorithm that accesses the indirect diffuse lighting that the environment generates. It works in the same way as the [Screen Space Reflection](Override-Screen-Space-Reflection.md) in that it uses ray marching to calculate the result. @@ -311,8 +307,6 @@ HDRP allows you to calculate exposure using several methods. This includes: ##### Histogram exposure - - HDRP's exposure implementation computes a histogram of the image which allows you to select high and low percentile values to discard. Discarding outlying values in the shadows or highlights helps to calculate a more stable exposure. For more information, see [Exposure](Override-Exposure.md). ##### Metering mode @@ -321,13 +315,13 @@ HDRP's exposure implementation includes a metering mask. This includes a texture ### Emission - + HDRP Materials support light [emission](lit-material-inspector-reference.md#EmissionInputs), which allows you to make a Material into a self-illuminated visible source of light. Global illumination takes emission into account and you can use [physical light units](#PLU) to set the intensity based on real-world lights. ### Shadows - + HDRP uses multiple methods to calculate shadows: @@ -355,7 +349,7 @@ To apply a tint to the shadow or the penumbra of the shadow: ### Ray tracing - + You can use ray tracing as an alternative to some screen space effects, shadowing techniques, and Mesh rendering techniques: @@ -379,7 +373,7 @@ You can use ray tracing as an alternative to some screen space effects, shadowin ### Sky - + In HDRP, you set up the sky inside a [Volume](understand-volumes.md), so you can change sky settings, or even the type of sky itself, depending on the position of the Camera in the Scene. HDRP allows you to separate the visual sky from the sky that you use for environment lighting. HDRP includes the following built-in sky types for you to use in your Unity Project: @@ -391,7 +385,7 @@ HDRP is able to handle multiple skies seen by different Cameras. #### Backplate - + A backplate projects the bottom part of a [HDRI Sky](create-an-hdri-sky.md) onto a plane in one of the following shapes: - **Rectangle** @@ -403,7 +397,7 @@ To match the scale of the GameObjects in your Scene, change the Backplate's **Sc ### Cloud Layer - + In HDRP, you set up cloud layers inside a [Volume](Volumes.md), so you can change clouds settings, or even the type of clouds itself, depending on the position of the Camera in the Scene. HDRP allows you to separate the clouds in the visual sky from the clouds that you use for environment lighting. HDRP includes the following built-in cloud type for you to use in your Unity Project: @@ -411,13 +405,13 @@ In HDRP, you set up cloud layers inside a [Volume](Volumes.md), so you can chang ### Volumetric Clouds - + You can use a [Volume](understand-volumes.md) component to create volumetric clouds. Volumetric clouds physically exist inside a scene, HDRP does not project them on the HDRI sky. A camera can fly through volumetric clouds and volumetric clouds have accurate interactions with the sky, sun and fog. Volumetric clouds cast shadows on themselves and the ground using a Beer shadow map. For more information, refer to [Volumetric Clouds](create-realistic-clouds-volumetric-clouds.md). ### Fog - + In HDRP, you set up fog inside a [Volume](understand-volumes.md) which means you can change fog settings or the fog type depending on the position of the Camera in the Scene. You can set the color of the fog yourself or use the color of the sky. HDRP fog affects Materials with both opaque and transparent surfaces. HDRP implements an exponential [fog](fog.md) with optional volumetric effects. @@ -425,7 +419,7 @@ In HDRP, you set up fog inside a [Volume](understand-volumes.md) which means you ### Water Surface - + Use HDRP's water system to create and control realistic water surfaces. HDRP's water system includes the following features: - Multiple presets. @@ -446,13 +440,13 @@ For more information, refer to [Water system](water.md). ### Post-processing - + HDRP includes its own purpose-built implementation for post-processing to produce exceptionally high-quality graphics. You can use post-processing to apply full-screen filters and effects to the Camera to drastically improve the visuals of your Unity Project with little set-up time. For an overview on HDRP post-processing, see the [post-processing documentation](Post-Processing-Main.md). ### HDR Display Output - + You can output a HDRP scene to high dynamic range (HDR) displays and customize the output in the following ways: @@ -464,13 +458,13 @@ For more information see the [High Dynamic Range Output documentation](HDR-Outpu ### Accumulation motion blur - + HDRP includes a recording API that you can use to render effects like high-quality accumulation motion blur. This technique combines information from multiple intermediate sub-frames to create a converged frame. Use this API to extract the converged frame and perform further processing or save it to disk. For information about this feature, and some example scripts, see [Multiframe rendering and accumulation](Accumulation.md). ### Anti-Aliasing - + HDRP includes the following [antialiasing](Anti-Aliasing.md) methods to help you remove aliasing effects with performance and quality in mind: @@ -485,28 +479,24 @@ HDRP uses a physically based Camera system that works seamlessly with the other ### Custom Post-processing - + HDRP allows you to add your own custom post processes integrated with the volume framework. You can inject them after opaque and sky object, before the [temporal antialiasing](Anti-Aliasing.md#TAA) pass, before built-in post processes or after built-in post processes. For more information, see the [Custom Post-processing documentation](Custom-Post-Process.md). ### Custom Passes - - Use a Custom Pass to inject shaders and C# scripts at certain points inside the render pipeline. You can use a Custom Pass to draw objects, override the rendering properties of objects in your scene, perform fullscreen passes and read some camera buffers like depth, color, normal or motion vectors. You can also use this Camera override to render some GameObjects with a different field of view, like arms in a first-person application. For more information, see [Custom Pass](Custom-Pass.md). Use the [Custom Pass API](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest?subfolder=/api/UnityEngine.Rendering.HighDefinition.CustomPassUtils.html) to render GameObjects from another point of view, like a disabled camera, within the rendering of your main Camera. You can use this API to render `Depth`, `Normal`, and `Tangent` into an `RTHandle`. ### High Quality Line Rendering - + High Quality Line Rendering allows you to render hair, wires, and other line-based geometry with high quality anti-aliasing and transparency. For more information, refer to [High Quality Line Rendering](Override-High-Quality-Lines.md). ### Custom Pass AOV Export - - This feature allows you to export arbitrary data from custom pass injection points using an extension of the Arbitrary Output Variables (AOV) API in HDRP. An example use-case is for exporting “Object IDs” that are rendered with a custom pass. For information about the feature and example scripts, see the [AOV documentation](AOVs.md). ### Fullscreen Shader Graph @@ -515,7 +505,7 @@ Use the Fullscreen Shader Graph to create custom post process and fullscreen cus ### Custom Render Texture in Shader Graph - + In HDRP, you can use [Custom Render Textures](https://docs.unity3d.com/Manual/class-CustomRenderTexture.html) as a Shader Graph target to create static or dynamic textures. Custom Render Textures support multiple texture dimensions. For example, you can use 3D textures with Local Volumetric Fog, and Cubemaps in the HDRI sky. @@ -526,7 +516,7 @@ You can also create complex effects like dynamic ripples and snow deformation wn Use the [Canvas ShaderGraph](canvas-material.md) to create custom [UGUI user interface elements](https://docs.unity3d.com/Packages/com.unity.ugui@1.0/manual/UICanvas.html). ### Graphics Compositor - + Use the Graphics Compositor to compose images and videos with 3D content into a final frame in real-time, without an external compositing tool. @@ -544,7 +534,7 @@ For information, see [HDRP Compositor](graphics-compositor.md). ### Path-traced depth of field - + HDRP includes a depth of field mode for producing path-traced images with high-quality defocus blur. This mode can use multiple layers of transparency and doesn't produce any artifacts. However, path tracing can cause some noise. To fix noise artefacts, increase the sample count or using an external denoising tool. For more information about, see [Depth-of-field](Post-Processing-Depth-of-Field.md). @@ -554,13 +544,13 @@ HDRP includes a recording API which you can use to render converged path-traced ### Path-traced sub-surface scattering - + Path tracing supports subsurface scattering (SSS), using a random walk approach. To use it, enable path tracing and set up SSS in the same way as you would for HDRP materials. For information on SSS in HDRP, see [subsurface scattering](skin-and-diffusive-surfaces-subsurface-scattering.md). ### Path-traced fog - + Path tracing in HDRP supports anisotropic fog absorption. To use this feature enable path tracing and set up fog in HDRP. For information, refer to [fog](fog.md). @@ -570,8 +560,6 @@ Path tracing works with [decals](decals.md). For more information, refer to [Und ### Materials support - - Path tracing can render the following rasterization engine [Materials](#Material): - Lit @@ -585,7 +573,7 @@ When you enable path tracing, objects that use non-HDRP Materials won't appear i ### Denoising support - + HDRP supports denoising for frames that use path tracing. You can choose from the following denoising libraries: - Optix Denoiser. @@ -597,19 +585,17 @@ HDRP supports denoising for frames that use path tracing. You can choose from th ### Color checker - + Use the Color Checker tool to check the calibration of lighting and post processing. To open the color checker tool, go to **GameObject** > **Rendering** > **Color Checker Tool**. HDRP doesn't save any changes you make in the color checker. ### Light placement tool - - Use the Light Placement Tool to look through a light and use the camera movement controls to move the light around the scene. To enter this mode select a light GameObject and select the Light Placement Tool button in the Tools Panel. For more information, refer to [Light placement tool](lights-placement-tool.md) ### LookDev - + The LookDev is a viewer that allows you to import and display Assets in a consistent lighting environment. Use the LookDev window to validate outsourced Assets or to showcase your own created Asset with HDRP. For more information on the LookDev, including a description of how to use it, see the [LookDev documentation](test-and-debug-materials-in-different-lighting-conditions-look-dev.md). ### Render Pipeline Wizard diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/HDRP-Sample-Content.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/HDRP-Sample-Content.md index 75b9064d04d..849ff659f35 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/HDRP-Sample-Content.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/HDRP-Sample-Content.md @@ -6,7 +6,7 @@ A Sample is a set of Assets that you can import into your Project and use as a b To find these Samples: -1. Go to **Window** > **Package Manager**, and select **High Definition RP** from the package list. +1. Go to **Window** > **Package Management** > **Package Manager**, and select **High Definition RP** from the package list. 2. In the main window that shows the package's details, find the **Samples** section. 3. To import a Sample into your Project, click the **Import into Project** button. This creates a **Samples** folder in your Project and imports the Sample you selected into it. This is also where Unity imports any future Samples into. @@ -28,7 +28,7 @@ This Sample includes various examples of lit and unlit particle effects. ## Material samples - + This Sample includes various examples of Materials. It includes Materials that use the [Lit Shader](lit-material.md), [Fabric Master Stack](fabric-master-stack-reference.md), [Hair Master Stack](hair-master-stack-reference.md), [Eye Shader](eye-master-stack-reference.md) and [Decal Master Stack](decal-master-stack-reference.md). The included Materials use effects such as subsurface scattering, displacement, and anisotropy. The **MaterialSamples** Scene requires Text Mesh Pro to display the text explanations. @@ -38,14 +38,14 @@ In the **Eye** Scene, the eye examples use a carefully designed mesh with a part ## Transparent samples - + In the Transparency scene, the examples contain information on how to setup properly transparents in your projects using different rendering methods (Rasterization, Ray Tracing, Path Tracing). To take advantage of all the content of this section, a GPU that supports [Ray Tracing](Ray-Tracing-Getting-Started.md) is needed. ## Lens Flare samples - + The [Lens Flare](shared/lens-flare/lens-flare-component.md) samples include the following examples that you can use in your project: - Lens Flare Assets. @@ -56,7 +56,6 @@ The [Lens Flare](shared/lens-flare/lens-flare-component.md) samples include the ## Volumetric samples - The volumetric samples include a scene that contains multiple examples of [volumetric fog](create-a-local-fog-effect.md). This scene includes the following: - 3D textures. @@ -64,7 +63,7 @@ The volumetric samples include a scene that contains multiple examples of [volum - Fog Volume Shader Graph examples. ## Fullscreen samples - + This sample includes examples on how to create a [Fullscreen Shader](create-a-fullscreen-material.md) and use it with a Custom Pass, Custom Post Process and Custom Render Target. The sample scene includes prefabs for the following effects: @@ -74,7 +73,7 @@ This sample includes examples on how to create a [Fullscreen Shader](create-a-fu ## Water samples - + The Water samples contain the following scenes you can use to learn about HDRP's [Water](water.md) features: @@ -83,10 +82,12 @@ The Water samples contain the following scenes you can use to learn about HDRP's - Island: Demonstrates waves, foam, and the water excluder. - Rain: Demonstrates how to add pertubations to the normals using shader graph. - Waterline: Demonstrates how to override rendering of the waterline using a [Custom Pass](Custom-Pass.md). +- Cave: Demonstrates how to use the caustics texture in a sphere projection shader using a [Custom Pass](Custom-Pass.md). +- CurrentWithSplines: Demonstrates how to use the Spline package to control current and deformation in realtime. ## Environment samples - + This sample puts multiple environment effects together in the same scene with different lighting conditions. The scene includes examples focusing on the following effects: diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/IES-Importer.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/IES-Importer.md index f0240ece106..ad0b332f612 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/IES-Importer.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/IES-Importer.md @@ -2,8 +2,6 @@ The High Definition Render Pipeline (HDRP) includes an importer to handle the .ies file format. When you add an [IES profile](IES-Profile.md) to your project, the IES importer Inspector provides information and customization options for the internally used textures. - - When you apply the import settings, the importer generates a [Light](Light-Component.md) Prefab as a sub-asset of the IED profile. You can drag the Prefab into the Scene view or Hierarchy to create an instance of a Light that uses the IES profile. ### Properties diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/IES-Profile.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/IES-Profile.md index 52b9d088342..04079a82426 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/IES-Profile.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/IES-Profile.md @@ -2,7 +2,7 @@ IES profiles describe how light spreads for a given direction. They are similar to [light cookies](https://docs.unity3d.com/Manual/Cookies.html) in that they use a multiplier mask to achieve this goal. The Unity IES profile supports Point, Spot (Cone, Pyramid, Box), and Area (Rectangular) [Lights](Light-Component.md). - + The main benefit of using IES profiles over cookies is that light manufacturers provide the profiles. This means that they are physically accurate to the real-world light they represent and also artists do not need to dedicate time authoring them. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/3d-texture-mask-sample.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/3d-texture-mask-sample.webp deleted file mode 100644 index 8f14ce4f4de..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/3d-texture-mask-sample.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Area_Materials.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Area_Materials.png deleted file mode 100644 index edb4211daa0..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Area_Materials.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ContactShadowLightComponent.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ContactShadowLightComponent.png deleted file mode 100644 index fc510c9fe3f..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ContactShadowLightComponent.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Exposure_Histogram.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Exposure_Histogram.png deleted file mode 100644 index 5e79f6802aa..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Exposure_Histogram.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/FS_SampleTex2DArray.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/FS_SampleTex2DArray.png deleted file mode 100644 index 3fff9be2bf7..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/FS_SampleTex2DArray.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/FidelityFX-Menu.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/FidelityFX-Menu.png deleted file mode 100644 index 38938f77323..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/FidelityFX-Menu.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/HDRPFeatures-CustomPass.gif b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/HDRPFeatures-CustomPass.gif deleted file mode 100644 index 62e72392886..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/HDRPFeatures-CustomPass.gif and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/HDSampleBuffer.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/HDSampleBuffer.png deleted file mode 100644 index 42f7f619f25..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/HDSampleBuffer.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/IESImporter1.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/IESImporter1.png deleted file mode 100644 index 6e90fee7e6d..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/IESImporter1.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/LightExplorer.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/LightExplorer.png deleted file mode 100644 index 1051157ae64..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/LightExplorer.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/LightPlacementTool.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/LightPlacementTool.png deleted file mode 100644 index f9cdebde618..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/LightPlacementTool.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingFilmGrain1.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingFilmGrain1.png deleted file mode 100644 index 91c3be7c84d..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingFilmGrain1.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingPaniniProjection1.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingPaniniProjection1.png deleted file mode 100644 index 8b846505d85..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingPaniniProjection1.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingPropagatingNaNsRenderDoc.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingPropagatingNaNsRenderDoc.png deleted file mode 100644 index 5bc2e0501b0..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingPropagatingNaNsRenderDoc.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingShadowsMidtonesHighlights1.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingShadowsMidtonesHighlights1.png deleted file mode 100644 index 2fc2ac87a64..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingShadowsMidtonesHighlights1.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingSplitToning1.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingSplitToning1.png deleted file mode 100644 index 606a3505e58..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingSplitToning1.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingWhiteBalance1.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingWhiteBalance1.png deleted file mode 100644 index ee776368763..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Post-processingWhiteBalance1.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Shadows1.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Shadows1.png deleted file mode 100644 index a5c98a79aef..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/Shadows1.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/SpecularOcclusion.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/SpecularOcclusion.png deleted file mode 100644 index 09292819719..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/SpecularOcclusion.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/UseMipBias.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/UseMipBias.png deleted file mode 100644 index a4b18e2e3de..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/UseMipBias.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/about-blending-modes.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/about-blending-modes.webp deleted file mode 100644 index 5cff49c8633..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/about-blending-modes.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/cloudy-sample.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/cloudy-sample.webp deleted file mode 100644 index 105627ccf23..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/cloudy-sample.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/environment-plane-settings.jpg b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/environment-plane-settings.jpg deleted file mode 100644 index 618b2938bab..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/environment-plane-settings.jpg and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/foggy-orb-and-light-sample.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/foggy-orb-and-light-sample.webp deleted file mode 100644 index 376ac79afeb..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/foggy-orb-and-light-sample.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/fumes-sample.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/fumes-sample.webp deleted file mode 100644 index c393039b8f1..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/fumes-sample.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ghost-beast.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ghost-beast.png deleted file mode 100644 index 7df7f6f2371..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ghost-beast.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/gpu-occlusion-culling-ux.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/gpu-occlusion-culling-ux.png deleted file mode 100644 index 5e8961322c1..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/gpu-occlusion-culling-ux.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ground-smoke-prefab-sample.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ground-smoke-prefab-sample.webp deleted file mode 100644 index 6fdf63202fa..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/ground-smoke-prefab-sample.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/procedural-noise-fog-sample.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/procedural-noise-fog-sample.webp deleted file mode 100644 index 61ddf66e268..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/procedural-noise-fog-sample.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/samples-materials.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/samples-materials.png deleted file mode 100644 index 845b9093e53..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/samples-materials.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/shared/lens-flare/lensflare-ring.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/shared/lens-flare/lensflare-ring.png deleted file mode 100644 index a0d7757d38f..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/shared/lens-flare/lensflare-ring.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/stp-comparison.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/stp-comparison.png deleted file mode 100644 index 92fbd5ac96c..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/stp-comparison.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/stp-upscaler-ux.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/stp-upscaler-ux.png deleted file mode 100644 index 840084b3de8..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/stp-upscaler-ux.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/visualenvironment-renderingspace.png b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/visualenvironment-renderingspace.png deleted file mode 100644 index 5c1abfd746b..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/visualenvironment-renderingspace.png and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/volumetric-fog-samples.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/volumetric-fog-samples.webp deleted file mode 100644 index c17f1324be3..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/volumetric-fog-samples.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/volumetric-heart-sample.webp b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/volumetric-heart-sample.webp deleted file mode 100644 index a3b0c2ed5db..00000000000 Binary files a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Images/volumetric-heart-sample.webp and /dev/null differ diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/LUT-Authoring-Photoshop.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/LUT-Authoring-Photoshop.md index 22eb8c6ff26..e4150c5cf68 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/LUT-Authoring-Photoshop.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/LUT-Authoring-Photoshop.md @@ -23,7 +23,7 @@ Export the current [Camera](hdrp-camera-component-reference.md)'s view to a log- After you export the EXR file, transform the data from the format that Unity uses (Alexa LogC El.1000) to Linear RGB space, so that external software can use it. To do this, HDRP provides a set of ready-to-use transform LUTs. To get them: -1. Open the Package Manager window (menu: **Window** > **Package Manager**). +1. Open the Package Manager window (menu: **Window** > **Package Management** > **Package Manager**). 2. Select **High Definition RP** from the list of packages on the left. 3. In the **Samples** section, select **Import into Project** next to **Additional Post-processing Data**. 4. This imports the LUTs into Assets/HDRP Sample Content/Post-processing/Cube LUTs/. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/LUT-Authoring-Resolve.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/LUT-Authoring-Resolve.md index 5a2c67d720d..c8615a98eec 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/LUT-Authoring-Resolve.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/LUT-Authoring-Resolve.md @@ -23,7 +23,7 @@ Export the current [Camera](hdrp-camera-component-reference.md)'s view to a log- After you export the EXR file, transform the data from the format that Unity uses (Alexa LogC El.1000) to Linear RGB space, so that external software can use it. To do this, HDRP provides a set of ready-to-use transform LUTs. To get them: -1. Open the Package Manager window (menu: **Window > Package Manager**). +1. Open the Package Manager window (menu: **Window** > **Package Management** > **Package Manager**). 2. Select **High Definition RP** from the list of packages on the left. 3. In the **Samples** section, select **Import into Project** next to **Additional Post-processing Data**. 4. This imports the LUTs into Assets/HDRP Sample Content/Post-processing/Cube LUTs/. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Light-Component.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Light-Component.md index 1f9c4d3077e..6ed657b6865 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Light-Component.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Light-Component.md @@ -2,7 +2,7 @@ Use the Light component to create light sources in your [Scene](https://docs.unity3d.com/Manual/CreatingScenes.html). The Light component controls the shape, color, and intensity of the light. It also controls whether or not the Light casts shadows in your Scene, and more advanced settings. - + ## Create Lights diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Mask-Map-and-Detail-Map.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Mask-Map-and-Detail-Map.md index 87261c9b382..01a7714da8b 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Mask-Map-and-Detail-Map.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Mask-Map-and-Detail-Map.md @@ -26,7 +26,7 @@ To create a mask map, create a linear composited map in a photo editor, using th The following example image demonstrates the individual components of a full mask map. - + @@ -45,7 +45,7 @@ To create a detail map, create a linear composited map in a photo editor, using The following example image demonstrates the individual components of a full detail map. - + ### Desaturated albedo (red channel) @@ -53,7 +53,7 @@ The red channel represents the albedo variation. It makes the underlying materia The image below shows the impact of the detail albedo on the final color. HDRP calculates color interpolation in sRGB space. - + ### Smoothness (blue channel) @@ -61,8 +61,8 @@ The blue channel represents the smoothness variation and HDRP calculates it the The image below shows the impact of the detail smoothness on the final color. - + The following example shows the same gradient detail map as above, used by three Lit materials with different smoothness values. - + diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Material-Type.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Material-Type.md index e67490f389f..5d64aec6bc8 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Material-Type.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Material-Type.md @@ -11,7 +11,7 @@ The **Material Type** property allows you to give your Material a type, which al | **Specular Color** | Applies the Specular Color workflow to the Material. Use this **Material Type** to create Materials with a coloured specular highlight. This is similar to the [built-in Specular Shader](https://docs.unity3d.com/Manual/StandardShaderMaterialParameterSpecular.html). | | **Translucent** | Applies the Translucent workflow to the Material. Use this **Material Type**, and a thickness map, to simulate a translucent object, such as a plant leaf. In contrast to **Subsurface Scattering** Materials, **Translucent** Materials do not blur light that transmits through the Material. | - + ## Properties diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Diffusion-Profile.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Diffusion-Profile.md index 0887d6e17e4..a298604ce70 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Diffusion-Profile.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Diffusion-Profile.md @@ -13,8 +13,6 @@ To add a **Diffusion Profile List** to a Volume: ## Properties - - [!include[](snippets/Volume-Override-Enable-Properties.md)] | **Property** | **Description** | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Micro-Shadows.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Micro-Shadows.md index 08f2193adc2..83b9a762734 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Micro-Shadows.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Micro-Shadows.md @@ -6,7 +6,7 @@ HDRP uses the details from the normal map, the ambient occlusion map, and specul In this image, the different layers of details in the Material shadow each other. - + Micro shadows at 0.85 opacity on a mossy ground material viewed from the top. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Screen-Space-Refraction.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Screen-Space-Refraction.md index efc30f774dd..0c58e032397 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Screen-Space-Refraction.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Override-Screen-Space-Refraction.md @@ -15,7 +15,7 @@ To use this setting, you must enable it on a [Volume](understand-volumes.md), as 1. In the Scene or Hierarchy view, select a GameObject that contains a Volume component. 2. In the Inspector for this object, select **Add Override** > **Lighting** > **Screen Space Refraction**. -
+
In the refractive cube on the left of the screen, **Screen Weight Distance** affects the edges of the screen where HDRP fades from using the color buffer to using Reflection Probes. ## Properties diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Physical-Light-Units.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Physical-Light-Units.md index 015b5a03685..4bfc60aabac 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Physical-Light-Units.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Physical-Light-Units.md @@ -2,7 +2,7 @@ HDRP uses Physical Light Units (PLU) for its lighting. These units are based on real-life light measurements, like those you see on light bulb packaging or a photographic light meter. Note that for lights to behave properly when using PLU, you need to respect HDRP unit convention (1 Unity unit equals 1 meter). - + ## Units diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Bloom.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Bloom.md index 883fbf51554..bef26203b0b 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Bloom.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Bloom.md @@ -48,7 +48,7 @@ Bloom includes [advanced properties](https://docs.unity3d.com/Packages/com.unity From 2019.3, HDRP provides [lookup textures](Authoring-LUTs.md) that you can use to customize this effect. These lookup textures are for the **Texture** property in the **Lens Dirt** section. To add these Textures to your Unity Project, you must use the Package Manager: -1. Go to **Window** > **Package Manager**. +1. Go to **Window** > **Package Management** > **Package Manager**. 2. In the **Packages** window, select **High Definition RP**. 3. In the **High Definition RP** section, go to **Additional Post-processing Data** and select **Import into Project**. 4. The Textures that are relevant to Bloom are in the **Lens Dirt** folder, so if you only want the lookup Textures for Bloom, only import the contents of the **Lens Dirt** folder. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Chromatic-Aberration.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Chromatic-Aberration.md index d6fd32134f9..6a450a4c94f 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Chromatic-Aberration.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Chromatic-Aberration.md @@ -26,7 +26,7 @@ For more information on the Chromatic Aberration effect, see the [Chromatic Aber From 2019.3, HDRP provides lookup Textures that you can use to customize this effect. These lookup Textures are for the **Spectral Lut** property. To add these Textures to your Unity Project, you must use the Package Manager: -1. Select **Window** > **Package Manager**. +1. Select **Window** > **Package Management** > **Package Manager**. 2. In the **Packages** window, select **High Definition RP**. 3. In the **High Definition RP** section, go to **Additional Post-processing Data** and select **Import into Project**. 4. The Textures that are relevant to Chromatic Aberration are in the **Spectral LUTs** folder, so if you only want the lookup Textures for Chromatic Aberration, only import the contents of the **Spectral LUTs** folder. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Depth-of-Field.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Depth-of-Field.md index de6ba424ce8..cb3ce675995 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Depth-of-Field.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Depth-of-Field.md @@ -17,9 +17,9 @@ Depth Of Field includes [advanced properties](https://docs.unity3d.com/Packages/ ## Properties | **Property** | **Description** | -| ------------------ | ------------------------------------------------------------ | -| **Focus Mode** | Use the drop-down to select the mode that HDRP uses to set the focus for the depth of field effect.
• **Off**: Select this option to disable depth of field.
• **Physical Camera**: Select this option to use the physical [Camera](hdrp-camera-component-reference.md) to set focusing properties for the depth of field effect. For information on what Camera properties affect depth of field, see [Physical Camera settings](#PhysicalCameraSettings).
• **Manual Ranges**: Select this option to use custom values to set the near and far range of the depth of field effect. | -| **Focus Distance Mode** | Use the drop-down to select where the focus distance is specified.
• **Volume**: Reads the focus distance from the Volume.
• **Camera**: Reads the focus distance from the physical camera.
This property only appears when you select **Physical Camera** from the **Focus Mode** drop-down. | +|-|-| +| **Focus Mode** | Use the drop-down to select the mode that HDRP uses to set the focus for the depth of field effect. The options are:
- **Off**: Select this option to disable depth of field.
- **Physical Camera**: Select this option to use the physical [Camera](hdrp-camera-component-reference.md) to set focusing properties for the depth of field effect. For more information about what Camera properties affect depth of field, refer to [Physical Camera settings](#PhysicalCameraSettings).
- **Manual Ranges**: Select this option to use custom values to set the near and far range of the depth of field effect.
- **Volume**: Reads the focus distance from the Volume.
- **Camera**: Reads the focus distance from the physical camera.
This property only appears when you select **Volume** from the **Distance Mode** drop-down. | ### Near Blur @@ -52,12 +52,12 @@ Here is a list of the physical [Camera](hdrp-camera-component-reference.md) prop | **Blades Count** | This determines the shape of the bokeh. For more information on the effect this property has, see the example below. | | **Curvature** | Determines how much of the blades are visible. Use this to change the roundness of bokeh in the blur. For more information on the effect this property has, see the example below. | -This example shows how the **Blade Count** and **Curvature** properties affect the shape of the bokeh: + -* On the left side, there is a five blade iris that's slightly open; producing a pentagonal bokeh. -* On the right side, there is a five blade iris that's wide open; producing a circular bokeh. +This example shows how the **Blade Count** and **Curvature** properties affect the shape of the bokeh: - +* On the left side, there is a five blade iris that's slightly open, producing a pentagonal bokeh. +* On the right side, there is a five blade iris that's wide open, producing a circular bokeh. ## Path-traced depth of field @@ -67,4 +67,4 @@ Path-traced depth of field produces images without any artifacts, apart from noi HDRP computes path-traced depth of field at full resolution and ignores any quality settings from the Volume. - + diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Film-Grain.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Film-Grain.md index 031c2f97e4c..55bd102f059 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Film-Grain.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Film-Grain.md @@ -13,8 +13,6 @@ The Film Grain effect simulates the random optical texture of photographic film, ## Properties - - | **Property** | **Description** | | ------------- | ------------------------------------------------------------ | | **Type** | Use the drop-down to select the type of grain to use. You can select from a list of presets that HDRP includes, or select **Custom** to provide your own grain Texture. | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Main.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Main.md index d993c49c8ad..ed64fc4af5b 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Main.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Main.md @@ -8,8 +8,8 @@ Post-processing effects in HDRP use the [Volume](understand-volumes.md) framewor The images below display a Scene with and without HDRP post-processing. - + Without post-processing. - + With post-processing. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Panini-Projection.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Panini-Projection.md index f6d31c9823e..a78340e5f73 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Panini-Projection.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Panini-Projection.md @@ -15,8 +15,6 @@ For more information about panini projection, see PanoTools’ wiki documentatio ## Properties - - | **Property** | **Description** | | --------------- | ------------------------------------------------------------ | | **Distance** | Use the slider to set the strength of the distortion. | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Propagating-NaNs.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Propagating-NaNs.md index 0b3f1cc5055..b13ea80a0ee 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Propagating-NaNs.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Propagating-NaNs.md @@ -18,13 +18,13 @@ A commonly reported issue in HDRP is that [bloom](Post-Processing-Bloom.md) gene For example, see a NaN caused by a material issue that spreads to the whole scene when HDRP calculates bloom: - + - + - + - + A similar issue occurs when HDRP generates color pyramids for use by features such as [screen-space reflection](Override-Screen-Space-Reflection.md), [screen-space refraction](Override-Screen-Space-Refraction.md), and distortion. @@ -57,9 +57,6 @@ After you capture a frame, RenderDoc can display pixels with a Nan or Inf value 1. In the Texture Viewer, open the **Overlay** drop-down. 2. Select **Nan or Inf/-ve Display**. - - - If the Nan or Inf values are still difficult to find: 1. Look at the bloom dispatches to see where bloom propagates the Nan or Inf pixels from. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Shadows-Midtones-Highlights.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Shadows-Midtones-Highlights.md index f29971137bc..8df8f634438 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Shadows-Midtones-Highlights.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Shadows-Midtones-Highlights.md @@ -13,8 +13,6 @@ The **Shadows Midtones Highlights** effect separately controls the shadows, midt ## Properties - - | **Property** | **Description** | | -------------- | ------------------------------------------------------------ | | **Shadows** | Use this to control the shadows. Use the trackball to select the color HDRP should shift the hue of the shadows to. Use the slider to offset the color lightness of the trackball color. | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Split-Toning.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Split-Toning.md index efd0ad51a63..e2814023d5d 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Split-Toning.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-Split-Toning.md @@ -15,8 +15,6 @@ This effect tints different areas of the image based on luminance values, to hel When you adjust the color in the color picker for each property, you should only adjust the **Hue** and **Saturation**. **Value** also changes the overall image brightness. - - | **Property** | **Description** | | -------------- | ------------------------------------------------------------ | | **Shadows** | Use the color picker to select the color that HDRP uses for tinting shadows. | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-White-Balance.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-White-Balance.md index 68a99d0a738..bc3de908af3 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-White-Balance.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Post-Processing-White-Balance.md @@ -13,8 +13,6 @@ The White Balance component applies a white balance effect that removes unrealis ## Properties - - | **Property** | **Description** | | --------------- | ------------------------------------------------------------ | | **Temperature** | Use the slider to set the white balance to a custom color temperature. Higher values result in a warmer color temperature and lower values result in a colder color temperature. See [Wikipedia: Color balance](https://en.wikipedia.org/wiki/Color_balance) for more information about color temperature. | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Contact-Shadows.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Contact-Shadows.md index e15d5faf8a8..8a4d3965c84 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Contact-Shadows.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Contact-Shadows.md @@ -2,17 +2,14 @@ Ray-Traced Contact Shadows is a ray tracing feature in the High Definition Render Pipeline (HDRP). It's an alternative to HDRP's [Contact Shadow](Override-Contact-Shadows.md) technique that uses a more accurate ray-traced solution that can use off-screen data. - +
+A stone temple scene without contact shadows. Foliage and dark corners have few shadows. -**Without Contact shadows** +
+A stone temple scene with contact shadows. Foliage and dark corners have more shadows. - - -**Contact shadows** - - - -**Ray-traced contact shadows** +
+A stone temple scene with ray-traced contact shadows. Foliage and dark corners have even more shadows. For information about ray tracing in HDRP, and how to set up your HDRP Project to support ray tracing, see [Getting started with ray tracing](Ray-Tracing-Getting-Started.md). @@ -27,5 +24,3 @@ This feature is an alternative to the [Contact Shadows](Override-Contact-Shadows 3. HDRP calculates ray-traced contact shadows on a per-light basis. This means you need to enable it for each light. 4. Select a [Light](Light-Component.md) and, in the Inspector, go to **Shadows > Contact Shadows** and tick the **Enable** checkbox. This exposes the **Ray Tracing** property. 5. Enable the **Ray Tracing** checkbox. - - diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Shadows.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Shadows.md index 844eaa469be..ae7bc9b52a9 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Shadows.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Shadows.md @@ -41,29 +41,29 @@ If a light is has **Shadowmask Mode** set to **Shadowmask**, then ray traced sha Ray-traced shadows offer an alternative to the cascade shadow map that Directional Lights use for opaque GameObjects. - + -**Directional Light cascade shadow map** +Directional Light cascade shadow map - + -**Ray-traced Directional Light shadows (Sun Angle = 0)** +Ray-traced Directional Light shadows (Sun Angle = 0) - + -**Ray-traced Directional Light shadows (Sun Angle = 0.53, the angle of the Sun as seen from Earth)** +Ray-traced Directional Light shadows (Sun Angle = 0.53, the angle of the Sun as seen from Earth) Ray-traced shadows allow for transparent and transmissive GameObjects, lit by Directional Lights, to cast colored shadows. **Note**: When you use a Directional Light with a transmissive GameObject, HDRP displays rasterized shadows on the reverse side of the GameObject. - + -**Ray-traced Directional Light shadows with colored shadows** +Ray-traced Directional Light shadows with colored shadows - + -**Ray-traced Directional Light shadows without colored shadows** +Ray-traced Directional Light shadows without colored shadows ### Properties @@ -81,27 +81,27 @@ Ray-traced shadows allow for transparent and transmissive GameObjects, lit by Di Ray-traced shadows offer an alternative to the shadow map that Point and Spot Lights use for opaque GameObjects. HDRP still evaluates the lighting of a Point Light as coming from a single point in space (the light is [punctual](Glossary.md#punctual-lights)), but it evaluates the shadowing as if the light was coming from the surface of a sphere. On the other side, HDRP evaluates the lighting of a Spot Light as coming from a single point in space, but it evaluates the shadowing as if the light was coming from the surface of a cone. - + -**Point Light shadow map** +Point Light shadow map - + -**Ray-traced Point Light shadows (Radius = 0.001m)** +Ray-traced Point Light shadows (Radius = 0.001m) - + -**Ray-traced Point Light shadows (radius = 0.5m)** +Ray-traced Point Light shadows (radius = 0.5m) Ray-traced shadows offer the possibility of semi-transparent shadows for Point Lights cast by transparent and transmissive GameObjects. - + -**Ray-traced Point Light shadows with semi-transparent shadows** +Ray-traced Point Light shadows with semi-transparent shadows - + -**Ray-traced Point Light shadows without semi-transparent shadows** +Ray-traced Point Light shadows without semi-transparent shadows ### Properties @@ -120,11 +120,11 @@ Ray-traced shadows offer the possibility of semi-transparent shadows for Point L Ray-traced shadows offer an alternative to the [exponential variance shadow map](Glossary.md#ExponentialVarianceShadowMap) that Rectangle Lights use for opaque GameObjects. - -**Rectangle Light shadow map** + +Rectangle Light shadow map - -**Ray-traced Rectangle Light shadows** + +Ray-traced Rectangle Light shadows **Note**: When rendering in [deferred mode](Forward-And-Deferred-Rendering.md), HDRP provides accurate ray-traced area light shadows for the [Lit](lit-material.md) shader. When HDRP renders for any other shader, or for the Lit shader in forward mode, it uses an approximation to calculate ray-traced shadows for area lights. This approximation is not perfectly accurate, but does produce plausible results. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Subsurface-Scattering.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Subsurface-Scattering.md index ec3161f2a3e..8ceda085788 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Subsurface-Scattering.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Traced-Subsurface-Scattering.md @@ -2,9 +2,9 @@ Ray-Traced Subsurface Scattering is a ray tracing feature in the High Definition Render Pipeline (HDRP). It is an alternative, more accurate, ray-traced solution to [Subsurface-Scattering](skin-and-diffusive-surfaces-subsurface-scattering.md) that can make use of off screen data. - + -**Perry head rendered with ray traced subsurface scattering** +A head rendered with ray traced subsurface scattering. ## Using ray traced subsurface scattering diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Tracing-Debug.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Tracing-Debug.md index d737beb33ba..19905b29040 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Tracing-Debug.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Ray-Tracing-Debug.md @@ -6,67 +6,25 @@ The High Definition Render Pipeline (HDRP) includes the [Rendering Debugger wind 2. Select the **Lighting** panel. 3. Use the **Fullscreen Debug Mode** drop-down menu to select which ray tracing effect to debug. - + -**Light Cluster [Debug Mode](Ray-Tracing-Debug.md#debug-modes)**: The color shows the number of lights in each cell of the cluster. +**Light Cluster Debug Mode**: The color shows the number of lights in each cell of the cluster. - + -**Ray Tracing Acceleration Structure [Debug Mode](Ray-Tracing-Debug.md#debug-modes)**: This debug mode displays the GameObjects HDRP uses to compute specific ray traced effects. +**Ray Tracing Acceleration Structure Debug Mode**: This debug mode displays the GameObjects HDRP uses to compute specific ray traced effects. ## Debug modes -
| Fullscreen Debug Mode | -Description | -|
|---|---|---|
| Screen Space Ambient Occlusion | -When Ray-Traced Ambient Occlusion is active, this displays the screen space buffer that holds the ambient occlusion. | -|
| Screen Space Reflection | -When Ray-Traced Reflections are active, this displays the ray-traced reflections. | -|
| Transparent Screen Space Reflection | -When Ray-Traced Reflections are active, this displays the ray-traced reflections on transparent objects. | -|
| Contact Shadows | -When Ray-Traced Contact Shadows are active, this displays the ray-traced contact shadows. | -|
| Screen Space Shadows | -When screen space shadows are active, this displays the set of screen space shadows. If you select this option, Unity exposes the Screen Space Shadow Index slider that allows you to change the currently active shadows. Area lights shadows take two channels. | -|
| Screen Space Global Illumination | -When Ray-Traced Global Illumination is active, this displays a screen space buffer that holds the indirect diffuse lighting. | -|
| Recursive Ray-Tracing | -When Recursive Ray Tracing is active, this displays the pixels that have been evaluated using the effect. | -|
| Ray-Traced Subsurface Scattering | -When Ray-Traced Subsurface Scattering is active, this displays the subsurface lighting value for the pixels that have been evaluated using the technique. | -|
| Light Cluster | -This displays the light cluster with the color that varies by the number of the lights in each cell. The red color indicates that the number of lights is over 12 or equal to the maximum number of lights per cell. | -|
| Light Category | -Use the drop-down to visualize the number of the lights in the selected light catetgory. | -|
| Ray Tracing Acceleration Structure | -This mode displays the GameObjects included in the ray tracing acceleration structure for the following effects:
This mode has the following visualization options:
|
-|
- **Light Category**: Use the drop-down to visualize the number of the lights in the selected light category.
- Shadows
- Ambient Occlusion
- Global Illumination
- Reflections
- Recursive Rendering
- Path Tracer
- InstanceID: Assigns a color randomly based on the GameObject's InstanceID.
- PrimitiveID: Assigns a color randomly based on the GameObject's PrimitiveID.
The Light cookie incorrectly affects the transmission of this bulb’s geometry. - - +
Assigning the bulb’s Mesh Renderer to a specific Rendering Layer means that the Light cookie no longer affects the bulb’s Mesh Renderer. - - +
To restore the transmission effect, create a Point Light and assign it to the same Rendering Layer as the bulb’s Mesh Renderer. Now this Point Light only affects the bulb’s Mesh Renderer and does not contribute to the rest of the Scene Lighting. - For more information on this process, see Pierre Donzallaz’s [expert guide](https://pydonzallaz.files.wordpress.com/2019/02/create-high-quality-light-fixtures-in-unity.pdf) on creating high quality light fixtures in Unity. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Shadows-in-HDRP.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Shadows-in-HDRP.md index a3f7322ff12..3488bc431bb 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Shadows-in-HDRP.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Shadows-in-HDRP.md @@ -72,9 +72,7 @@ In HDRP, each individual Light component controls its own shadow biasing using t - **Slope-Scale Depth Bias** - **Normal Bias** -Find these settings under the **Shadows** section. If some property fields are missing, enable [additional properties](expose-all-additional-properties.md) to display them. For details on how each property controls the shadow biasing, see the [Light documentation](Light-Component.md). - - +Find these settings under the **Shadows** section in the **Light** Inspector. If some property fields are missing, enable [additional properties](expose-all-additional-properties.md) to display them. For details on how each property controls the shadow biasing, see the [Light documentation](Light-Component.md). Using high shadow bias values may result in light "leaking" through Meshes. This is where there is a visible gap between the shadow and its caster and leads to shadow shapes that don't accurately represent their casters. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Stencil-Usage.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Stencil-Usage.md index caf23eddd1e..5d11da1e02d 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/Stencil-Usage.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/Stencil-Usage.md @@ -8,8 +8,6 @@ HDRP reserves specific bits for features such as subsurface scattering, SSR, rec During HDRP rendering, a "Clear Stencil Buffer" pass occurs just before starting to render transparent objects, and it doesn't modify user bits. The only instance where user bits are cleared is at the start of rendering when the depth buffer is cleared. - - ## Free Stencil Bits Within the stencil buffer during rendering, bits 6 and 7 remain untouched by HDRP code. Any other bits are HDRP reserved and may be cleared or overwritten at any moment during the frame. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/System-Requirements.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/System-Requirements.md index cc6eb578bbb..f992a9384a3 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/System-Requirements.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/System-Requirements.md @@ -7,18 +7,19 @@ This page contains information on system requirements and compatibility of the H The following table shows the compatibility of the High Definition Render Pipeline (HDRP) versions with different Unity Editor versions. | **Package version** | **Minimum Unity version** | **Maximum Unity version** | -| --------------- | --------------------- | --------------------- | -| 16.0.x | 2023.2 | 2023.x | -| 15.0.x | 2023.1 | 2023.1 | -| 14.0.x | 2022.2 | 2022.x | -| 13.x.x | 2022.1 | 2022.1 | -| 12.0.x | 2021.2 | 2021.3 | -| 11.x | 2021.1 | 2021.1 | -| 10.x | 2020.2 | 2020.3 | -| 9.x-preview | 2020.1 | 2020.1 | -| 8.x | 2020.1 | 2020.1 | -| 7.x | 2019.3 | 2019.4 | -| 6.x | 2019.2 | 2019.2 | +|---------------------|---------------------------|---------------------------| +| 17.x | 6000.x | 6000.x | +| 16.0.x | 2023.2 | 2023.x | +| 15.0.x | 2023.1 | 2023.1 | +| 14.0.x | 2022.2 | 2022.x | +| 13.x.x | 2022.1 | 2022.1 | +| 12.0.x | 2021.2 | 2021.3 | +| 11.x | 2021.1 | 2021.1 | +| 10.x | 2020.2 | 2020.3 | +| 9.x-preview | 2020.1 | 2020.1 | +| 8.x | 2020.1 | 2020.1 | +| 7.x | 2019.3 | 2019.4 | +| 6.x | 2019.2 | 2019.2 | ## Render pipeline compatibility diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/TableOfContents.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/TableOfContents.md index 68421eedb6c..ea38b46f2a5 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/TableOfContents.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/TableOfContents.md @@ -45,6 +45,7 @@ * [Set up a Volume](set-up-a-volume.md) * [Create a Volume Profile](create-a-volume-profile.md) * [Configure Volume Overrides](configure-volume-overrides.md) + * [Troubleshooting volumes](volumes-troubleshooting.md) * [Convert a project from the Built-in Render Pipeline](convert-project-from-built-in-render-pipeline.md) * [Convert post-processing scripts](convert-from-built-in-convert-post-processing-scripts.md) * [Convert lighting and shadows](convert-from-built-in-convert-lighting-and-shadows.md) @@ -192,13 +193,12 @@ * [Create realistic clouds (volumetric clouds)](create-realistic-clouds-volumetric-clouds.md) * [Create simple clouds (Cloud Layer)](create-simple-clouds-cloud-layer.md) * [Create custom cloud effects](create-custom-cloud-effects.md) + * [Troubleshooting Volumetric Clouds rendering issues](troubleshooting-volumetric-clouds-rendering-issues.md) * [Fog](fog.md) * [Understand fog](Understand-Fog.md) * [Create a global fog effect](create-a-global-fog-effect.md) * [Create a local fog effect](create-a-local-fog-effect.md) * [Create a Fog Volume shader](create-a-fog-volume-shader.md) - * [Volumetric fog samples](VolumetricSamplesDescriptions.md) - * [Set up a volumetric sample scene](set-up-the-volumetric-sample-scene.md) * [Troubleshoot fog](troubleshoot-fog.md) * [Water](water.md) * [Use the water system in your Project](water-use-the-water-system-in-your-project.md) @@ -242,7 +242,7 @@ * [Use the Rendering Debugger](use-the-rendering-debugger.md) * [Add controls to the Rendering Debugger](add-controls-to-the-rendering-debugger.md) * [Rendering and post-processing](rendering-and-post-processing.md) - * [Understand execution order](rendering-execution-order.md) + * [Execution order reference](rendering-execution-order.md) * [Understand post-processing](Post-Processing-Main.md) * [Anti-aliasing](Anti-Aliasing.md) * [Dynamic resolution](Dynamic-Resolution.md) @@ -311,7 +311,6 @@ * [Customize the High Definition Render Pipeline (HDRP)](render-graph.md) * [Test and debug rendering and post-processing](rendering-troubleshoot.md) * [Troubleshoot a custom pass](Custom-Pass-Troubleshooting.md) - * [View a custom pass in the Frame Debugger](Custom-Pass-Frame-Debugger.md) * [Troubleshoot a custom post-processing effect](rendering-troubleshoot-custom-post-processes.md) * [Understand and fix Not a Number (NAN) and Infinite (Inf) values](Post-Processing-Propagating-NaNs.md) * [Known issues](Known-Issues.md) diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/VolumetricSamplesDescriptions.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/VolumetricSamplesDescriptions.md deleted file mode 100644 index fbb5ce8fa2e..00000000000 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/VolumetricSamplesDescriptions.md +++ /dev/null @@ -1,92 +0,0 @@ -# Volumetric fog samples - -This page provides an overview of how to use the Local Volumetric Fog component -in Unity to enhance your fog effects with **3D Textures** or **Shader -Graphs**. It also covers various blending modes and quality settings to optimize -the visual quality and performance of your fog effects. - - - -Learn how to configure the Local Volumetric Fog component, use different -blending modes, and explore a variety of sample effects like 3D texture masks, -ground smoke, local clouds, foggy orbs, procedural noise fog, and fumes. Each -sample demonstrates unique techniques for creating and controlling volumetric -fog effects. - -## Using local volumetric fog - -The Local Volumetric Fog component allows you to use **3D Textures** or **Shader -Graphs** to add details and animation locally to the fog. **Blending Modes** -also allow you to add, multiply, or overwrite fog values. - -The **Volumetric Fog quality settings**, found in the active **Volume Profile**, -determine the Local Fog's visual quality. Manual control offers precise -management over the Fog's budget: for an effect with lots of variation over a -short distance, increase the **Volume Slice Count**. If performance becomes an -issue, you can keep the **Screen Resolution Percentage** low as a tradeoff. - -## Sample effects - -### 3D texture mask - -This Local Volumetric Fog uses the **Texture Mask Mode**. It requires a **3D -texture**, with more examples found in **VolumetricSamples/3D Textures**. RGB -channels provide tint, while the alpha channel drives the density. If the 3D -texture contains only the alpha channel, the tint will be presumed white. - -### Ground smoke - -This Ground Smoke Shader Graph relies exclusively on 2D textures. To achieve -this effect, adjust the density vertically by projecting a 2D noise pattern from -above. Two textures of varying sizes move in separate directions, while a basic -color gradient adds depth to the volume. - -### Cloudy (local clouds) - -This Shader Graph creates the Local Clouds Effect using various sampled noises -stored in **3D textures** to generate distinct cloud-like formations. For -realistic sky clouds, opt for **Volumetric Clouds**, as Local Volumetric Fog is -designed for close-range, localized camera effects. - -### Foggy orb and light - -This Foggy Orb uses a Shader Graph. The 3D texture scrolls upwards and rotates, -which helps to give it a good flow. It has a **light** in the middle. - -### Procedural noise fog - -This sample showcases procedural 3D Noise. You can compute 3D noise directly in -the Shader Graph. Several **3D noise functions** are available as **SubGraphs** -found in **VolumetricSamples/Fog Volume Shadergraph/Procedural -Noises**. Procedural Noise can be slow to run due to the complex math -involved. Check out the Material on the Sample to visualize different noise -functions. - -### Fumes - -This Fumes Effect uses a Shader Graph with a **procedural 3D Noise -SubGraph**. Not utilizing any textures allows you to scale and deform the effect -without a loss in quality. - -## Blending modes - -The **Local Volumetric Fog** offers different **Blending Modes**. - -- **Additive blending mode**: Seamlessly blends with the surrounding fog by - adding the color and density values of overlapping volumes. This mode does not - allow subtraction. -- **Overwrite blending mode**: Replaces any fog value and doesn't blend with - surrounding fog. Useful for removing fog from an interior. -- **Multiply blending mode**: Tints the fog color locally and reduces the fog's - density by multiplying it with small values. -- **Min and max blending modes**: Clamp values in one way or the other. - -### Volumetric heart - -This simple Heart effect uses basic math in Shader Graph without involving any -textures. - -## Additional resources - -- [Local Volumetric Fog Volume - Reference](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest/index.html?subfolder=/manual/local-volumetric-fog-volume-reference.html) diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/add-swell-agitation-or-ripples.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/add-swell-agitation-or-ripples.md index 1fc300e8f0f..0361c16a915 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/add-swell-agitation-or-ripples.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/add-swell-agitation-or-ripples.md @@ -23,18 +23,8 @@ To add a simulation mask: 1. In the Water Volume Inspector window, drag the texture to the **Simulation Mask** property. -
-
- |
-
-
- |
-
| -In this example, the red channel has a gradient that reduces the first and second simulation bands. The noise on the green channel reduces ripples. For more information, refer to the Simulation Mask property description. - | -|
•**Texture**: Applies a 3D texture to the fog volume.
•**Material**: Applies a Material to the fog which updates every frame. You can use this to create dynamic fog effects. | | **Blending Mode** | Determines how this fog volume blends with existing fog in the scene:
•**Overwrite**: Replaces existing fog in the volume area with this fog volume.
•**Additive**: Adds the color and density of this fog volume to other fog in the scene. This is the default value.
•**Multiply**: Multiplies the color and density of this fog volume with other fog in the scene. You can use this to create effects relative to a specific fog density.
•**Min**: Determines the minimum density value of this fog volume and the scene fog inside its bounding box. For example, a value of 0 appears to remove fog in a certain area.
•**Max**: Determines the maximum density value of this fog volume and the scene fog inside its bounding box.
| | **Priority** | Determined the order in which HDRP blends fog volumes. HDRP renders the lowest priority volume first and the highest priority last. | +| **Scale Mode** | Specifies the scaling mode to apply to the Local Volumetric Fog Volume. Invariant uses only the size of the volume. Inherit From Hierarchy multiplies the size and the transform scale. | | **Size** | Controls the dimensions of the Volume. | | **Per Axis Control** | Controls the blend distance based on each axis. | | **Blend Distance** | Blend Distance fades from this fog volume's level to the fog level outside it.
This value indicates the absolute distance from the edge of the Volume bounds, defined by the Size property, where the fade starts.
Unity clamps this value between 0 and half of the lowest axis value in the Size property.
If you use the **Normal** tab, you can alter a single float value named Blend Distance, which gives a uniform fade in every direction. If you open the **Advanced** tab, you can use two fades per axis, one for each direction. For example, on the X-axis you could have one for left-to-right and one for right-to-left.
A value of 0 hides the fade, and a value of 1 creates a fade. | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-adjustment-volume-component-reference.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-adjustment-volume-component-reference.md index c9c660983f7..2e5421e7e5a 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-adjustment-volume-component-reference.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-adjustment-volume-component-reference.md @@ -6,93 +6,18 @@ Refer to the following for more information about using the Probe Adjustment Vol - [Fix issues with Adaptive Probe Volumes](probevolumes-fixissues.md) -
| Property | -Description | -|
|---|---|---|
| Influence Volume | -||
| Shape | -Set the shape of the Adjustment Volume to either Box or Sphere. | -|
| Size | -Set the size of the Adjustment Volume. This property only appears if you set Shape to Box. | -|
| Radius | -Set the radius of the Adjustment Volume. This property only appears if you set Shape to Sphere. | -|
| Mode | -
- Select how to override probes inside the Adjustment Volume. -
|
- |
| Dilation Validity Threshold | -
- Override the ratio of backfaces a probe samples before HDRP considers it invalid. This option only appears if you set Mode to Override Validity Threshold, and you enable Additional Properties. - |
- |
| Virtual Offset Rotation | -
- Set the rotation angle for the Virtual Offset vector on all probes in the Adjustment Volume. This option only appears if you set Mode to Apply Virtual Offset. - |
- |
| Virtual Offset Distance | -
- Set how far HDRP pushes probes along the Virtual Offset Rotation vector. This option only appears if you set Mode to Apply Virtual Offset. - |
- |
| Geometry Bias | -
- Sets how far HDRP pushes a probe's capture point out of geometry after one of its sampling rays hits geometry. This option only appears if you set Mode to Override Virtual Offset Settings. - |
- |
| Ray Origin Bias | -Override the distance between a probe's center and the point HDRP uses to determine the origin of that probe's sampling ray. This can be used to push rays beyond nearby geometry if the geometry causes issues. This option appears only if you set Mode to Override Virtual Offset Settings. - |
- |
| Intensity Scale | -
- Change the brightness of all probes covered by the Probe Volumes Adjustment Volume component. Use this sparingly, because changing the intensity of probe data can lead to inconsistencies in the lighting. This option only appears if you set Mode to Intensity Scale. - |
- |
| Preview Probe Adjustments | -
- Preview the effect of the adjustments in the Scene view and the Rendering Debugger. - |
- |
| Bake Probe Volumes | -
- Bake the Adaptive Probe Volumes with the adjustments. - |
- |
- **Shape**: Set the shape of the Adjustment Volume to either **Box** or **Sphere**.
- **Size**: Set the size of the Adjustment Volume. This property only appears if you set **Shape** to **Box**.
- **Radius**: Set the radius of the Adjustment Volume. This property only appears if you set **Shape** to **Sphere**.
- **Invalidate Probes:** Mark selected probes as invalid. Refer to [How light probe validity works](probevolumes-fixissues.md#how-light-probe-validity-works) for more information.
- **Override Validity Threshold:** Override the threshold HDRP uses to determine whether Light Probes are marked as invalid. Refer to [Adjust Dilation](probevolumes-fixissues.md#adjust-dilation) for more information.
- **Apply Virtual Offset:** Change the position Light Probes use when sampling the lighting in the scene during baking. Refer to [Adjust Virtual Offset](probevolumes-fixissues.md#adjust-virtual-offset) for more information.
- **Override Virtual Offset Settings:** Override the biases HDRP uses during baking to determine when Light Probes use Virtual Offset, and calculate sampling positions. Refer to [Adjust Virtual Offset](probevolumes-fixissues.md#adjust-virtual-offset) for more information.
- **Intensity Scale:** Override the intensity of probes to brighten or darken affected areas.
- **Override Sky Direction:** Override the directions Unity uses to sample the ambient probe, if you enable [sky occlusion](probevolumes-skyocclusion.md).
- **Override Sample Count:** Override the number of samples Unity uses for Adaptive Probe Volumes.
+
The car model is made up of separate GameObjects. The left scene uses Light Probe Groups, which use per-object lighting, so each part of the car samples a single blended probe value. The right scene uses Adaptive Probe Volumes, which use per-pixel lighting, so each part of the car samples its nearest probes. This image uses the ArchVizPRO Photostudio HDRP asset from the Unity Asset Store. 
diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-fixissues.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-fixissues.md index 16eee27c819..90766a7a973 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-fixissues.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-fixissues.md @@ -14,11 +14,11 @@ HDRP uses the following techniques to minimise incorrect lighting data from Ligh You can check which Light Probes are invalid using the [Rendering Debugger](rendering-debugger-window-reference.md#ProbeVolume). -
-In the Scene on the left, Virtual Offset isn't active and dark bands are visible. In the Scene on the right, Virtual Offset is active. +
+In the scene on the left, Virtual Offset isn't active so dark bands are visible. In the scene on the right, Virtual Offset is active so there are no dark bands. -
-In the Scene on the left, Dilation isn't active and some areas are too dark. In the Scene on the right, Dilation is active. +
+In the scene on the left, Dilation isn't active so some areas are too dark. In the scene on the right, Dilation is active so the areas are no longer dark. ## Fix dark blotches or streaks @@ -39,7 +39,7 @@ You can also disable Virtual Offset for a Baking Set. Virtual Offset only affect ### Adjust Dilation -You can configure **Probe Dilation Settings** in the [Adaptive Probe Volumes panel](probevolumes-lighting-panel-reference.md) in the Lighting window). This changes how HDRP calculates the validity of Light Probes, and how invalid Light Probes use lighting data from nearby valid Light Probes. +You can configure **Probe Dilation Settings** in the [Adaptive Probe Volumes panel](probevolumes-lighting-panel-reference.md) in the Lighting window. This changes how HDRP calculates the validity of Light Probes, and how invalid Light Probes use lighting data from nearby valid Light Probes. You can adjust the following: @@ -56,9 +56,8 @@ You can also disable Dilation for a Baking Set. Dilation only affects baking tim Light leaks are areas that are too light or dark, often in the corners of a wall or ceiling. -
-A light leak. -
+
+A wall with light leaks, where one side of the wall is too light and one side of the wall is too dark. Light leaks often occur when geometry receives light from a Light Probe that isn't visible to the geometry, for example because the Light Probe is on the other side of a wall. Adaptive Probe Volumes use regular grids of Light Probes, so Light Probes might not follow walls or be at the boundary between different lighting areas. @@ -151,9 +150,8 @@ Refer to [Probe Adjustment Volume component reference](probevolumes-adjustment-v Seams are artefacts that appear when one lighting condition transitions immediately into another. Seams are caused when two adjacent bricks have different Light Probe densities. Refer to [bricks](probevolumes-concept.md#how-probe-volumes-work) for more information. -
-Two seams. -
+
+Two seams on a wall which show the sharp changes in lighting conditions between light and dark. URP fixes seams automatically. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-streaming.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-streaming.md index ece305d9a54..bbdfa985b21 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-streaming.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/probevolumes-streaming.md @@ -32,7 +32,7 @@ The smallest section HDRP loads and uses is a cell, which is the same size as th To view the cells in an Adaptive Probe Volume, or debug streaming, use the [Rendering Debugger](rendering-debugger-window-reference.md#probe-volume-panel). -
+
The Rendering Debugger with **Display Cells** enabled. ## Load APV data from AssetBundles or Addressables diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/raytracing-troubleshooting.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/raytracing-troubleshooting.md index 6e79d2e5e05..4cc87068da3 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/raytracing-troubleshooting.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/raytracing-troubleshooting.md @@ -44,8 +44,8 @@ You might notice the following symptoms when shadows from directional lights are - The lighting feels flat or unrealistic, especially in large outdoor scenes with sunlight. ### Cause @@ -69,8 +69,8 @@ The following symptoms indicate missing shadows from punctual lights: - Light leaks occur in areas where shadows are meant to be cast by nearby objects. ### Cause @@ -126,8 +126,8 @@ The following symptoms might occur when an indirect specular light leaks: - Reflections seem disconnected from nearby objects or appear out of place. ### Cause @@ -176,9 +176,9 @@ The following symptoms can indicate indirect diffuse light leaks: ### Cause @@ -207,9 +207,9 @@ Fog light leaks have the following symptoms: ### Cause diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/refraction-models.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/refraction-models.md index 27f67be8952..d11b075b2e2 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/refraction-models.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/refraction-models.md @@ -11,7 +11,7 @@ If you use this model, HDRP does the following [during the refraction process](O 2. HDRP uses a sphere to approximate the object's shape, and the diameter of the sphere to determine how far the light travels inside. 3. When the light leaves the object, HDRP uses the sphere's surface normal as part of calculating the second refraction. This determines how much the light bends back. -
+
How HDRP calculates the refracted light for three example pixels, if you use a **Refraction Thickness Map** to set different widths for different pixels on an object. The solid orange lines are vectors that represent the direction of light from the camera to a pixel. The white circles represent spheres that approximate the object's thickness. The solid blue lines are surface normals. To control the diameter of the spheres: @@ -21,10 +21,10 @@ To control the diameter of the spheres: If you use the sphere refraction model with a spherical object, the Scene you see through the object might be upside-down. -
+
The light rays bend a lot when they exit the object, so they cross over and hit the opposite end of the tree. -
+
The view through a refractive sphere is upside-down. ## Planar refraction model @@ -42,7 +42,7 @@ If you use this model, HDRP does the following [during the refraction process](O 2. HDRP uses a parallel plane to approximate the exit surface (this is a 'planar projection'), and the distance between the object's surface and the plane to determine how far the light travels inside. 3. When the light leaves the object, HDRP bends the light back so it has the same direction as the light that entered the object. -
+
How HDRP calculates the refracted light for three example pixels, if you use a **Refraction Thickness Map** to set different widths for different pixels on an object. The solid orange lines are vectors that represent the direction of light from the camera to a pixel. The dotted blue lines represent parallel planes approximating the object's thickness. The solid blue lines are surface normals. To control the distance between the planes: @@ -52,10 +52,10 @@ To control the distance between the planes: Set the thickness to the approximate width of the object. The bigger the width, the more visible the refraction effect. -
+
With a thicker object, the light is offset by a greater amount. -
+
Objects with increasing thickness, showing how the light is increasingly deformed. ## Thin refraction model diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-and-post-processing.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-and-post-processing.md index e5bd1fced6f..b2e7215b017 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-and-post-processing.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-and-post-processing.md @@ -4,7 +4,7 @@ Control how the High Definition Render Pipeline (HDRP) renders a scene and apply |Page|Description| |-|-| -|[Understand execution order](rendering-execution-order.md)|Learn the order in which HDRP executes render passes.| +|[Execution order reference](rendering-execution-order.md)|Learn the order in which HDRP executes render passes.| |[Understand post-processing](Post-Processing-Main.md)|Learn how HDRP performs post-processing.| |[Anti-aliasing](Anti-Aliasing.md)|Use an antialiasing method to reduce the appearance of jagged edges.| |[Dynamic resolution](Dynamic-Resolution.md)|Change the screen resolution automatically to maintain a stable frame rate.| diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-execution-order.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-execution-order.md index bb94eb05881..8f4f69374de 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-execution-order.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-execution-order.md @@ -1,35 +1,135 @@ -# Understand execution order +# Execution order reference -The following diagram shows the order in which the High Definition Render Pipeline (HDRP) executes render passes. +The High Definition Render Pipeline (HDRP) executes render passes using the following stages: -For more information about injection points, refer to [injection points](Custom-Pass-Injection-Points.md). +1. Prepass +2. Prepare LightLoop data +3. Opaque and sky +4. Transparent +5. Post-processing +6. Overlay gizmos - +## Prepass stage + +HDRP executes the prepass stage in the following order: + +1. Before Rendering - custom pass injection point +2. Prepass - depth, normal/smoothness, motion vectors +3. PreRenderSky/Cloud +4. DBuffer - no emissive decal +5. GBuffer +6. After Depth and Normal - custom pass injection point +7. Depth pyramid +8. Camera motion vectors + +## Prepare Lightloop data stage + +1. Shadows or cached shadows, or an [optional async pass](#optional-async-stage) +2. Screen space shadows +3. Generate MaxZPass + + +### Optional async pass + +The optional async pass calculates the following: + +- Lights list +- Screen space ambient occlusion (SSAO) +- Contact shadows +- Volume voxelization +- Screen space reflections (SSR) +- Screen space global illumination (SSGI) + +### Opaque and sky stage + +HDRP executes the opaque and sky stage in the following order: + +1. Deferred lighting +2. Forward opaques +3. Decal emissive +4. Subsurface scattering +5. Sky +6. After Opaque and Sky - custom pass injection point +7. After Opaque and Sky - custom post-processing injection point + +### Transparents stage + +HDRP executes the transparents stage in the following order: + +1. Clear stencil +2. Pre-refraction transparent depth prepass +3. Water G-buffer +4. Waterline +5. Transparent depth prepass +6. Volumetric lighting +7. Fog +8. Clouds +9. High Quality Line Rendering +10. Screen space reflections (SSR) +11. Before PreRefraction - custom pass injection point +12. Transparent pre-refraction +13. Water lighting +14. Color pyramid pre-refraction +15. Screen space multiple scattering (SSMS) +16. Before Transparent - custom pass injection point +17. Transparents +18. Low-resolution transparents +19. Combine transparents +20. Transparent PostPass +21. Transparent UI: HDR output + +## Post-processing stage + +HDRP executes the post-processing stage in the following order: + +1. Color pyramid distortion +2. Distortion +3. Before Post Process - custom pass injection point +4. After Post Process Objects +5. Exposure +6. Deep learning super sampling (DLSS) upsample - before Post +7. Before Temporal anti-aliasing (TAA) - custom post-processing injection point +8. TAA or subpixel morphological anti-aliasing (SMAA) +9. Before Postprocess - custom post-processing injection point +10. Depth of field +11. DLSS upsample - After depth of field +12. Motion blur +13. After Post Process Blurs - custom post-processing injection point +14. Panini projection +15. Lens Flare (SRP) +16. Bloom +17. Uber pass - color grading, lens distortion, chromatic effect, vignette, composite +18. After Post Process - custom post-processing injection point +19. DLSS upsample - After Post +20. Final - grain, dithering, composite, fast approximate anti-aliasing (FXAA) +21. After Post Process - custom post-processing injection point ## Post-processing effect execution order The post-processing system in HDRP applies post-processing effects in a specific order. The system also combines some effects into the same compute shader stack to minimize the number of passes. -### Execution order and effect grouping - HDRP executes post processing effects in the following order, from top to bottom. -| Post-processing passes | Compute shader stack | Final post-processing pass | -| -------------------------------------------------- | --------------------- | -------------------------- | -| NaN Killer | | | -| Anti-aliasing (TAA, SMAA) | | | -| Depth of Field | | | -| Motion Blur | | | -| Panini Projection | | | -| Bloom (Pyramid) | | | -| Color Grading (LUT Baking) | | | -| Screen Space Lens Flare (written in bloom texture) | | | -| Data driven lens flare | | | -| | Lens Distortion | | -| | Chromatic Aberration | | -| | Bloom (Apply) | | -| | Vignette | | -| | Color Grading (Apply) | | -| | | Antialiasing (FXAA) | -| | | Film Grain | -| | | 8-bit Dithering | +| **Effect** | **Execution order** | +|-|-| +| NaN remover | Post-processing pass | +| Anti-aliasing - TAA, SMAA | Post-processing pass | +| Depth of field | Post-processing pass | +| Motion blur | Post-processing pass | +| Panini projection | Post-processing pass | +| Bloom - pyramid | Post-processing pass | +| Color grading - look up table (LUT) baking | Post-processing pass | +| Screen space lens flare, written in bloom texture | Post-processing pass | +| Lens flare (SRP) | Post-processing pass | +| Lens distortion | Compute shader stack | +| Chromatic aberration | Compute shader stack | +| Apply bloom | Compute shader stack | +| Vignette | Compute shader stack | +| Apply color grading | Compute shader stack | +| Anti-aliasing - FXAA | Final post-processing pass | +| Film grain | Final post-processing pass | +| 8-bit dithering | Final post-processing pass | + +## Additional resources + +- [Injection points](Custom-Pass-Injection-Points.md) diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-troubleshoot.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-troubleshoot.md index 819a6af902a..0016702a76d 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-troubleshoot.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/rendering-troubleshoot.md @@ -5,8 +5,10 @@ Identify and fix common problems with rendering, post-processing and custom pass | Page | Description | |-|-| |[Troubleshoot a Custom Pass](Custom-Pass-Troubleshooting.md)|Fix issues with custom pass effects.| -|[View a Custom Pass in the Frame Debugger](Custom-Pass-Frame-Debugger.md)| Use the Frame Debugger to identify issues with a custom pass.| |[Troubleshoot a custom post-processing effect](rendering-troubleshoot-custom-post-processes.md)|Fix issues with custom post-processing effects.| |[Understand and fix Not a Number (NAN) and Infinite (Inf) values](Post-Processing-Propagating-NaNs.md)|Learn how to identify and remove spreading NAN and Inf values.| |[Known issues](Known-Issues.md)|Fix problems you might have with material array size and local HDRP config packages.| +## Additional resources + +- [Check or find a rendering event](xref:frame-debugger-window-event-hierarchy) diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/scene-setup.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/scene-setup.md index cb33e424dc8..da85f37ac8d 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/scene-setup.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/scene-setup.md @@ -8,3 +8,4 @@ Use Volumes in the High Definition Render Pipeline (HDRP) to partition your scen | [Set up a Volume](set-up-a-volume.md) | Create a Volume and assign a Volume Profile. | | [Configure Volume Overrides](configure-volume-overrides.md) | Create a Volume Override and configure its properties. | | [Create a Volume Profile](create-a-volume-profile.md) | Create and customize a Volume Profile. | +| [Troubleshooting volumes](volumes-troubleshooting.md) | Identify and resolve common issues when working with volumes. | diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/set-up-a-volume.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/set-up-a-volume.md index e264f54f8cc..5b587880ef8 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/set-up-a-volume.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/set-up-a-volume.md @@ -37,7 +37,7 @@ To add a volume to your scene and edit its Volume Profile, follow these steps: 2. In the **Scene** or **Hierarchy** view, select the new GameObject to view it in the Inspector. 3. In the **Volume** component, assign a Volume Profile asset. To create a new Volume Profile, select **New**. -The list of Volume Overrides that the Volume Profile contains appears below the Volume Profile asset. You can add or remove Volume Overrides and edit their properties. Refer to [Volume Overrides](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@17.0/manual/VolumeOverrides.html) for more information about changing the Volume Overrides and properties. +The list of Volume Overrides that the Volume Profile contains appears below the Volume Profile asset. You can add or remove Volume Overrides and edit their properties. Refer to [Volume Overrides](https://docs.unity3d.com/Manual/urp/VolumeOverrides.html) for more information about changing the Volume Overrides and properties. ### Example: Create a local post-processing effect diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/set-up-the-volumetric-sample-scene.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/set-up-the-volumetric-sample-scene.md deleted file mode 100644 index dc46b019537..00000000000 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/set-up-the-volumetric-sample-scene.md +++ /dev/null @@ -1,47 +0,0 @@ -# Set up a volumetric sample scene - -1. Select **Window** > **Package manager**. - -1. In the **Package manager** window, select **High Definition RP**. - -1. In the **Samples** tab, import the **Volumetric Samples**. - -1. In the **Project** window, go to **Assets** > **Samples** > **High Definition RP** > HDRP version number > **Volumetric samples** > **Scenes.** - -1. Select the **Volumetric Samples scene.** - -1. Go to **Assets** > **Samples** > **High Definition RP** > HDRP version number > **Volumetric sample**s > **Prefabs**. - -1. Drag one of the following sample prefabs in your scene: - - - -**3D Texture Mask Sample** - - - -**About Blending Modes** - - - -**Cloudy Sample** - - - -**Foggy Orb and Light Sample** - - - -**Fumes Sample** - - - -**Ground Smoke Prefab Sample** - - - -**Procedural Noise Fog Sample** - - - -**Volumetric Heart Sample** diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/settings-and-properties-related-to-the-water-system.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/settings-and-properties-related-to-the-water-system.md index f452ff2a24b..b42c0ab9c6f 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/settings-and-properties-related-to-the-water-system.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/settings-and-properties-related-to-the-water-system.md @@ -7,949 +7,113 @@ This page explains the settings and properties you can use to configure the: * [Water system in the HDRP asset](#waterhdrpasset) -
- ## Water Volume Inspector + ### Additional properties To see properties related to Fade, Caustics Intensity, and Caustics Plane Band Distance, you must enable them in Preferences > Core Render Pipeline. Select the Visibility option All Visible. These properties are not visible by default because they are not essential to use the feature, being primarily for performance optimization. -
-
- - - -
| -Water type - | --Property - | --Description - | -||
| -Pool - | --River - | --Ocean, Sea, or Lake - | -||
| -X | --X | --X | --General - | -|
| -Surface Type - | --Specifies the type of water body that this surface should imitate. - | -|||
| -Geometry Type - | -
-Specifies the shape of the water surface.
-The options are:
-
|
-|||
| -Script Interactions - | --Enable to have the ability to query the water surface position and current direction from the simulation. - | -|||
| -- Full Resolution - | --Only available if Script Interactions is active. Enable to have HDRP calculate the CPU simulation at full resolution. Otherwise, HDRP calculates the simulation at half resolution. Full resolution simulations demand more from the CPU. - | -|||
| -- Evaluate Ripples - | --Only available if Script Interactions is active. Enable to have HDRP include ripples in the simulation on the CPU. Increases visual fidelity, but demands more from the CPU. - | -|||
| -Tessellation - | --Enable to implement tessellation. - | -|||
| -- Max Tessellation Factor - | --Set the level of detail HDRP applies to the surface geometry relative to the camera's position. A higher maximum tessellation factor makes the water surface more detailed and responsive to waves but increases the computational load. - | -|||
| -- Tessellation Factor Fade Start - | --Set the distance from the camera where the tessellation detail begins to decrease. - | -|||
| -- Tessellation Factor Fade Range - | --Set the distance from the camera at which the tessellation factor reaches 0. - | -|||
| -X - | --X - | --X - | --Simulation - | -|
| -Time Multiplier - | --Determines the speed at which HDRP presents the water simulation. Values above 1 increase the simulation speed; values lower than 1 decrease it. - | -|||
| -Simulation Mask - | -
-Set the texture HDRP uses to reduce or stop water frequencies depending on the water surface type.
For more information, refer to Decals and masking in the Water System. - |
-|||
| -X - | --X - | --X - | --Water Decals - | -|
| -Region Size - | --Set the width and length in meters of the region HDRP applies the Water Decal to. - | -|||
| -Region Anchor - | --Anchor the Water Decal to a GameObject. By default, the region follows the camera. To make the region static, anchor it to the water surface. - | -|||
| -Deformation - | --Enable to activate the option for creating a deformation decal. - | -|||
| -Foam - | --Enable to activate the option for creating a foam decal. - | -|||
| - - | --X - | --X - | -
-River surface types: Agitation -Ocean, Sea, or Lake surface types: Swell - |
-|
| -Repetition Size - | --The size of the water patch in meters. Higher values result in less visible repetition. Also affects the Maximum Amplitude of Swell or Agitation simulation bands. - | -|||
| -Distant Wind Speed - | --Represents the speed of distant wind in kilometers per hour. This property indirectly determines the Maximum Amplitude and shape of the swell in a nonlinear way. Nonlinear means that changes to Distant Wind Speed do not have a proportional effect on swells. - | -|||
| -Distant Wind Orientation - | --Represents the orientation of distant wind counterclockwise to the world space X vector. (This vector aligns with the blue handle of the Transform Gizmo). Only affects a swell with a Chaos value less than 1. - | -|||
| -Chaos - | --Determines how much the Local Wind Orientation affects ripples; values less than 1 increase Local Wind Orientation's influence. Values more than 1 decrease Local Wind Orientation's influence. - | -|||
| -Current - | -
-Translates the swell at a constant speed in the given direction.
-
|
-|||
| - | --X - | --X - | --Simulation Band properties - | -|
| -Amplitude Dimmer - | -
-Amplitude Dimmer (Ocean, Sea, or Lake) -
-Amplitude Dimmer (River) -A dimmer that determines the degree to which amplitude can reduce on the Agitation simulation band. For example, if your Amplitude value is 10 meters and you set this property to 0.5, your Agitation is 5 meters high. - - - |
-|||
| -Fade - | --Additional property. When this option is active, HDRP begins fading the contribution of this simulation band at the distance from the camera that the Range value specifies. This helps minimize distant aliasing artifacts. - | -|||
| -- Range - | --Additional property. The distance from the camera in meters at which HDRP begins to fade the contribution of this simulation band. - | -|||
| -Total Amplitude - | --The combined amplitude of all bands. - | -|||
| - | -- - | --X - | --Simulation Band property specific to Ocean, Sea, or Lake, appears after Amplitude Mulitplier for each band. - | -|
| -Max Amplitude - | --The amplitude of this band, in meters. This is the sum of the original amplitude and the multiplied amplitude. - | -|||
| -X - | --X - | --X - | -Ripples | -|
| -Local Wind Speed - | --Represents the speed of local wind blowing over the water surface in kilometers per hour. This determines the maximum amplitude and shape of ripples indirectly, in a nonlinear way. Nonlinear means that changes to Local Wind Speed do not have a proportional effect on ripples. - | -|||
| -Local Wind Orientation - | --Represents the orientation of local wind counterclockwise to the world space X vector. (This vector aligns with the blue handle of the Transform Gizmo). Only affects ripples with a Chaos value less than 1. - -River and Ocean, Sea, or Lake only: If set to 0, matches the Distant Wind Orientation. - - - | -|||
| -Chaos - | --Determines how much the Local Wind Orientation affects ripples; values below 1 increase Local Wind Orientation's influence. Values above 1 decrease the influence of Local Wind Orientation. - | -|||
| -Current - | -
-
|
-|||
| -Fade - | --Additional property. When this option is active, HDRP begins fading the contribution of this simulation band at the distance from the camera that corresponds to the Range value in meters. This helps minimize distant aliasing artifacts. - | -|||
| -- Range - | --Additional property. The distance from the camera, in meters, at which HDRP begins to fade the contribution of this simulation band. - | -|||
| -x - | --X - | --X - | -Deformation | -|
| -Enable - | -Specify if this surface supports deformation.. | -|||
| -Resolution - | -The resolution of the deformation texture used to represent the deformation area.
-
|
-|||
| -Area Size - | -Set the size of the deformation area in meters. | -|||
| -Area Offset - | -Set the offset of the deformation area in meters | -|||
| - - | --X - | --X - | -||
| -Foam - | -||||
| Persistence Multiplier | -Determines the lifespan of surface foam. Higher values cause foam to persist longer and leave a trail. | -|||
| -Current Influence - | -Specifies the influence of the swell current on foam. A value of zero means foam stays still, a value of one makes the foam match with current direction and speed. Ripple motion doesn't have any impact on foam. | -|||
| -Color - | -Determines the foam color, which HDRP multiplies by the foam texture to produce the final appearance. | -|||
| -Smoothness - | -Determines how much the foam reflects light. | -|||
| -Texture Tiling - | -Sets the per-meter tiling for the foam texture. | -|||
| Wind Speed Dimmer | -Determines foam intensity. The normalized Distant Wind Speed determines the X axis value. The spline editor configures the Y axis value. Refer to Foam in the water system for more information. | -|||
| Simulation Foam Amount | -Determines the amount of surface foam. Higher values generate larger foam patches. | -|||
| - X - | -- X - | -- X - | -- Appearance - | -|
| -Custom Material - | --Select a custom material Unity can use to render the water surface. If this is None, Unity uses the default material. - | -|||
| -Smoothness - | -||||
| -Close - | --Determines how detailed the water surface is when closer to the Scene camera than the smoothness Fade Start value. - | -|||
| -- Distant - | --Determines how detailed the water surface is when further from the Scene camera than the smoothness Fade Distance value. - | -|||
| -Fade Range - | -
-Specifies the range over which Unity interpolates smoothness from close to distant. -
|
-|||
| -Refraction - | -||||
| -Color - | --Determines the color HDRP uses to simulate underwater refraction. - | -|||
| -Maximum Distance - | --Determines the maximum distance from the Scene camera Unity renders underwater refraction. Higher values increase the distortion amount. - | -|||
| -Absorption Distance - | --Determines how deep into the water the camera can perceive, in meters. - | -|||
| -Scattering - | -||||
| -Color - | --Determines the color that Unity uses to simulate underwater scattering. - | -|||
| -Ambient Term - | --Determines the intensity of the ambient scattering term. - | -|||
| -Height Term - | --Determines the intensity of height-based scattering. The higher the vertical displacement, the more the water receives scattering. You can adjust this for artistic purposes. - | -|||
| -Displacement Term - | --Determines the intensity of displacement-based scattering. The larger this value is, the more the water receives scattering. - | -|||
| -Direct Light Body Term - | --Determines the intensity of direct light scattering on the bodies of waves. - | -|||
| - - | --X - | --X - | --Direct Light Tip Term - | --Determines the intensity of direct light scattering on the tips of waves. You can perceive this effect more at grazing angles. - | -
| -X - | --X - | --X - | --Caustics - | -|
| -X - | --X - | --X - | --Caustics - | --Enable to render caustics. - | -
| -Caustics Resolution - | --The resolution at which Unity renders caustics in the simulation. - | -|||
| - - | --X - | --X - | --Simulation Band - | -
-Determines which Simulation Band Unity uses for caustics evaluation. -For Ocean, Sea, or Lake water surfaces, the Swell simulation determines the first (index 0) and second (index 1) simulation band values. Ripples determine the third band value (index 2). -The River type has two Simulation Bands, one for Agitation simulation and one for Ripples. -For the Pool type, ripples determine the caustics evaluation. A higher Local Wind Speed value results in larger, looser caustics. - |
-
| -X - | --X - | --X - | --Virtual Plane Distance - | --Determines the distance from the camera at which Unity projects simulated caustics. High values generate sharper caustics but can cause artifacts. The larger the waves are, the further the plane distance should be to obtain sharp caustics. - | -
| -Caustics Intensity - | --Additional property. The normalized intensity of underwater caustics. - | -|||
| -Caustics Plane Blend Distance - | --Additional property. The vertical blending distance of the water caustics, in meters from the camera. - | -|||
| -X - | --X - | --X - | --Underwater - | -|
| -Volume Bounds - | --Specifies the collider Unity uses to determine the volume in which it applies the underwater effect for non-infinite water surfaces. - | -|||
| -Volume Priority - | --Determines which surface Unity prioritizes for underwater rendering when multiple water surfaces overlap. Unity renders surfaces with a higher value first. - | -|||
| -Transition Size - | --Where the distance between the camera and the water surface is lower than or equal to this value, Unity begins to blend the water surface rendering with the underwater rendering to prevent a sharp cutoff between them. - | -|||
| -Absorption Distance Multiplier - | --Determines how far the camera can see underwater. For example, a value of 2.0 means the camera can see twice as far underwater as you can from the water surface. - | -|||
| -X - | --X - | --X - | --Miscellaneous - | -|
| -Rendering Layer Mask - | --Specifies the rendering layers that render on the water surface. To use this feature, enable Decal Layers and/or Light Layers in your HDRP Asset. - | -|||
| -Debug Mode - | --Specifies the view of the debug mode used for the water surface. - | -|||
- +### General + +| **Pool** | **River** | **Ocean** | **Property** | **Subproperty** | **Description** | +|--------------|--------------|--------------|-------------------------|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Yes | Yes | Yes | **Surface Type** | N/A | Specifies the type of water body that this surface should imitate. | +| Yes | Yes | Yes | **Geometry Type** | N/A | Specifies the shape of the water surface. The options are: Quad: Based on a square. Instanced Quads: Creates a finite water surface with multiple instanced grids to keep a higher vertex density. Custom Mesh: Based on a Mesh you provide. Overrides the vertical position of the vertices to keep the surface of the water consistently level. Infinite (Ocean only): Bounds the water surface with the Global Volume. | +| Yes | Yes | Yes | **Time Multiplier** | N/A | Specifies the shape of the water surface. The options are: Quad: Based on a square. Instanced Quads: Creates a finite water surface with multiple instanced grids to keep a higher vertex density. Custom Mesh: Based on a Mesh you provide. Overrides the vertical position of the vertices to keep the surface of the water consistently level. Infinite (Ocean only): Bounds the water surface with the Global Volume. | +| Yes | Yes | Yes | **Script Interactions** | N/A | Enable to have the ability to query the water surface position and current direction from the simulation. Refer to Scripting in the water system for more information. | +| Yes | Yes | Yes | N/A | **Evaluate Ripples** | Only available if Script Interactions is active. Enable to have HDRP include ripples in the simulation on the CPU. Increases visual fidelity, but demands more from the CPU. | +| Yes | Yes | Yes | **Tessellation** | N/A | Enable to implement tessellation. | +| Yes | Yes | Yes | N/A | **Max Tessellation Factor** | Set the level of detail HDRP applies to the surface geometry relative to the camera's position. A higher maximum tessellation factor makes the water surface more detailed and responsive to waves but increases the computational load. | +| Yes | Yes | Yes | N/A | **Tessellation Factor Fade Start** | Set the distance from the camera where the tessellation detail begins to decrease. | +| Yes | Yes | Yes | N/A | **Tessellation Factor Fade Range** | Set the distance from the camera at which the tessellation factor reaches 0. | + +### Simulation + +| **Pool** | **River** | **Ocean** | **Property** | **Subproperty** | **Description** | +|--------------|--------------|--------------|---------------------|------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Yes | Yes | Yes | **Water Mask** | N/A | Sets the texture used to attenuate or suppress swell (red and green channels) and ripples (blue channel) water frequencies. | +| No | Yes | Yes | **Agitation/Swell** | N/A | N/A | +| No | Yes | Yes | N/A | **Repetition Size** | Controls the size of the water patch in meters. Larger values results in less visible repetition across the water surface. This parameter also affects the maximum amplitude of the swell frequency bands. | +| No | Yes | Yes | N/A | **Distant Wind Speed** | Controls the speed of the distant wind in kilometers per hour that blowed over the water surface for a long period of time. This indirectly controls the maximum amplitude and shape of the swell in a non-linear way. | +| No | Yes | Yes | N/A | **Chaos** | Controls how directional the swell is. The lower the value, the more the swell waves are traveling in the Distant Wind Orientation. | +| No | Yes | Yes | N/A | **Orientation** | Sets the orientation of distant wind in degrees in a counterclockwise fashion relative to the X world vector. This parameter only affects the swell with a chaos value inferior to one. | +| No | Yes | Yes | N/A | **Current Speed** | Sets the speed of the current for the swell in kilometers per hour. This current translates the I swell at a constant speed. | +| No | Yes | Yes | N/A | **Current Map** | Sets the texture used to modify the local swell or agitation currents. The Red and Green channel of Outdoor the texture contain the 2D direction of the current and Blue channel contains the influence of the current map. | +| No | No | Yes | N/A | **First/Second Band** | N/A | +| No | Yes | Yes | N/A | **Amplitude Dimmer** | Controls the attenuation of amplitude on the frequency band of the swell. | +| No | No | Yes | N/A | **Max Amplitude** | Displays the current maximum amplitude of the frequency band. | +| No | Yes | Yes | N/A | **Fade** | When enabled, HDRP starts fading the contribution of this frequency band over a given range. This helps reduce the aliasing artifacts at a distance. Automatic mode computes the fading range based on the Repetition Size parameter. | +| No | Yes | Yes | N/A | **Total Amplitude** | Displays the current maximum amplitude of the swell. This is the sum of the first and second frequency bands. | +| Yes | Yes | Yes | **Ripples** | N/A | When enabled, the Water System allows you to simulate and render ripples. The frequency range is not affected by the swell/agitation parameters. | +| Yes | Yes | Yes | N/A | **Local Wind Speed** | Controls the speed of the local wind in kilometers per hour that is blowing over the water surface. This indirectly controls the maximum amplitude and shape of the ripples in a non-linear way. | +| Yes | Yes | Yes | N/A | **Chaos** | Controls how directional the ripples are. The lower the value, the more the ripples are traveling in the Local Wind Orientation. | +| Yes | Yes | Yes | N/A | **Motion** | Specifies if the Local Wind's Orientation and Current properties are inherited from the Swell/Agitation or set independently. | +| Yes | Yes | Yes | N/A | **Fade** | When enabled, HDRP starts fading the contribution of this frequency band over a given range. This helps reduce the aliasing artifacts at a distance. Automatic mode computes the fading range based on the Repetition Size parameter. | + +### Water Decals + +| **Pool** | **River** | **Ocean** | **Property** | **Subproperty**| **Description** | +|--------------|--------------|--------------|-------------------|----------------|-----------------------------------------------------------------------------------------------------------| +| Yes | Yes | Yes | **Region Size** | N/A | Sets the extent of the decal region in meters. | +| Yes | Yes | Yes | **Region Anchor** | N/A | Sets the center of the decal region. If nothing is set, the region will follow the main camera transform. | +| Yes | Yes | Yes | **Deformation** | N/A | Specifies if decals deforming the surface of the water are supported. | +| Yes | Yes | Yes | N/A | **Resolution** | Sets the resolution of the texture covering the region. | +| Yes | Yes | Yes | **Foam** | N/A | Specifies if decals injecting foam are supported. | +| Yes | Yes | Yes | N/A | **Resolution** | Sets the resolution of the texture covering the region. | + + + +### Appearance + +| **Pool** | **River** | **Ocean** | **Property** | **Subproperty** | **Description** | +|--------------|--------------|--------------|---------------------|-----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Yes | Yes | Yes | **Custom Material** | N/A | Sets a custom material that will be used to render the water surface. If set to None, a default material is used. | +| Yes | Yes | Yes | **Smoothness** | N/A | N/A | +| Yes | Yes | Yes | N/A | **Value Range** | Controls the smoothness value range over the Fade region. | +| Yes | Yes | Yes | N/A | **Fade Range** | Specifies the range over which the smoothness is interpolated from close to distant. | +| Yes | Yes | Yes | **Refraction** | N/A | N/A | +| Yes | Yes | Yes | N/A | **Color** | Sets the color that is used to simulate the underwater refraction. | +| Yes | Yes | Yes | N/A | **Maximum Distance** | Controls the maximum distance in meters used to clamp the underwater refraction depth. Higher value increases the distortion amount. | +| Yes | Yes | Yes | N/A | **Absorption Distance** | Controls the approximative distance in meters that the camera can perceive through a water surface. This distance can vary widely depending on the intensity of the light the object receives. | +| Yes | Yes | Yes | **Scattering** | N/A | N/A | +| Yes | Yes | Yes | N/A | **Color** | Sets the color that is used to simulate the underwater refraction. The luminance of the color affects the intensity of the scattering terms. | +| Yes | Yes | Yes | N/A | **Ambient Term** | Controls the intensity of the ambient scattering term. You can adjust this for artistic purposes. | +| Yes | Yes | Yes | N/A | **Height Term** | Controls the intensity of the height based scattering. The higher the vertical displacement, the more the water receives scattering. You can adjust this for artistic purposes. | +| Yes | Yes | Yes | N/A | **Displacement Term** | Controls the intensity of the displacement-based scattering. The bigger the horizontal displacement, the more the water receives scattering. You can adjust this for artistic purposes. | +| No | Yes | Yes | N/A | **Direct Light Tip Term** | Controls the intensity of the direct light scattering on the tip of the waves. The effect is more perceivable at grazing angles. | +| Yes | Yes | Yes | N/A | **Direct Light Body Term** | Controls the intensity of the direct light scattering on the body of the waves. The effect is more perceivable at grazing angles. | +| Yes | Yes | Yes | N/A | **Maximum Height Override** | Specifies a maximum wave height that overrides the simulation to support scattering properly for deformers. | +| Yes | Yes | Yes | **Caustics** | N/A | N/A | +| Yes | Yes | Yes | N/A | **Caustics Resolution** | Specifies the resolution at which the water caustics are rendered (simulation only). | +| Yes | Yes | Yes | N/A | **Simulation Band** | Controls which simulation band is used for the caustics evaluation. The first (index 0) and second band (index 1) come from the swell simulation and the third (index 2) one from the ripples. | +| Yes | Yes | Yes | N/A | **Virtual Plane Distance** | Sets the distance at which the simulated caustics are projected. High values generate sharper caustics but can cause artefacts. The larger the waves are, the further the plane distance should be to obtain sharp caustics. | +| Yes | Yes | Yes | N/A | **Tiling Factor** | Sets a tiling factor for the water caustics. | +| Yes | Yes | Yes | N/A | **Intensity** | Sets the intensity of the under-water caustics. | +| Yes | Yes | Yes | N/A | **Caustics Plane Blend Distance** | Sets the vertical blending distance for the water caustics. | +| Yes | Yes | Yes | N/A | **Directional Shadow** | When enabled, the water caustics will take into account the directional light's shadow. | +| Yes | Yes | Yes | **Underwater** | N/A | When enabled, HDRP will apply a fog and color shift to the final image when the camera is under the surface. This feature has a cost even when the camera is above the water surface. | + +### Foam + +| **Pool** | **River** | **Ocean** | **Property** | **Subproperty** | **Description** | +|--------------|--------------|--------------|----------------------------|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Yes | Yes | Yes | **Persistence Mutliplier** | N/A | Specifies the decal foam persistence multiplier. A higher value will lead to the foam remaining visible Outdoor longer. This option requires Foam to be enabled in the Water Decals section. | +| Yes | Yes | Yes | **Current Influence** | N/A | Specifies the influence of the swell current on foam. A value of zero means foam stays still, a value of one makes the foam match with current direction and speed. Ripples motion have no impact on foam. | +| Yes | Yes | Yes | **Color** | N/A | Sets the foam color. | +| Yes | Yes | Yes | **Smoothness** | N/A | Controls the simulation foam smoothness. | +| No | Yes | Yes | **Texture Tiling** | N/A | Sets the per-meter tiling for the foam texture. | +| No | Yes | Yes | **Simulation Foam Amount** | N/A | Sets the amount of foam. | +| No | Yes | Yes | N/A | **Mask** | Sets the texture used to attenuate or suppress the simulation foam. The red channel of the texture is used for the masking. | +| No | Yes | Yes | N/A | **Wind Speed Dimmer** | Controls the foam intensity depending on the normalized Distant Wind Speed. The X axis refers to the normalized Distant Wind Speed, the Y axis refers to the dimmer value. | + +### Miscellaneous + +| **Pool** | **River** | **Ocean** | **Property** | **Description** | +|--------------|--------------|--------------|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------| +| Yes | Yes | Yes | **Rendering Layer Mask** | Specifies the rendering layers that render on the water surface. To use this feature, enable Decal Layers and/or Light Layers in your HDRP Asset. | +| Yes | Yes | Yes | **Debug Mode** | Specifies the view of the debug mode used for the water surface. | # Water system volume override @@ -958,66 +122,12 @@ Specifies the view of the debug mode used for the water surface. To use a Volume Override, you must first add a Volume Profile. Refer to The water system Volume Override for more information. -
| -Property - | --Description - | -|
| -General - | -||
| -State - | --Enable the override to render water surfaces. - | -|
| -Level of Detail - | -||
| -Triangle Size - | --Sets the size of the triangle edge in screen space. - | -|
| -Lighting - | -||
| -Ambient Probe Dimmer - | --Determines the influence of the ambient light probe on the water surface. - | -|
+| **Property** | **Description** | +|-----------------------------------------|---------------------------------------------------------------------------| +| **General** > **State** | Enable the override to render water surfaces. | +| **Level of Detail**> **Triangle Size** | Sets the size of the triangle edge in screen space. | +| **Lighting** > **Ambient Probe Dimmer** | Determines the influence of the ambient light probe on the water surface. | # Water system in the rendering debugger @@ -1026,7 +136,6 @@ Determines the influence of the # water system in the HDRP Asset diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/troubleshooting-volumetric-clouds-rendering-issues.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/troubleshooting-volumetric-clouds-rendering-issues.md new file mode 100644 index 00000000000..a2d60158e32 --- /dev/null +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/troubleshooting-volumetric-clouds-rendering-issues.md @@ -0,0 +1,23 @@ +# Troubleshooting Volumetric Clouds rendering issues + +Prevent far-away clouds from disappearing when the camera moves along the y-axis, especially when traversing the clouds. + +## Symptoms + +Far-away clouds disappear as the camera moves along the y-axis when the **Rendering Space** is set to **World**. + +## Cause + +To enhance performance, the default number of steps used to evaluate the clouds' transmittance is low. This causes the clouds further away to disappear as the camera moves along the y-axis. + +**Note:** In Unity 6, the default rendering space was changed to **World**, making this issue more noticeable than in Unity 2022 LTS, where **Camera** was the default setting. + +## Resolution + +To prevent far-away clouds from disappearing, increase the **Num Primary Steps** value in the **Quality** section of the **Volumetric Clouds** override. + +**Important:** A high **Num Primary Steps** value can hinder performance. Adjust this setting with caution. + +## Additional resources + +- [Create realistic clouds (volumetric clouds)](create-realistic-clouds-volumetric-clouds.md) diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/understand-volumes.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/understand-volumes.md index 99e3cd3fcb8..02fca675ff2 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/understand-volumes.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/understand-volumes.md @@ -28,6 +28,8 @@ Refer to the following for more information: - [Create a Volume Profile](create-a-volume-profile.md) - [Configure Volume Overrides](configure-volume-overrides.md) + + ## Default volumes All HDRP scenes have two default global volumes: @@ -41,3 +43,7 @@ Refer to the following for more information: - [Configure the Default Volume](set-up-a-volume.html#configure-the-default-volume) - [Configure the global volume for a quality level](set-up-a-volume.html#configure-the-global-volume-for-a-quality-level) + +## Caching for volumes + +When you first configure your project, Unity computes the values for [default volumes](#default-volumes) once and then caches them for performance and optimization. Caching prevents repeated calculations during gameplay and enables efficient interpolation between settings. This means that changes to these settings in your script will not have any effect. To implement changes that affect your scene despite caching, refer to [Troubleshooting volumes](volumes-troubleshooting.md). \ No newline at end of file diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/volumes-troubleshooting.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/volumes-troubleshooting.md new file mode 100644 index 00000000000..819d6ddba09 --- /dev/null +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/volumes-troubleshooting.md @@ -0,0 +1,34 @@ +# Troubleshooting volumes + +Identify and resolve common issues when working with volumes. + +## Volume settings aren't updated via scripting + +Changing the values of a Volume Profile currently assigned as Default Volume Profile or Quality Volume Profile through scripting has no effect. + +### Cause + +Unity caches the values of the Project settings for volumes at startup or when you edit the values through the Unity Editor. This means that changes to these settings in your script will not affect your scene unless you explicitly update the cache. For more information, refer to [Understand Volumes](understand-volumes.md). + +### Resolution + +To resolve this issue, use one of the following options. + +#### Create a Global Volume in a scene and override properties using it + +Create a **Global Volume** in a scene and override the properties of a Default Volume Profile using it. Unity doesn't cache properties of a **Global Volume** defined in your scene. + +To configure a Volume Profile to receive updates via a script: + +1. [Add a **Global Volume**](set-up-a-volume#add-a-volume) to the scene. +2. [Add a **Volume Override**](VolumeOverrides) to the **Global Volume**. +3. In the **Volume Override** Inspector window, enable the property you want to change. +4. Modify the corresponding property in your script. + +Unity updates the property correctly because it's not tied to the cached values. + +#### Recache the initial values + +You can explicitly force the volume framework to recalculate its cached values by using the [VolumeManager.instance.OnVolumeProfileChanged(volumeProfile)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.core@latest/index.html?subfolder=/api/UnityEngine.Rendering.VolumeManager.html) method after modifying a value. + +**Important**: Forcing the volume framework to recalculate the cache adds extra workload. This can decrease the performance of volume interpolation in your project. Use this method only when necessary. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-caustics-in-the-water-system.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-caustics-in-the-water-system.md index e379a323308..5c7333ed6a2 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-caustics-in-the-water-system.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-caustics-in-the-water-system.md @@ -1,6 +1,6 @@ # Customize caustics in the water system - + Customize the appearance of caustics, which are bright light patterns on GameObjects caused by the curved water surface reflecting and refracting light. @@ -16,7 +16,7 @@ To calculate caustics from larger waves in a river, ocean, sea, or lake, follow To prevent aliasing artifacts, set **Caustics Resolution** to a higher value. -
+
On the left, caustics with the simulation band set to **Ripples**. On the right, caustics with the simulation band set to **Swell First Band**. ## Add caustics above water diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-create-a-current-in-the-water-system.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-create-a-current-in-the-water-system.md index 1d60a0c4b37..fe59abc85d1 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-create-a-current-in-the-water-system.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-create-a-current-in-the-water-system.md @@ -13,7 +13,7 @@ HDRP includes the River sample scene which shows how a current map behaves. To open the River sample scene: -1. Go to **Window** > **Package Manager**. +1. Go to **Window** > **Package Management** > **Package Manager**. 2. Select **High Definition RP**. 3. In the Samples tab, import the **Environment Samples**. 4. Open the scene named **River**. diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-debug-mode.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-debug-mode.md index b24f9ebf7ea..c9f7109f38c 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-debug-mode.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/water-debug-mode.md @@ -8,33 +8,33 @@ The Simulation Mask mode displays the reduction of each simulation band. White m You can select which channel of the water mask to debug by using the **Simulation Mask Mode** dropdown. Note that, for saving texture space, the red channel always attenuate the first band (First swell band for oceans, Agitation for rivers, Ripples for pools), green channel, the second band (Second swell band for oceans, ripples for rivers)... etc - + ## Simulation Foam Mask The Simulation Foam Mask mode shows where the simulation foam is rendered on your water surface. - + ## Current The Current mode shows in which direction the current flows. You can select between swell or agitation and ripples to debug. Note that this mode does not take into account the chaos parameter set in the simulation section. - + ## Deformation The Deformation mode shows the deformation area and the deformation height of the water surface. - + ## Foam The Foam mode shows the foam are and where the generated foam (both foam from foam generated and simulation foam) are rendered. You can select to show Surface Foam or Deep Foam using the **Water Foam Mode**. - + diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/whats-new-12.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/whats-new-12.md index edb08ee45b1..9f905a6d002 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/whats-new-12.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/whats-new-12.md @@ -25,7 +25,7 @@ You can use this Vertex Block to create an additional velocity for procedural ge ### Cloud Layer System - + HDRP 12.0 introduces a cloud system that you can control through the volume framework. @@ -37,28 +37,24 @@ For detailed steps on how to create custom clouds in your scene, see [creating c HDRP now includes a Volumetric Clouds volume override which allows you to precisely control the cloud coverage in your scene. These clouds receive realistic lighting from the sun and sky. For more information, see the [Volumetric Clouds](create-realistic-clouds-volumetric-clouds.md) documentation. - + - + ### Lens Flares - + HDRP 12.0 includes a new Lens Flare system. You can attach a Lens Flare (SRP) component to any GameObject. Some Lens Flare properties only appear when you attach a Lens Flare (SRP) component to a light. Each Lens Flare has optional multiple elements that you can control individually. HDRP also provides a [new lens flare asset](shared/lens-flare/lens-flare-asset.md) and a [new lens flare component](shared/lens-flare/lens-flare-component.md) that you can attach to any GameObject. -HDRP includes a new Lens Flare sample that uses presets and Textures. You can see an example of the Textures included in this sample in the image below: - - +HDRP includes a new Lens Flare sample that uses presets and Textures. ### Light Anchor From HDRP 12.0, HDRP includes a new [Light Anchor](light-anchor.md) component. You can attach this component to any light to control the light in Main Camera view. - - ### Light List HDRP version 2021.2 includes a new setting in `ShaderConfig.cs` called `FPTLMaxLightCount`. You can use this setting to set the maximum number of lights per tile on the GPU. To increase this value, you must generate a new Shader config project. For information on how to create a new Shader config project, see [HDRP-Config-Package](). @@ -83,7 +79,7 @@ The image below displays the **Temporal Anti-Aliasing (TAA) Upscale** (A) next t For more information, see [Dynamic Resolution](Dynamic-Resolution.md) - + #### NVIDIA’s Deep Learning Super Sampling @@ -113,10 +109,6 @@ To enable **AMD’s FidelityFX Super Resolution**.: - Open the **Default Fallback Upscale Filter** drop down . - Select **FidelityFX Super Resolution**. - - - - ### Mip Bias Support This HDRP version introduces a new setting called **Use Mip Bias.** This setting improves the detail of any upscaling filters you use in your scene. @@ -128,8 +120,6 @@ To enable **Use Mip Bias**: - Expand the **Dynamic resolution** section. - Enable the **Use Mip Bias** checkbox. - - ### ClearFlag HDRP 2021.2 includes the new `ClearFlag.Stencil` function. Use this to clear all flags from a stencil. @@ -138,7 +128,7 @@ From HDRP 2021.2, `ClearFlag.Depth` does not clear stencils. ### Probe Volumes Global Illumination (Experimental) - + HDRP 12.0 introduces an experimental version of the Probe Volume system that creates pre-computed probe-based global illumination. You can use this system to place light probes automatically and create per-pixel lighting. @@ -206,7 +196,7 @@ You can also choose whether to hide or display ### Path tracing improvements - + HDRP’s path tracing now supports more materials: @@ -244,7 +234,7 @@ When you create a custom decal shader in HDRP 12.x, the accumulated normal value ### Decal normal blending - + From HDRP 12.0 you can use a new option in the [HDRP Asset](HDRP-Asset.md) (**Rendering > Decals > Additive Normal Blending**) to additively blend decal normals with the GameObject's normal map. @@ -272,10 +262,10 @@ Improved the quality of the physically-based Depth Of Field in the following way - Improved support for MSAA to remove artifacts around the edges of visible GameObjects. - + ### Physically Based Hair Shader - + HDRP 12.0 includes a new physically-based Marschner hair shader. You can use this as an alternative to the Kajiya-Kay hair shader. This new shading model allows you to quickly create a hair material that fits any lighting scenario. For more information about this new hair shader model and its parameters, see [Hair Master Stack](hair-master-stack-reference.md). @@ -306,8 +296,6 @@ HDRP 12.0 includes a built-in custom pass that you can use to generate Object ID HDRP 12.0 includes a more precise method to calculate specular occlusion based on Ambient Occlusion (AO) and Bent normals. This replaces the old method for all materials and shader graphs. - - ### Ambient Occlusion and Specular Occlusion In HDRP 12.x, the algorithm that calculates how ambient occlusion and specular occlusion contributes to direct lighting doesn’t use the multi-bounce contribution (GTAOMultiBounce). This gives a more accurate direct lighting result. @@ -323,11 +311,11 @@ HDRP 12.0 improves the quality of the [Screen Space Global Illumination (SSGI)]( SSGI off: - + SSGI on: - + ### Ray Traced Global Illumination diff --git a/Packages/com.unity.render-pipelines.high-definition/Documentation~/whats-new-17.md b/Packages/com.unity.render-pipelines.high-definition/Documentation~/whats-new-17.md index 079d59900b3..1c5d5f3b27f 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Documentation~/whats-new-17.md +++ b/Packages/com.unity.render-pipelines.high-definition/Documentation~/whats-new-17.md @@ -8,7 +8,7 @@ This page contains an overview of new features, improvements, and issues resolve Adaptive Probe Volumes can now be enhance with [Sky Occlusion](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@17.0/manual/probevolumes-skyocclusion.html) baking. - + This add a way to perform dynamic time of day for exterior with a sun light on top of a static lighting scenario like for interior done with Adaptive Probe Volumes. @@ -17,9 +17,6 @@ This add a way to perform dynamic time of day for exterior with a sun light on t #### Fallback New user interface for upscaler fallbacks. This new user interface will help the user set their preference in case a platform or API does not support such upscaler. - - - #### AMD FidelityFX 2.1 Super Resolution for Windows Support for AMD FidelityFX 2.1 Super Resolution for Dx11, Dx12, Vulkan in any GPU vendor. The upscaler includes predefined upscaling modes and can easily be turned on in the HDRP settings by enabling the com.unity.amd internal package. This feature also includes the plugin and public API for programmability and accessibility of this effect on any scriptable object. @@ -28,13 +25,11 @@ Support for AMD FidelityFX 2.1 Super Resolution for Dx11, Dx12, Vulkan in any GP Support for the Spatial-Temporal Post-Processing (STP) upscaler has been added for all platforms. This upscaler produces higher quality visuals than the existing TAAU upscaler, but it only supports dynamic resolution when the hardware dynamic resolution mode is active. This means APIs such as DX11 are only capable of using STP when the resolution scale is forced to a fixed percentage. - - ### SpeedTree Support of SpeedTree 9 files (.st9) exported by the SpeedTree Modeler application. Speedtree is now compatible with GPU Resident Drawer introduced in this release for improve CPU performance. In addition re-designs the SpeedTreeWind & SpeedTreeWindManager implementations to support multiple SpeedTree wind technologies as well as scalable CPU performance. Performance improvements depends on number of tree instances with wind, a speed up of x5-x10 CPU can be observe on MainThread and RenderThread depends on scenario. - + scene with trees in bright autumn colors.](Images/fantasy_kingdom_environment.jpg) ### Path Tracing @@ -42,13 +37,13 @@ Support of SpeedTree 9 files (.st9) exported by the SpeedTree Modeler applicatio Disc and tube shaped area lights are now supported with path tracing. - + #### Separate Volumetric Fog denoising The HDRP path tracer now offers an option to denoise the volumetric fog effect separately from the full color output. - + ### Performance @@ -58,12 +53,10 @@ GPU Resident Drawer Leveraging the power of the [Batch Render Group API](https:/ The extra GPU Culling functionality built on top of GPU Resident drawer allows for GPU-side culling of instances that do not contribute to the final image. This can help to improve GPU performance in scenes with heavy overdraw, and does not require any additional authoring to try out. With Rendering Debugger integration. - + Enable GPU Resident Drawer and occlusion culling via checkbox on the SRP asset. - - ## Updated ### Adaptive Probe Volumes @@ -78,8 +71,6 @@ A new toggle was also added to the Probe Volume Graphics settings to disable the Planet parametrization for effects like fog, physically based sky and volumetric clouds have been moved to a shared place in the [Visual Environement override](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@17.0/manual/visual-environment-volume-override-reference). - - #### Physically Based Sky The Physically Based sky has received a set of improvements and optimizations. @@ -88,33 +79,31 @@ The memory usage for the precomputed tables has also been reduced. Memory and pe Additionally, the PBR sky now includes an ozone layer as part of the atmosphere model. This is especially noticeable when the sun is close to the horizon. - + Finally, aerial perspective can now be enabled to simulate light absorption by particles in the atmosphere when looking at objects in the distance, such as mountains or clouds. - + #### Volumetric clouds The volumetric clouds are not clipped by the far plane anymore. Additionally, earth curvature control was removed as Planet settings are now controlled from the Visual Environement. Local Clouds option is also removed, as far plane clipping does not happen anymore. To preserve the behavior of camera not being able to go inside the clouds, you should now set the **Rendering Space** option in **Camera Space** from the Visual Environement - - #### Water system Support of GameObject transform on Water Surfaces have been improved. Infinite Oceans and surfaces with Instanced Quad geometry can now be translated and rotated, and support setting a negative scale to flip the surface. Added a Water Decal target for ShaderGraph in order to output water deformation and foam directly to the atlas, and avoid going through a CustomRenderTexture. Using the same graph also simplifies authoring when deformation and foam generation are linked. Additionally foam is now animated to follow the current direction. - + Underwater rendering now supports using the volumetric fog to rendering god rays and light shafts. - + Finally, a node has been added to the shadergraph to sample the height of the camera relative to the water surface. It can be used to create water drips and droplets on the camera. Refer to the underwater scene from the water samples in the package manager to see it in action. - + #### Volumetric Fog @@ -131,8 +120,6 @@ They are now more consistent and coherent across the different samples. There is more sharing between pipelines and packages and have dependencies in samples themselves. More explanations, links, files are included to better understand what is presented. - - ### Lens Flare Lens Flares are now have improved XR support. @@ -142,29 +129,23 @@ Additionally, a new ring procedural shape have been added as well as few other f - Support for radial gradient for procedural shapes. - Support for light override to be able to have multiple flares affected by one light. - - ### Hair Improve the workflow for width of a line with the High Quality Line Rendering Feature. Users are now able to express the width in centimeter units on a per-vertex basis. - + Character using per-vertex width values for peach fuzz with uniform width of 0.01cm - + Also, a new rendering LOD mode based on screen coverage of a hair asset have been added to culls strands based on some kind of heuristic. The screen coverage LOD mode allows an artist to define an animation curve, where the x-axis is the ratio between the screen space bounding-box of the hair instance to the viewport. The y-axis is the percentage of strands to render based on this ratio. - - ### Area Lights Area light now used a "pillow" windowing function that is used for range attenuation of both rectangular and line lights. Both area (with cookie) and line lights now works correctly with every material type including Water, Hair, Fabric shaders, dual lobe SSS. In addition this version reduce the amount of CPU memory used to store LTC tables. - - ### Path Tracing #### Include for Path Tracing checkbox diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogEditor.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogEditor.cs index 747416783e1..b640ac13f40 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogEditor.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogEditor.cs @@ -111,7 +111,7 @@ static void DrawGizmosSelected(LocalVolumetricFog localVolumetricFog, GizmoType || s_ShapeBox == null || s_ShapeBox.Equals(null)) return; - using (new Handles.DrawingScope(Matrix4x4.TRS(localVolumetricFog.transform.position, localVolumetricFog.transform.rotation, Vector3.one))) + using (new Handles.DrawingScope(Matrix4x4.TRS(localVolumetricFog.transform.position, localVolumetricFog.transform.rotation, localVolumetricFog.effectiveScale))) { // Blend box s_BlendBox.center = CenterBlendLocalPosition(localVolumetricFog); @@ -131,7 +131,7 @@ static void DrawGizmosSelected(LocalVolumetricFog localVolumetricFog, GizmoType void OnSceneGUI() { //Note: for each handle to be independent when multi-selecting LocalVolumetricFog, - //We cannot rely hereon SerializedLocalVolumetricFog which is the collection of + //We cannot rely here on SerializedLocalVolumetricFog which is the collection of //selected LocalVolumetricFog. Thus code is almost the same of the UI. LocalVolumetricFog localVolumetricFog = target as LocalVolumetricFog; @@ -139,7 +139,7 @@ void OnSceneGUI() switch (EditMode.editMode) { case k_EditBlend: - using (new Handles.DrawingScope(Matrix4x4.TRS(localVolumetricFog.transform.position, localVolumetricFog.transform.rotation, Vector3.one))) + using (new Handles.DrawingScope(Matrix4x4.TRS(localVolumetricFog.transform.position, localVolumetricFog.transform.rotation, localVolumetricFog.effectiveScale))) { //contained must be initialized in all case s_ShapeBox.center = Vector3.zero; @@ -186,10 +186,10 @@ void OnSceneGUI() case k_EditShape: //important: if the origin of the handle's space move along the handle, //handles displacement will appears as moving two time faster. - using (new Handles.DrawingScope(Matrix4x4.TRS(Vector3.zero, localVolumetricFog.transform.rotation, Vector3.one))) + using (new Handles.DrawingScope(Matrix4x4.TRS(localVolumetricFog.transform.position, localVolumetricFog.transform.rotation, localVolumetricFog.effectiveScale))) { //contained must be initialized in all case - s_ShapeBox.center = Quaternion.Inverse(localVolumetricFog.transform.rotation) * localVolumetricFog.transform.position; + s_ShapeBox.center = Vector3.zero; s_ShapeBox.size = localVolumetricFog.parameters.size; Vector3 previousSize = localVolumetricFog.parameters.size; @@ -257,9 +257,6 @@ void OnSceneGUI() 1.0f - (newSize.y > 0.00000001 ? (newSize.y - newUniformFade) / newSize.y : 0f), 1.0f - (newSize.z > 0.00000001 ? (newSize.z - newUniformFade) / newSize.z : 0f)); } - - Vector3 delta = localVolumetricFog.transform.rotation * s_ShapeBox.center - localVolumetricFog.transform.position; - localVolumetricFog.transform.position += delta; } } break; diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogUI.Drawer.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogUI.Drawer.cs index 4fdedfa0024..24298da733b 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogUI.Drawer.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogUI.Drawer.cs @@ -79,6 +79,8 @@ static void Drawer_VolumeContent(SerializedLocalVolumetricFog serialized, Editor Vector3 previousPositiveFade = serialized.editorPositiveFade.vector3Value; Vector3 previousNegativeFade = serialized.editorNegativeFade.vector3Value; + EditorGUILayout.PropertyField(serialized.scaleMode, Styles.s_ScaleMode); + EditorGUI.BeginChangeCheck(); EditorGUILayout.PropertyField(serialized.size, Styles.s_Size); if (EditorGUI.EndChangeCheck()) diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogUI.Skin.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogUI.Skin.cs index 576feb02bcb..fd6f24e3e67 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogUI.Skin.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/LocalVolumetricFogUI.Skin.cs @@ -16,6 +16,7 @@ internal static class Styles EditorGUIUtility.IconContent("PreMatCube", "|Modify the influence volume. (SHIFT+2)") }; + public static readonly GUIContent s_ScaleMode = new GUIContent("Scale Mode", "Specifies the scaling mode to apply to the Local Volumetric Fog Volume."); public static readonly GUIContent s_Size = new GUIContent("Size", "Modify the size of this Local Volumetric Fog. This is independent of the Transform's Scale."); public static readonly GUIContent s_AlbedoLabel = new GUIContent("Single Scattering Albedo", "The color this fog scatters light to."); public static readonly GUIContent s_MeanFreePathLabel = new GUIContent("Fog Distance", "Density at the base of the fog. Determines how far you can see through the fog in meters."); diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/SerializedLocalVolumetricFog.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/SerializedLocalVolumetricFog.cs index 33f03f41e89..2785963a2a6 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/SerializedLocalVolumetricFog.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/Lighting/VolumetricLighting/SerializedLocalVolumetricFog.cs @@ -16,6 +16,7 @@ class SerializedLocalVolumetricFog public SerializedProperty textureScroll; public SerializedProperty textureTile; + public SerializedProperty scaleMode; public SerializedProperty size; SerializedProperty positiveFade; @@ -54,6 +55,7 @@ public SerializedLocalVolumetricFog(SerializedObject serializedObject) textureScroll = densityParams.FindPropertyRelative("textureScrollingSpeed"); textureTile = densityParams.FindPropertyRelative("textureTiling"); + scaleMode = densityParams.FindPropertyRelative("scaleMode"); size = densityParams.FindPropertyRelative("size"); positiveFade = densityParams.FindPropertyRelative("positiveFade"); diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Material/UIBlocks/SurfaceOptionUIBlock.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Material/UIBlocks/SurfaceOptionUIBlock.cs index 7e49b97def1..0068fdaf98e 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/Material/UIBlocks/SurfaceOptionUIBlock.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/Material/UIBlocks/SurfaceOptionUIBlock.cs @@ -122,7 +122,7 @@ internal static class Styles public static GUIContent lockWithTilingRateText = new GUIContent("Lock With Height Map Tiling Rate", "When enabled, displacement mapping takes the absolute value of the tiling rate of the height map into account."); // Material ID - public static GUIContent materialIDText = new GUIContent("Material Type", "Specifies additional feature for this Material. Customize you Material with different settings depending on which Material Type you select."); + public static GUIContent materialIDText = new GUIContent("Material Type", "Specifies additional features for this Material. Customize your Material with different settings depending on which Material Type you select."); public static GUIContent transmissionEnableText = new GUIContent("Transmission", "When enabled HDRP processes the transmission effect for subsurface scattering. Simulates the translucency of the object."); public static string transparentSSSErrorMessage = "Transparent Materials With SubSurface Scattering is not supported."; public static GUIContent clearCoatEnabledText = new GUIContent("Clear Coat", "Controls whether the clear coat effect is enabled or not."); @@ -325,7 +325,7 @@ public override void LoadMaterialProperties() transmissionEnable = FindProperty(kTransmissionEnable); clearCoatEnabled = FindProperty(kClearCoatEnabled); - + excludeFromTUAndAA = FindProperty(kExcludeFromTUAndAA); if ((m_Features & Features.DoubleSidedNormalMode) != 0) @@ -874,6 +874,15 @@ protected void DrawLitSurfaceOptions() materialEditor.ShaderProperty(depthOffsetEnable, Styles.depthOffsetEnableText); EditorGUI.indentLevel--; } + + if (displaceMode != DisplacementMode.None && materials[0].GetTexture(kHeightMap) == null) + { + EditorGUILayout.Space(); + EditorGUI.indentLevel++; + + EditorGUILayout.HelpBox("Please set a valid HeightMap (in the 'Surface Inputs' category) to apply any displacement.", MessageType.Warning); + EditorGUI.indentLevel--; + } } } diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/Camera/HDCameraUI.Rendering.Drawers.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/Camera/HDCameraUI.Rendering.Drawers.cs index f81d4b7dcd0..2c90c94b564 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/Camera/HDCameraUI.Rendering.Drawers.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/Camera/HDCameraUI.Rendering.Drawers.cs @@ -148,10 +148,6 @@ static void Drawer_Draw_DLSS_Section(SerializedHDCamera p, Editor owner) { EditorGUI.indentLevel++; EditorGUILayout.PropertyField(p.deepLearningSuperSamplingUseOptimalSettings, HDRenderPipelineUI.Styles.DLSSUseOptimalSettingsContent); - using (new EditorGUI.DisabledScope(p.deepLearningSuperSamplingUseOptimalSettings.boolValue)) - { - EditorGUILayout.PropertyField(p.deepLearningSuperSamplingSharpening, HDRenderPipelineUI.Styles.DLSSSharpnessContent); - } EditorGUI.indentLevel--; } } diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/HDRenderPipelineUI.Skin.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/HDRenderPipelineUI.Skin.cs index b2a8067c37f..4e439304ba1 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/HDRenderPipelineUI.Skin.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/HDRenderPipelineUI.Skin.cs @@ -277,7 +277,6 @@ public class Styles public static readonly GUIContent TAAUInjectionPoint = EditorGUIUtility.TrTextContent("TAA Upscale Injection Point", "The injection point at which to apply the upscaling."); public static readonly GUIContent STPInjectionPoint = EditorGUIUtility.TrTextContent("STP Injection Point", "The injection point at which to apply the upscaling."); public static readonly GUIContent DLSSUseOptimalSettingsContent = EditorGUIUtility.TrTextContent("DLSS Use Optimal Settings", "Sets the sharpness and scale automatically for NVIDIA Deep Learning Super Sampling, depending on the values of quality settings. When DLSS Optimal Settings is on, the percentage settings for Dynamic Resolution Scaling are ignored."); - public static readonly GUIContent DLSSSharpnessContent = EditorGUIUtility.TrTextContent("DLSS Sharpness", "NVIDIA Deep Learning Super Sampling pixel sharpness of upsampler. Controls how the DLSS upsampler will render edges on the image. More sharpness usually means more contrast and clearer image but can increase flickering and fireflies. This setting is ignored if optimal settings are used."); public static readonly GUIContent FSR2Title = EditorGUIUtility.TrTextContent("AMD FidelityFX Super Resolution 2.0 (FSR2)"); public static readonly GUIContent enableFSR2 = EditorGUIUtility.TrTextContent("Enable Fidelity FX 2.2", "Enables FidelityFX 2.0 Super Resolution (FSR2)."); diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/HDRenderPipelineUI.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/HDRenderPipelineUI.cs index 4fbbdad54fc..2fe854b4ab6 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/HDRenderPipelineUI.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/RenderPipeline/HDRenderPipelineUI.cs @@ -686,10 +686,6 @@ static void Drawer_SectionDynamicResolutionSettings(SerializedHDRenderPipelineAs serialized.renderPipelineSettings.dynamicResolutionSettings.DLSSInjectionPoint.intValue = injectionPointVal; EditorGUILayout.PropertyField(serialized.renderPipelineSettings.dynamicResolutionSettings.DLSSUseOptimalSettings, Styles.DLSSUseOptimalSettingsContent); - using (new EditorGUI.DisabledScope(serialized.renderPipelineSettings.dynamicResolutionSettings.DLSSUseOptimalSettings.boolValue)) - { - EditorGUILayout.PropertyField(serialized.renderPipelineSettings.dynamicResolutionSettings.DLSSSharpness, Styles.DLSSSharpnessContent); - } --EditorGUI.indentLevel; } diff --git a/Packages/com.unity.render-pipelines.high-definition/Editor/Water/WaterSurface/VFX/SampleWaterSurface.cs b/Packages/com.unity.render-pipelines.high-definition/Editor/Water/WaterSurface/VFX/SampleWaterSurface.cs index 15e58885dce..04b7fc9effd 100644 --- a/Packages/com.unity.render-pipelines.high-definition/Editor/Water/WaterSurface/VFX/SampleWaterSurface.cs +++ b/Packages/com.unity.render-pipelines.high-definition/Editor/Water/WaterSurface/VFX/SampleWaterSurface.cs @@ -64,7 +64,7 @@ public class OutputProperties [Tooltip("Returns the normal of the Water Surface at the sampled position.")] public Vector3 normal; [Tooltip("Vector that gives the local current orientation.")] - public Vector3 currentDirectionWS; + public Vector2 currentDirectionWS; } public static(string errorID, string errorDesc) ComputeHDRPConfigurationError() @@ -121,7 +121,7 @@ protected override sealed VFXExpression[] BuildExpression(VFXExpression[] inputE VFXExpression outputPosition = new VFXExpressionHLSL("ProjectPoint", ProjectPoint, typeof(Vector3), inputExpression, Array.Empty
Water Surface Debug mode
+ +• For debugging purposes, this scene loads directly with the water surface current debug mode. This allows you to directly see the effect when modifying any of the splines in theSpline To Texture
+ +• TheShader Graph supports three targets: the [Universal Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@12.0/manual/index.html), the [High Definition Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@12.0/manual/index.html), and [Built-In Render Pipeline](https://docs.unity3d.com/2020.3/Documentation/Manual/render-pipelines.html). Target-specific settings appear below the standard setting options. The displayed Target-specific settings change according to which Targets you select. | +| Active Targets | A list that contains the Targets you've selected. You can add or remove entries using the Add (**+**) and Remove (**-**) buttons.
Shader Graph supports three targets: the [Universal Render Pipeline](https://docs.unity3d.com/Manual/urp/urp-introduction.html), the [High Definition Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@12.0/manual/index.html), and [Built-In Render Pipeline](https://docs.unity3d.com/2020.3/Documentation/Manual/render-pipelines). Target-specific settings appear below the standard setting options. The displayed Target-specific settings change according to which Targets you select. | diff --git a/Packages/com.unity.shadergraph/Documentation~/Graph-Target.md b/Packages/com.unity.shadergraph/Documentation~/Graph-Target.md index 63b2305a31a..652b6b20eb4 100644 --- a/Packages/com.unity.shadergraph/Documentation~/Graph-Target.md +++ b/Packages/com.unity.shadergraph/Documentation~/Graph-Target.md @@ -10,7 +10,7 @@ Target Settings are specific to each Target, and can vary between assets dependi Typically, each Target you select generates a valid subshader from the graph. For example, a Shader Graph asset with both URP and HDRP Targets will generate two subshaders. When you use a graph that targets multiple render pipelines, you must reimport the Shader Graph asset if you change the active render pipeline. This updates the Material Inspector for any Materials that use your graph. -Shader Graph supports three targets: the [Universal Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@12.0/manual/index.html), the [High Definition Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@12.0/manual/index.html), and the [Built-In Render Pipeline](https://docs.unity3d.com/2020.3/Documentation/Manual/render-pipelines.html). +Shader Graph supports three targets: the [Universal Render Pipeline](https://docs.unity3d.com/Manual/urp/urp-introduction.html), the [High Definition Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@12.0/manual/index.html), and the [Built-In Render Pipeline](https://docs.unity3d.com/2020.3/Documentation/Manual/render-pipelines). Not all blocks are compatible with all targets. If a block in your graph becomes inactive when you choose a target, that block is not compatible with that target. diff --git a/Packages/com.unity.shadergraph/Documentation~/Position-Node.md b/Packages/com.unity.shadergraph/Documentation~/Position-Node.md index 116449a0274..5982556c6cc 100644 --- a/Packages/com.unity.shadergraph/Documentation~/Position-Node.md +++ b/Packages/com.unity.shadergraph/Documentation~/Position-Node.md @@ -21,7 +21,7 @@ The Position Node provides drop-down options for both **World** and **Absolute W The [High Definition Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest/index.html) uses [Camera Relative](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest?preview=1&subfolder=/manual/Camera-Relative-Rendering.html) as its default world space. -The [Universal Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@latest/index.html) uses **Absolute World** as its default world space. +The [Universal Render Pipeline](https://docs.unity3d.com/Manual/urp/urp-introduction.html) uses **Absolute World** as its default world space. ### Upgrading from previous versions If you use a Position Node in **World** space on a graph authored in Shader Graph version 6.7.0 or earlier, it automatically upgrades the selection to **Absolute World**. This ensures that the calculations on your graph remain accurate to your expectations, since the **World** output might change. diff --git a/Packages/com.unity.shadergraph/Documentation~/Posterize-Node.md b/Packages/com.unity.shadergraph/Documentation~/Posterize-Node.md index 0f51078c949..a36c78c942d 100644 --- a/Packages/com.unity.shadergraph/Documentation~/Posterize-Node.md +++ b/Packages/com.unity.shadergraph/Documentation~/Posterize-Node.md @@ -23,6 +23,6 @@ The following example code represents one possible outcome of this node. ``` void Unity_Posterize_float4(float4 In, float4 Steps, out float4 Out) { - Out = floor(In / (1 / Steps)) * (1 / Steps); + Out = floor(In * Steps) / Steps; } ``` diff --git a/Packages/com.unity.shadergraph/Documentation~/Rotate-About-Axis-Node.md b/Packages/com.unity.shadergraph/Documentation~/Rotate-About-Axis-Node.md index fef208686c8..2d0100e03da 100644 --- a/Packages/com.unity.shadergraph/Documentation~/Rotate-About-Axis-Node.md +++ b/Packages/com.unity.shadergraph/Documentation~/Rotate-About-Axis-Node.md @@ -28,17 +28,10 @@ The following example code represents one possible outcome of this node per **Un ``` void Unity_RotateAboutAxis_Radians_float(float3 In, float3 Axis, float Rotation, out float3 Out) { - float s = sin(Rotation); - float c = cos(Rotation); - float one_minus_c = 1.0 - c; - + float s, c; + sincos(Rotation, s, c); Axis = normalize(Axis); - float3x3 rot_mat = - { one_minus_c * Axis.x * Axis.x + c, one_minus_c * Axis.x * Axis.y - Axis.z * s, one_minus_c * Axis.z * Axis.x + Axis.y * s, - one_minus_c * Axis.x * Axis.y + Axis.z * s, one_minus_c * Axis.y * Axis.y + c, one_minus_c * Axis.y * Axis.z - Axis.x * s, - one_minus_c * Axis.z * Axis.x - Axis.y * s, one_minus_c * Axis.y * Axis.z + Axis.x * s, one_minus_c * Axis.z * Axis.z + c - }; - Out = mul(rot_mat, In); + Out = In * c + cross(Axis, In) * s + Axis * dot(Axis, In) * (1 - c); } ``` @@ -48,16 +41,9 @@ void Unity_RotateAboutAxis_Radians_float(float3 In, float3 Axis, float Rotation, void Unity_RotateAboutAxis_Degrees_float(float3 In, float3 Axis, float Rotation, out float3 Out) { Rotation = radians(Rotation); - float s = sin(Rotation); - float c = cos(Rotation); - float one_minus_c = 1.0 - c; - + float s, c; + sincos(Rotation, s, c); Axis = normalize(Axis); - float3x3 rot_mat = - { one_minus_c * Axis.x * Axis.x + c, one_minus_c * Axis.x * Axis.y - Axis.z * s, one_minus_c * Axis.z * Axis.x + Axis.y * s, - one_minus_c * Axis.x * Axis.y + Axis.z * s, one_minus_c * Axis.y * Axis.y + c, one_minus_c * Axis.y * Axis.z - Axis.x * s, - one_minus_c * Axis.z * Axis.x - Axis.y * s, one_minus_c * Axis.y * Axis.z + Axis.x * s, one_minus_c * Axis.z * Axis.z + c - }; - Out = mul(rot_mat, In); + Out = In * c + cross(Axis, In) * s + Axis * dot(Axis, In) * (1 - c); } ``` diff --git a/Packages/com.unity.shadergraph/Documentation~/Rotate-Node.md b/Packages/com.unity.shadergraph/Documentation~/Rotate-Node.md index a9851024b0c..04d5a26b0ed 100644 --- a/Packages/com.unity.shadergraph/Documentation~/Rotate-Node.md +++ b/Packages/com.unity.shadergraph/Documentation~/Rotate-Node.md @@ -29,15 +29,13 @@ The following example code represents one possible outcome of this node per **Un void Unity_Rotate_Radians_float(float2 UV, float2 Center, float Rotation, out float2 Out) { UV -= Center; - float s = sin(Rotation); - float c = cos(Rotation); - float2x2 rMatrix = float2x2(c, -s, s, c); - rMatrix *= 0.5; - rMatrix += 0.5; - rMatrix = rMatrix * 2 - 1; - UV.xy = mul(UV.xy, rMatrix); - UV += Center; - Out = UV; + float s, c; + sincos(Rotation, s, c); + float3 r3 = float(-s, c, s); + float2 r1; + r1.y = dot(UV, r3.xy); + r1.x = dot(UV, r3.yz); + Out = r1 + Center; } ``` @@ -48,14 +46,12 @@ void Unity_Rotate_Degrees_float(float2 UV, float2 Center, float Rotation, out fl { Rotation = Rotation * (3.1415926f/180.0f); UV -= Center; - float s = sin(Rotation); - float c = cos(Rotation); - float2x2 rMatrix = float2x2(c, -s, s, c); - rMatrix *= 0.5; - rMatrix += 0.5; - rMatrix = rMatrix * 2 - 1; - UV.xy = mul(UV.xy, rMatrix); - UV += Center; - Out = UV; + float s, c; + sincos(Rotation, s, c); + float3 r3 = float(-s, c, s); + float2 r1; + r1.y = dot(UV, r3.xy); + r1.x = dot(UV, r3.yz); + Out = r1 + Center; } ``` diff --git a/Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready-Decal.md b/Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready-Decal.md index bcd3e81a8ee..ac30f503e25 100644 --- a/Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready-Decal.md +++ b/Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready-Decal.md @@ -1,7 +1,7 @@ # Decals Decals allow you to apply local material modifications to specific places in the world. You might think of things like applying graffiti tags to a wall or scattering fallen leaves below a tree. But decals can be used for a lot more. In these examples, we see decals making things look wet, making surfaces appear to have flowing water across them, projecting water caustics, and blending specific materials onto other objects. -Decals are available to use in both HDRP and URP, but they need to be enabled in both render pipelines. To use decals, refer to the documentation in both [HDRP](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@17.0/manual/decals.html) and [URP](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@17.0/manual/renderer-feature-decal.html). +Decals are available to use in both HDRP and URP, but they need to be enabled in both render pipelines. To use decals, refer to the documentation in both [HDRP](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@17.0/manual/decals.html) and [URP](https://docs.unity3d.com/Manual/urp/renderer-feature-decal.html). #### Material Projection This decal uses triplanar projection to project a material in 3D space. It projects materials correctly onto any mesh that intersects the decal volume. It can be used to apply terrain materials on to other objects like rocks so that they blend in better with the terrain. diff --git a/Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready-Detail.md b/Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready-Detail.md index 59de6ba7216..1e454e51a9c 100644 --- a/Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready-Detail.md +++ b/Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready-Detail.md @@ -54,7 +54,7 @@ This custom GUI script enables the small texture thumbnails and other features i ## Decals Decals allow you to apply local material modifications to specific places in the world. You might think of things like applying graffiti tags to a wall or scattering fallen leaves below a tree. But decals can be used for a lot more. In these examples, we see decals making things look wet, making surfaces appear to have flowing water across them, projecting water caustics, and blending specific materials onto other objects. -Decals are available to use in both HDRP and URP, but they need to be enabled in both render pipelines. To use decals, see the documentation in both [HDRP](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@17.0/manual/decals.html) and [URP](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@17.0/manual/renderer-feature-decal.html). +Decals are available to use in both HDRP and URP, but they need to be enabled in both render pipelines. To use decals, see the documentation in both [HDRP](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@17.0/manual/decals.html) and [URP](https://docs.unity3d.com/Manual/urp/renderer-feature-decal.html). #### Material Projection This decal uses triplanar projection to project a material in 3D space. It projects materials correctly onto any mesh that intersects the decal volume. It can be used to apply terrain materials on to other objects like rocks so that they blend in better with the terrain. diff --git a/Packages/com.unity.shadergraph/Documentation~/SpeedTree8-SubGraphAssets.md b/Packages/com.unity.shadergraph/Documentation~/SpeedTree8-SubGraphAssets.md index 3429efa03ff..ddfd332c278 100644 --- a/Packages/com.unity.shadergraph/Documentation~/SpeedTree8-SubGraphAssets.md +++ b/Packages/com.unity.shadergraph/Documentation~/SpeedTree8-SubGraphAssets.md @@ -18,7 +18,7 @@ Shader Graph has three built-in SpeedTree Sub Graph Assets: * [SpeedTree8Wind](#SpeedTree8Wind) * [SpeedTree8Billboard](#SpeedTree8Billboard) -These Sub Graph Assets provide SpeedTree 8 functionality for both the [Universal Render Pipeline (URP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@12.0/manual/index.html) and [High Definition Render Pipeline (HDRP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@12.0/manual/index.html), so that you can work with SpeedTree 8 assets and create your own custom SpeedTree 8 Shader Graphs. +These Sub Graph Assets provide SpeedTree 8 functionality for both the [Universal Render Pipeline (URP)](https://docs.unity3d.com/Manual/urp/urp-introduction.html) and [High Definition Render Pipeline (HDRP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@12.0/manual/index), so that you can work with SpeedTree 8 assets and create your own custom SpeedTree 8 Shader Graphs. **Note:** The URP-specific versions of these SpeedTree 8 Sub Graph Assets use transparent billboard back faces instead of culling billboard back faces. These Sub Graph Assets can only replace their URP equivalents as a default once URP supports per-material culling overrides in Shader Graphs. diff --git a/Packages/com.unity.shadergraph/Documentation~/Upgrade-Guide-10-0-x.md b/Packages/com.unity.shadergraph/Documentation~/Upgrade-Guide-10-0-x.md index eff56487221..1d3332b5b05 100644 --- a/Packages/com.unity.shadergraph/Documentation~/Upgrade-Guide-10-0-x.md +++ b/Packages/com.unity.shadergraph/Documentation~/Upgrade-Guide-10-0-x.md @@ -35,7 +35,7 @@ After the upgrade, you can add any required Block nodes that went missing, and r ### Upgrade cross-pipeline Master Nodes to the Master Stack -If your graph contains PBR or Unlit Master Nodes that are compatible with both the [Universal Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@latest) (URP) and the [High Definition Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest) (HDRP), Shader Graph automatically upgrades them to the Master Stack based on the render pipeline currently available in your project. With Master Stacks, when you switch from one render pipeline to another, you must reimport your Shader Graph assets to update the Material Inspector for any Materials in your project. +If your graph contains PBR or Unlit Master Nodes that are compatible with both the [Universal Render Pipeline](https://docs.unity3d.com/Manual/urp/urp-introduction.html) (URP) and the [High Definition Render Pipeline](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest) (HDRP), Shader Graph automatically upgrades them to the Master Stack based on the render pipeline currently available in your project. With Master Stacks, when you switch from one render pipeline to another, you must reimport your Shader Graph assets to update the Material Inspector for any Materials in your project. In URP, you can now find all PBR Master Node settings in the URP Lit Target. The Unlit Master Node settings are in the URP Unlit Target. These settings are the same, and the final shader should appear the same as before the upgrade. diff --git a/Packages/com.unity.shadergraph/Documentation~/index.md b/Packages/com.unity.shadergraph/Documentation~/index.md index b03b1738ca1..44e968d904d 100644 --- a/Packages/com.unity.shadergraph/Documentation~/index.md +++ b/Packages/com.unity.shadergraph/Documentation~/index.md @@ -6,7 +6,7 @@ Shader Graph enables you to build shaders visually. Instead of writing code, you For an introduction to Shader Graph, see [Getting Started](Getting-Started.md). -Shader Graph is available through the Package Manager window in supported versions of the Unity Editor. If you install a Scriptable Render Pipeline (SRP) such as the [Universal Render Pipeline (URP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@latest) or the [High Definition Render Pipeline (HDRP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest), Unity automatically installs Shader Graph in your project. +Shader Graph is available through the Package Manager window in supported versions of the Unity Editor. If you install a Scriptable Render Pipeline (SRP) such as the [Universal Render Pipeline (URP)](https://docs.unity3d.com/Manual/urp/urp-introduction.html) or the [High Definition Render Pipeline (HDRP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest), Unity automatically installs Shader Graph in your project. Shader Graph package versions on Unity Engine 2018.x are *Preview* versions, which do not receive bug fixes and feature maintenance. To work with an actively supported version of Shader Graph, use Unity Engine 2019.1 or higher. @@ -14,7 +14,7 @@ Shader Graph package versions on Unity Engine 2018.x are *Preview* versions, whi With the release of Unity 2021.1, graphics packages are relocating to the core of Unity. This move simplifies the experience of working with new Unity graphics features, as well as ensuring that your projects are always running on the latest verified graphics code. -For each release of Unity (alpha / beta / patch release) graphics packages are embedded within the main Unity installer. When you install the latest release of Unity, you also get the latest [Universal Render Pipeline (URP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@latest), [High Definition Render Pipeline (HDRP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest), Shader Graph, [Visual Effect (VFX) Graph](https://docs.unity3d.com/Packages/com.unity.visualeffectgraph@latest) packages, among others. +For each release of Unity (alpha / beta / patch release) graphics packages are embedded within the main Unity installer. When you install the latest release of Unity, you also get the latest [Universal Render Pipeline (URP)](https://docs.unity3d.com/Manual/urp/urp-introduction.html), [High Definition Render Pipeline (HDRP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest), Shader Graph, [Visual Effect (VFX) Graph](https://docs.unity3d.com/Packages/com.unity.visualeffectgraph@latest) packages, among others. Tying graphics packages to the main Unity release allows better testing to ensure that the graphics packages you use have been tested extensively with the version of Unity you have downloaded. diff --git a/Packages/com.unity.shadergraph/Documentation~/surface-options.md b/Packages/com.unity.shadergraph/Documentation~/surface-options.md index f49bd2ca652..e1df7e53e70 100644 --- a/Packages/com.unity.shadergraph/Documentation~/surface-options.md +++ b/Packages/com.unity.shadergraph/Documentation~/surface-options.md @@ -9,12 +9,12 @@ Enable **Allow Material Override** to modify a specific set of properties for Un
| Property | URP Lit | URP Unlit | Built-In Render Pipeline |
| Workflow Mode | See the URP documentation for the Lit URP Shader. | Not applicable. | Not applicable. |
| Workflow Mode | See the URP documentation for the Lit URP Shader. | Not applicable. | Not applicable. |
| Receive Shadows | |||
| Cast Shadows | This property is only exposed if Allow Material Override is enabled for this Shader Graph. Enable this property to make it possible for a GameObject using this shader to cast shadows onto itself and other GameObjects. This corresponds to the SubShader Tag ForceNoShadowCasting. | Not applicable. | |
| Surface Type | See the URP documentation for the Lit and Unlit Shaders. | In the Built-In Render Pipeline, this feature has the same behavior as in URP. Consult the URP documentation. | |
| Surface Type | See the URP documentation for the Lit and Unlit Shaders. | In the Built-In Render Pipeline, this feature has the same behavior as in URP. Consult the URP documentation. | |
| Render Face | In the Built-In Render Pipeline, this feature has the same behavior as in URP. Consult the URP documentation. | ||