You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Packages/com.unity.render-pipelines.universal/Documentation~/light-component.md
+23-15Lines changed: 23 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,8 +8,6 @@ This page contains information on Light components in the Universal Render Pipel
8
8
9
9
The Light Inspector includes the following groups of properties:
10
10
11
-
12
-
13
11
*[General](#General)
14
12
*[Shape](#Shape)
15
13
*[Emission](#Emission)
@@ -21,25 +19,33 @@ The Light Inspector includes the following groups of properties:
21
19
| Property:| Function: |
22
20
|:---|:---|
23
21
|**Type**| The current type of light. Possible values are **Directional**, **Point**, **Spot** and **Area**.|
24
-
|**Mode**| Specify the [Light Mode](https://docs.unity3d.com/Manual/LightModes.html) used to determine if and how a light is "baked". Possible modes are **Realtime**, **Mixed** and **Baked**.|
22
+
|**Mode**| Specify the [Light Mode](https://docs.unity3d.com/Manual/LightModes.html) used to determine if and how a light is "baked".<br/><br/>Options:<ul><li>**Realtime**</li><li>**Mixed**</li><li>**Baked**</li></ul><br/>**Note**: If **Type** is set to **Area**, this property is automatically set to **Baked**. |
23
+
|**Rendering Layers**| Set which rendering layers the light applies to.<br/><br/>**Note**: This property is only available if **Mode** is set to **Realtime** or **Mixed**. |
25
24
26
25
### <aname="Shape"></a>Shape
27
26
28
27
| Property:| Function: |
29
28
|:---|:---|
30
-
|**Spot Angle**| Define the angle (in degrees) at the base of a spot light’s cone (**Spot** light only). |
29
+
|**Inner/Outer Spot Angle**| The inner and outer angles (in degrees) at the base of a spot light’s cone (**Spot** light only). |
30
+
|**Shape**| The shape of the area light.<br/><br/>Available options:<ul><li>**Rectangle**</li><li>**Disc**</li></ul> |
31
+
|    **Width**| The width of the area light.<br/><br/>**Note**: This property is only available if **Shape** is set to **Rectangle**. |
32
+
|    **Height**| The height of the area light.<br/><br/>**Note**: This property is only available if **Shape** is set to **Rectangle**. |
33
+
|    **Radius**| The radius of the area light<br/><br/>**Note**: This property is only available if **Shape** is set to **Disc**. |
31
34
32
35
### <aname="Emission"></a>Emission
33
36
34
37
| Property:| Function: |
35
38
|:---|:---|
36
-
|**Color**| Use the color picker to set the color of the emitted light. |
39
+
|**Light Appearance**||
40
+
|    **Color**| The color of the emitted light. Set this property with the color slider.<br/><br/>**Note**: This property is only available if **Light Apperance** is set to **Color**. |
41
+
|    **Filter**| The color of the tint for the light source. Set this property with the color slider.<br/><br/>**Note**: This property is only available if **Light Apperance** is set to **Filter and Temperature**. |
42
+
|    **Temperature**| The temperature (in Kelvin) of the light. Set this property with the slider or enter a specific value.<br/><br/>**Note**: This property is only available if **Light Apperance** is set to **Filter and Temperature**. |
37
43
|**Intensity**| Set the brightness of the light. The default value for a **Directional** light is 0.5. The default value for a **Point**, **Spot** or **Area** light is 1. |
38
44
|**Indirect Multiplier**| Use this value to vary the intensity of indirect light. Indirect light is light that has bounced from one object to another. The **Indirect Multiplier** defines the brightness of bounced light calculated by the global illumination (GI) system. If you set **Indirect Multiplier** to a value lower than **1,** the bounced light becomes dimmer with every bounce. A value higher than **1** makes light brighter with each bounce. This is useful, for example, when a dark surface in shadow (such as the interior of a cave) needs to be brighter in order to make detail visible. |
39
45
|**Range**| Define how far the light emitted from the center of the object travels (**Point** and **Spot** lights only). |
40
46
|**Cookie**| The RGB texture this Light projects into the scene. Use cookies to create silhouettes or patterned illumination. The texture format to use depends on the type of Light:<br/> • Directional: 2D texture<br/> • Spot: 2D texture<br/> • Point: [cubemap texture](https://docs.unity3d.com/Manual/class-Cubemap.html)<br/><br/>**Note**: URP doesn't support light cookies for Area lights.<br/><br/>For more information about light cookies, refer to [Cookies](https://docs.unity3d.com/Manual/Cookies.html). |
41
-
| **Cookie Size**| The per-axis scale Unity applies to the cookie texture. Use this property to set the size of the cookie.<br/><br/>This property is available only if you set **Type** to **Directional** and assign a texture to **Cookie**. |
42
-
| **Cookie Offset**| The per-axis offset Unity applies to the cookie texture. Use this property to move the cookie without moving the light itself. You can also animate this property to scroll the cookie. <br/><br/>This property is available only if you set **Type** to **Directional** and assign a texture to **Cookie**. |
47
+
| **Cookie Size**| The per-axis scale Unity applies to the cookie texture. Use this property to set the size of the cookie.<br/><br/>**Note**: This property is available only if you set **Type** to **Directional** and assign a texture to **Cookie**. |
48
+
| **Cookie Offset**| The per-axis offset Unity applies to the cookie texture. Use this property to move the cookie without moving the light itself. You can also animate this property to scroll the cookie. <br/><br/>**Note**: This property is available only if you set **Type** to **Directional** and assign a texture to **Cookie**. |
43
49
44
50
## <aname="Rendering"></a>Rendering
45
51
@@ -56,15 +62,17 @@ The Light Inspector includes the following groups of properties:
56
62
| Property:| Function: |
57
63
|:---|:---|
58
64
|**Shadow Type**| Determine whether this Light casts Hard Shadows, Soft Shadows, or no shadows at all. For information on hard and soft shadows, refer to documentation on [Lights](https://docs.unity3d.com/Manual/class-Light.html). |
59
-
| Baked Shadow Angle| If **Type** is set to **Directional** and **Shadow Type** is set to **Soft Shadows**, this property adds some artificial softening to the edges of shadows and gives them a more natural look. |
60
-
| Baked Shadow Radius| If **Type** is set to **Point** or **Spot** and **Shadow Type** is set to **Soft Shadows**, this property adds some artificial softening to the edges of shadows and gives them a more natural look. |
65
+
| **Baked Shadow Angle**| If **Type** is set to **Directional** and **Shadow Type** is set to **Soft Shadows**, this property adds some artificial softening to the edges of shadows and gives them a more natural look.<br/><br/>**Note**: This property is only available if **Mode** is set to **Mixed** or **Baked**. |
66
+
| **Baked Shadow Radius**| If **Type** is set to **Point** or **Spot** and **Shadow Type** is set to **Soft Shadows**, this property adds some artificial softening to the edges of shadows and gives them a more natural look.<br/><br/>**Note**: This property is only available if **Mode** is set to **Mixed** or **Baked**. |
61
67
| Realtime Shadows| These properties are available when **Shadow Type** is set to **Hard Shadows** or **Soft Shadows**. Use these properties to control real-time shadow rendering settings. |
62
-
| Strength| Use the slider to control how dark the shadows cast by this Light are, represented by a value between 0 and 1. This is set to 1 by default. |
63
-
| Bias| Controls whether to use shadow bias settings from the URP Asset, or whether to define custom shadow bias settings for this Light. Possible values are **Use Pipeline Settings** or **Custom**.|
64
-
| Depth| Controls the distance at which the shadows will be pushed away from the light. Useful for avoiding false self-shadowing artifacts. This property is visible only when **Bias** is set to **Custom**.|
65
-
| Normal| Controls the distance at which the shadow casting surfaces will be shrunk along the surface normal. Useful for avoiding false self-shadowing artifacts. This property is visible only when **Bias** is set to **Custom**.|
66
-
| Near Plane| Use the slider to control the value for the near clip plane when rendering shadows, defined as a value between 0.1 and 10. This value is clamped to 0.1 units or 1% of the light’s **Range** property, whichever is lower. This is set to 0.2 by default. |
67
-
| Soft Shadows Quality | Select the soft shadows quality. With the **Use Pipeline Settings** option selected Unity uses the value from the URP Asset. Options **Low**, **Medium**, and **High** let you specify the soft shadow quality value for this Light. For more information on the values, refer to the [Soft Shadows](universalrp-asset.md#soft-shadows) section. |
68
+
| **Strength**| Use the slider to control how dark the shadows cast by this Light are, represented by a value between 0 and 1. This is set to 1 by default. |
69
+
| **Bias**| Controls whether to use shadow bias settings from the URP Asset, or whether to define custom shadow bias settings for this Light. Possible values are **Use Pipeline Settings** or **Custom**.|
70
+
| **Depth**| Controls the distance at which the shadows will be pushed away from the light. Useful for avoiding false self-shadowing artifacts. This property is visible only when **Bias** is set to **Custom**.|
71
+
| **Normal**| Controls the distance at which the shadow casting surfaces will be shrunk along the surface normal. Useful for avoiding false self-shadowing artifacts. This property is visible only when **Bias** is set to **Custom**.|
72
+
| **Near Plane**| Use the slider to control the value for the near clip plane when rendering shadows, defined as a value between 0.1 and 10. This value is clamped to 0.1 units or 1% of the light’s **Range** property, whichever is lower. This is set to 0.2 by default. |
73
+
| **Soft** **Shadows** **Quality**| Select the soft shadows quality. With the **Use Pipeline Settings** option selected Unity uses the value from the URP Asset. Options **Low**, **Medium**, and **High** let you specify the soft shadow quality value for this Light. For more information on the values, refer to the [Soft Shadows](universalrp-asset.md#soft-shadows) section. |
74
+
| **Custom Shadow Layers**| Enable to specify the layer for shadows from the light separately to the layer for the light itself.<br/><br/>**Note**: This property is only available if **Mode** is set to **Mixed** or **Baked**, and **Shadow Type** is set to **Hard Shadows** or **Soft Shadows**. |
75
+
| **Layer**| The layer for shadows from the light. |
Copy file name to clipboardExpand all lines: Packages/com.unity.render-pipelines.universal/Documentation~/lighting.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,17 +2,17 @@
2
2
3
3
Using the Universal Render Pipeline (URP), you can achieve realistic lighting that is suitable for a range of art styles.
4
4
5
-
All of Unity's render pipelines share common lighting functionality, but each render pipeline has some important differences.
6
-
7
-
Areas where the Universal Render Pipeline (URP) differs from Unity's common lighting functionality are:
8
-
9
-
*The [Light component inspector](light-component.md), which displays some URP-specific controls.
10
-
* The [Universal Additional Light Data](universal-additional-light-data.md)component, which allows Unity to store Light-related data that is specific to URP.
11
-
* Enlighten Realtime Global Illumination is supported in URP from version 12. For more information, refer to [Realtime Global Illumination using Enlighten](https://docs.unity3d.com/Manual/realtime-gi-using-enlighten.html).
12
-
13
-
For a full comparison of lighting features between Unity's Built-in Render Pipeline and URP, and an up to date list of lighting features that are currently under research, check the [feature comparison chart](universalrp-builtin-feature-comparison.md).
14
-
15
-
For a general introduction to lighting in Unity and examples of common lighting workflows, refer to the [Lighting section of the Unity Manual](https://docs.unity3d.com/Manual/LightingOverview.html).
5
+
| Page | Description |
6
+
|-|-|
7
+
|[Lighting in URP](lighting/lighting-in-urp.md)| Understand the differences between Unity's common lighting functionality and the lighting functionality in URP.|
8
+
|[Light component reference](light-component.md)| Understand how each lighting property works in URP. |
9
+
|[The Universal Additional Light Data component](universal-additional-light-data.md)| Use the Universal Additional Light Data component to override lighting settings in URP. |
10
+
|[Lighting Mode](urp-lighting-mode.md)| Understand which lighting modes URP supports. |
11
+
|[Shadows in the URP](Shadows-in-URP.md)| How to work with shadows in URP. |
12
+
|[Reflection Probes](lighting/reflection-probes.md)| Configure the URP-specific behavior of Reflection Probes. |
13
+
|[View and control a light from its perspective](lights-placement-tool.md)| Use the Light Placement Tool to view a Scene from a light source's perspective. |
14
+
|[Adaptive Probe Volumes (APV)](probevolumes.md)| Understand how to use Adaptive Probe Volumes in URP. |
15
+
|[Lens flares](shared/lens-flare/lens-flare.md)| Understand how to use lens flares in URP. |
All of Unity's render pipelines share common lighting functionality, but each render pipeline has some important differences.
4
+
5
+
Areas where the Universal Render Pipeline (URP) differs from Unity's common lighting functionality are:
6
+
7
+
* The [Light component inspector](light-component.md), which displays some URP-specific controls.
8
+
* The [Universal Additional Light Data](universal-additional-light-data.md) component, which allows Unity to store Light-related data that is specific to URP.
9
+
10
+
For a full comparison of lighting features between Unity's Built-in Render Pipeline and URP, and an up to date list of lighting features that are currently under research, check the [Render pipeline feature comparison](https://docs.unity3d.com/Manual/render-pipelines-feature-comparison.html).
11
+
12
+
For a general introduction to lighting in Unity and examples of common lighting workflows, refer to the [Lighting section of the Unity Manual](https://docs.unity3d.com/Manual/LightingOverview.html).
0 commit comments