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: com.unity.render-pipelines.high-definition/Documentation~/Upgrading-from-2019.2-to-2019.3.md
+13-15Lines changed: 13 additions & 15 deletions
Original file line number
Diff line number
Diff line change
@@ -4,22 +4,20 @@ In the High Definition Render Pipeline (HDRP), some features work differently be
4
4
5
5
## New Scene
6
6
7
-
New Scene system in HDRP rely on a prefab in your project. It also depend on default settings set for the Volumes. If you already have configured one with the Wizard, you need to update it regarding the **Default Volume Profile Asset** (in **Edit > Project Settings > HDRP Default Settings**).
7
+
The New Scene system in HDRP relies on a Prefab in your project. It also depends on default settings set for the Volumes. If you have already configured one with the Wizard, you need to update it regarding the **Default Volume Profile Asset** (in **Edit > Project Settings > HDRP Default Settings**).
8
8
9
-
If you use default prefab (the one created by the wizard) and rely on default **Default Volume Profile Asset**, then your prefab will not be sync anymore with the default volume profile and you must update it.
9
+
If you use the default Prefab (the one created by the wizard) and rely on the default **Default Volume Profile Asset**, then your Prefab won't be in sync with the default volume profile and you must update it.
10
10
11
-
The easiest way is to ask the Wizard to recreate a new one:
11
+
The easiest way is to recreate a new one using the Wizard:
12
12
13
13
1. Open the Wizard (**Window > Rendering > HDRP Wizard**)
14
-
2. Remove the prefab set in **Default Scene Prefab**.
15
-
3.[*Optional*] Keep a copy of your previous prefab if it have been customized to not lost your version. To do so, just rename the prefab. It will prevent to be overridden.
14
+
2. Remove the Prefab set in **Default Scene Prefab**.
15
+
3.[*Optional*] Keep a copy of your previous Prefab if you have customized it, so you don't lose your version. To do so, rename the Prefab. It will prevent the Prefab being overridden.
16
16
4. Look at the **Configuration Checking** below for the line **Default Scene Prefab** and click on the **Fix** button.
17
-
5.[*Optional*] Report your custom change in the new created prefab.
17
+
5.[*Optional*] Report your custom change in the new created Prefab.
18
18
19
19
Then repeat this for **Default DXR Scene Prefab** if you were also using DXR.
20
20
21
-
New Scene system in HDRP rely on a prefab in your project. If you have already configured one with the Wizard, you need to update it.
22
-
23
21
<aname="ProceduralSky"></a>
24
22
25
23
## Procedural Sky
@@ -33,7 +31,7 @@ To install the Procedural Sky override into a 7.x Project:
33
31
3. In the **Samples** section, click on the **Import in project** button for the **Procedural Sky** entry. If you have a Scene open that uses the Procedural Sky, the sky re-appears, but its settings are reset to the default values.
34
32
4. To recover your sky settings, you must quit Unity without saving and then re-open your Project.
35
33
36
-
The last step is important because, if you haven't installed the sample and load a Scene that uses a Procedural Sky, then the Procedural Sky data in the Volume is lost. Unity does not serialize this so you can close and re-open Unity to recover your settings.
34
+
The last step is important because, if you haven't installed the sample and load a Scene that uses a Procedural Sky, then the Procedural Sky data in the Volume is lost. Unity doesn't serialize this so you can close and re-open Unity to recover your settings.
37
35
38
36
## Sky Intensity Mode
39
37
@@ -60,18 +58,18 @@ Before 7.x, HDRP synchronized the width and height of an area [Light](Light-Comp
60
58
61
59
## Cookie textures (Spot, Area and Directional lights) and Planar Reflection Probes
62
60
63
-
Before 7.x, we stored cookies of Spot, Area and directional lights and planars into texture arrays. Due to the usage of these arrays, we were limited to use the same size for every element in one array. For cookie textures, a convertion code ensured that if a texture size wasn't exatcly the same as the size of the texture array (defined in the HDRP asset), then it was scaled to fit the size of the array.
61
+
Before 7.x, we stored cookies of Spot, Area, and directional lights and planars into texture arrays. Due to the usage of these arrays, we were limited to use the same size for every element in one array. For cookie textures, a convertion code ensured that if a texture size wasn't exatcly the same as the size of the texture array (defined in the HDRP asset), then it was scaled to fit the size of the array.
64
62
Now that we're using an atlas we don't have this limitation anymore. It means that the cookie size you were using might differ now that we use the real size of the texture and could result in more sharp / pixelated cokies if your texture were too big or too small. If you encounter this kind of issue, we recommend fixing the images directly.
65
63
For Planar Reflection Probes it also means that you can use different resolution per probe.
66
64
67
-
You may also encounter this error in the console: `No more space in the 2D Cookie Texture Atlas. To solve this issue, increase the resolution of the cookie atlas in the HDRP settings.` This means that there is no space left in the Cookie atlas because there are too many of them in the view or the cookie textures are too big. To solve this issue you can either lower the resolution of the cookie textures or increase the atlas resolution in the HDRP settings.
65
+
You may also encounter this error in the console: `No more space in the 2D Cookie Texture Atlas. To solve this issue, increase the resolution of the cookie atlas in the HDRP settings.` This means that there is no space left in the Cookie atlas because there are too many of them in the view or the cookie textures are too big. To solve this issue you can either lower the resolution of the cookie textures or increase the atlas resolution by going to **Edit** > **Project Settings** > **Quality** > **HDRP** > **DefaultHDRPAsset** > **Lighting** > **Cookies** > **2D Atlas Size**.
68
66
69
67
## Max Smoothness, Emission Radius, Bake Shadows Radius and Bake Shadows Angle
70
68
71
69
Before 7.x, Max Smoothness, Emission Radius, and Bake Shadows Radius were separate controls for Point and Spot Lights. From 7.x, the UI displays a single property, called **Radius** that controls all of the properties mentioned above.
72
70
Also, Max Smoothness, Angular Diameter, and Bake Shadows Angle were separate controls for Directional Lights. The UI now displays a single property, called **Angular Diameter**, that controls all the mentioned above.
73
71
74
-
When upgrading, a slight shift of highlight shape or shadow penumbra size can occur. This happens if you set the original properties to values that do not match what the automatic conversion from "Radius" or "Angular Diameter" results in.
72
+
When upgrading, a slight shift of highlight shape or shadow penumbra size can occur. This happens if you set the original properties to values that don't match what the automatic conversion from "Radius" or "Angular Diameter" results in.
75
73
76
74
## Realtime GI Enlighten
77
75
@@ -96,7 +94,7 @@ From 7.x, there is no Render Settings shorcut in the context menu to create pre-
96
94
97
95
## HDRP Configuration Package
98
96
99
-
From 7.x, HDRP has an additional small package as a dependency. This is the HDRP-Config package. You can change properties in this package to disable or tweak features that you cannot control dynamically in HDRP’s UI. Currently, this include:
97
+
From 7.x, HDRP has an additional small package as a dependency. This is the HDRP-Config package. You can change properties in this package to disable or tweak features that you can't control dynamically in HDRP’s UI. Currently, this include:
100
98
* Selecting the Shadow Filtering quality when in Deferred Mode.
101
99
* Camera Relative Rendering.
102
100
* Raytracing.
@@ -114,10 +112,10 @@ To do this, Unity opens a prompt when you begin the upgrade, asking if you want
114
112
When you enter Play Mode in a Scene with baked Probes authored prior to 7.x, you may encounter a warning about a missing Script for a GameObject named **SceneIDMap**.
115
113
To fix this, load the Scene in the Unity Editor and select **Edit > Render Pipeline > Fix Warning 'referenced script in (Game Object 'SceneIDMap') is missing' in loaded scenes**.
116
114
117
-
## Light Intensity and Sky Exposure versus HDRP Default Settings.
115
+
## Light Intensity and Sky Exposure versus HDRP Default Settings
118
116
119
117
By default, HDRP uses physically correct intensities for Lights. Because of this, the exposure of the default HDRI sky present in HDRP is set to **11** to match a Directional Light intensity of **10000**. For reference, you can find similar values in the template Project.
120
-
When the HDRP Wizard has been set up correctly, if you create a new Scene, Unity automatically creates GameObjects with the correct intensities so that everything is coherent. However, if the HDRP Wizard is not set up correctly, or if you create Directional Lights from scratch, the intensity is not physically correct. The consequence is that the Light does not match the default sky exposure and thus, any GameObject in the Scene looks black because of the automatic exposure compensating for the overly bright sky.
118
+
When the HDRP Wizard has been set up correctly, if you create a new Scene, Unity automatically creates GameObjects with the correct intensities so that everything is coherent. However, if the HDRP Wizard isn't set up correctly, or if you create Directional Lights from scratch, the intensity isn't physically correct. The consequence is that the Light doesn't match the default sky exposure, so any GameObject in the Scene looks black because of the automatic exposure compensating for the overly bright sky.
121
119
To avoid this, make sure that you use coherent values for light intensity compared to the current sky exposure.
0 commit comments