diff --git a/com.unity.render-pipelines.high-definition/Documentation~/Light-Component.md b/com.unity.render-pipelines.high-definition/Documentation~/Light-Component.md index 379bd5343e2..431205165bc 100644 --- a/com.unity.render-pipelines.high-definition/Documentation~/Light-Component.md +++ b/com.unity.render-pipelines.high-definition/Documentation~/Light-Component.md @@ -31,7 +31,7 @@ HDRP includes multiple types of Light. Although HDRP Lights share many propertie For more detailed information on how to configure realistic light fixtures, see the [Create High-Quality Light Fixtures in Unity](https://docs.unity3d.com/uploads/ExpertGuides/Create_High-Quality_Light_Fixtures_in_Unity.pdf) expert guide. For general guidance on light intensities, see [Physical light units](Physical-Light-Units.md#light-intensities). -### Properties +## Properties The properties available for Lights are in separate sections. Each section contains some properties that all Lights share, and also properties that customize the behavior of the specific type of Light. These sections also contain [more options](More-Options.md) that you can expose if you want to fine-tune your light's behavior. The sections are: @@ -65,7 +65,11 @@ To make the Light work with the **Animation window**, when you click on the **Ad | **Spot** | Emits light from a specified location and range over which the light diminishes. A Spot Light constrains the light it emits to an angle, which results in a cone-shaped region of illumination. The center of the cone points in the forward direction (z-axis) of the Light GameObject. Light also diminishes at the edges of the Spot Light’s cone. Increase the **Spot Angle** to increase the width of the cone. | | **Directional** | Creates effects that are similar to sunlight in your Scene. Like sunlight, Directional Lights are distant light sources that HDRP treats as though they are infinitely far away. A Directional Light does not have any identifiable source position, and you can place the Light GameObject anywhere in the Scene. A **Directional Light** illuminates all GameObjects in the Scene as if the Light rays are parallel and always from the same direction. The Light disregards the distance between the Light itself and the target GameObject, so the Light does not diminish with distance. | | **Point** | Projects light out equally in all directions from a point in space. The direction of light hitting a surface is the line from the point of contact back to the center of the Light GameObject. The light intensity diminishes with increased distance from the Light, and it reaches zero at the distance specified in the **Range** field. Light intensity is inversely proportional to the square of the distance from the source. This is known as the [Inverse-square law](https://en.wikipedia.org/wiki/Inverse-square_law), and is similar to how light behaves in the real world. | -| **Area** | Projects light from a surface. Light shines in all directions uniformly from the surface of the rectangle. | +| **Area** | Projects light from a surface. Light shines in all directions uniformly from the surface of the rectangle.| + +##### Limitations + +[!include[](snippets/area-light-material-support-disclaimer.md)] diff --git a/com.unity.render-pipelines.high-definition/Documentation~/Master-Node-Fabric.md b/com.unity.render-pipelines.high-definition/Documentation~/Master-Node-Fabric.md index 93b29c608e7..7695e782368 100644 --- a/com.unity.render-pipelines.high-definition/Documentation~/Master-Node-Fabric.md +++ b/com.unity.render-pipelines.high-definition/Documentation~/Master-Node-Fabric.md @@ -98,3 +98,7 @@ These properties are in the **Exposed Properties** section of the Inspector, alo | **Emission** | Toggles whether emission affects global illumination. | | **- Global Illumination** | The mode HDRP uses to determine how color emission interacts with global illumination.
• **Realtime**: Select this option to make emission affect the result of real-time global illumination.
• **Baked**: Select this option to make emission only affect global illumination during the baking process.
• **None**: Select this option to make emission not affect global illumination. | | **Motion Vector For Vertex Animation** | Enable the checkbox to make HDRP write motion vectors for GameObjects that use vertex animation. This removes the ghosting that vertex animation can cause. | + +## Limitations + +[!include[](snippets/area-light-material-support-disclaimer.md)] \ No newline at end of file diff --git a/com.unity.render-pipelines.high-definition/Documentation~/Master-Node-Hair.md b/com.unity.render-pipelines.high-definition/Documentation~/Master-Node-Hair.md index e7f37a82d1f..039fddba185 100644 --- a/com.unity.render-pipelines.high-definition/Documentation~/Master-Node-Hair.md +++ b/com.unity.render-pipelines.high-definition/Documentation~/Master-Node-Hair.md @@ -93,3 +93,7 @@ These properties are in the **Exposed Properties** section of the Inspector and | **Emission** | Toggles whether emission affects global illumination. | | **- Global Illumination** | Use the drop-down to choose how color emission interacts with global illumination.
• **Realtime**: Select this option to make emission affect the result of real-time global illumination.
• **Baked**: Select this option to make emission only affect global illumination during the baking process.
• **None**: Select this option to make emission not affect global illumination. | | **Motion Vector For Vertex Animation** | Enable the checkbox to make HDRP write motion vectors for GameObjects that use vertex animation. This removes the ghosting that vertex animation can cause. | + +## Limitations + +[!include[](snippets/area-light-material-support-disclaimer.md)] \ No newline at end of file diff --git a/com.unity.render-pipelines.high-definition/Documentation~/cotton-wool-shader.md b/com.unity.render-pipelines.high-definition/Documentation~/cotton-wool-shader.md index c38f97a5ead..5e21585fdd6 100644 --- a/com.unity.render-pipelines.high-definition/Documentation~/cotton-wool-shader.md +++ b/com.unity.render-pipelines.high-definition/Documentation~/cotton-wool-shader.md @@ -65,6 +65,8 @@ New Materials in HDRP use the [Lit shader](Lit-Shader.md) by default. To create | **Fuzz Map UV Scale** | Sets the scale of the Thread UV used to sample the Fuzz Map. | | **Fuzz Strength** | Sets the strength of the Fuzz Color added to the Base Color. | -### +[!include[](snippets/shader-properties/advanced-options/lit-advanced-options.md)] -[!include[](snippets/shader-properties/advanced-options/lit-advanced-options.md)] \ No newline at end of file +## Limitations + +[!include[](snippets/area-light-material-support-disclaimer.md)] \ No newline at end of file diff --git a/com.unity.render-pipelines.high-definition/Documentation~/hair-shader.md b/com.unity.render-pipelines.high-definition/Documentation~/hair-shader.md index 22317c3b705..5bd12f46493 100644 --- a/com.unity.render-pipelines.high-definition/Documentation~/hair-shader.md +++ b/com.unity.render-pipelines.high-definition/Documentation~/hair-shader.md @@ -57,4 +57,8 @@ New Materials in HDRP use the [Lit shader](Lit-Shader.md) by default. To create | **Transmission Color** | Set the fraction of specular lighting that penetrates the hair from behind. This is on a per-color channel basis so you can use this property to set the color of penetrating light. Set this to (0, 0, 0) to stop any light from penetrating through the hair. Set this to (1, 1, 1) to have a strong effect with a lot of white light transmitting through the hair. | | **Transmission Rim** | Set the intensity of back lit hair around the edge of the hair. Set this to 0 to completely remove the transmission effect. | -[!include[](snippets/shader-properties/advanced-options/lit-advanced-options.md)] \ No newline at end of file +[!include[](snippets/shader-properties/advanced-options/lit-advanced-options.md)] + +## Limitations + +[!include[](snippets/area-light-material-support-disclaimer.md)] \ No newline at end of file diff --git a/com.unity.render-pipelines.high-definition/Documentation~/silk-shader.md b/com.unity.render-pipelines.high-definition/Documentation~/silk-shader.md index 33416a0fe01..94342303c71 100644 --- a/com.unity.render-pipelines.high-definition/Documentation~/silk-shader.md +++ b/com.unity.render-pipelines.high-definition/Documentation~/silk-shader.md @@ -63,4 +63,8 @@ New Materials in HDRP use the [Lit shader](Lit-Shader.md) by default. To create | **Fuzz Strength** | Sets the strength of the Fuzz Color added to the Base Color. | | **Diffusion Profile** | Sets the Diffusion Profile, controlling the Subsurface Scattering properties of your Material. | -[!include[](snippets/shader-properties/advanced-options/lit-advanced-options.md)] \ No newline at end of file +[!include[](snippets/shader-properties/advanced-options/lit-advanced-options.md)] + +## Limitations + +[!include[](snippets/area-light-material-support-disclaimer.md)] \ No newline at end of file diff --git a/com.unity.render-pipelines.high-definition/Documentation~/snippets/area-light-material-support-disclaimer.md b/com.unity.render-pipelines.high-definition/Documentation~/snippets/area-light-material-support-disclaimer.md new file mode 100644 index 00000000000..118c71ad2a9 --- /dev/null +++ b/com.unity.render-pipelines.high-definition/Documentation~/snippets/area-light-material-support-disclaimer.md @@ -0,0 +1,7 @@ +Area [Lights](../Light-Component.md) do not currently support Fabric or Hair Materials. This means they do not illuminate or cast shadows for Materials that use any of the following: + +* [Cotton/Wool Shader](../cotton-wool-shader.md) +* [Silk Shader](../silk-shader.md) +* [Hair Shader](../hair-shader.md) +* [Fabric Master Stack](../Master-Node-Fabric.md) +* [Hair Master Stack](../Master-Node-Hair.md) \ No newline at end of file