26 KiB
26 KiB
| uid |
|---|
| urp-universalrp-asset |
Universal Render Pipeline Asset
Any Unity project that uses the Universal Render Pipeline (URP) must have a URP Asset to configure the settings. When you create a project using the URP template, Unity creates the URP Assets in the Settings project folder and assigns them in Project Settings. If you are migrating an existing project to URP, you need to create a URP Asset and assign the asset in the Graphics settings.
The URP Asset controls several graphical features and quality settings for the Universal Render Pipeline. It is a scriptable object that inherits from ‘RenderPipelineAsset’. When you assign the asset in the Graphics settings, Unity switches from the built-in render pipeline to the URP. You can then adjust the corresponding settings directly in the URP, instead of looking for them elsewhere.
You can have multiple URP assets and switch between them. For example, you can have one with Shadows on and one with Shadows off. If you switch between the assets to understand the effects, you don’t have to manually toggle the corresponding settings for shadows every time. You cannot, however, switch between HDRP/SRP and URP assets, as the render pipelines are incompatible.
UI overview
In the URP, you can configure settings for:
Note
If you have the experimental 2D Renderer enabled (menu: Graphics Settings > add the 2D Renderer Asset under Scriptable Render Pipeline Settings), some of the options related to 3D rendering in the URP Asset don't have any impact on your final app or game.
Show advanced properties
Unity does not show certain advanced properties in the URP Asset by default. To show all available properties in a section, open the More (⋮) menu and select Advanced Properties.
To show all additional properties in all sections, follow these steps:
- Go to Edit > Preferences.
- In the Graphics section, set Advanced Properties to All Visible.
Rendering
The Rendering settings control the core part of the pipeline rendered frame.
| Property | Description |
|---|---|
| Depth Texture | Enables URP to create a _CameraDepthTexture. URP then uses this depth texture by default for all Cameras in your scene. You can override this for individual cameras in the Camera Inspector. |
| Opaque Texture | Enable this to create a _CameraOpaqueTexture as default for all cameras in your scene. This works like the GrabPass in the built-in render pipeline.The Opaque Texture provides a snapshot of the scene right before URP renders any transparent meshes. You can use this in transparent Shaders to create effects like frosted glass, water refraction, or heat waves. You can override this for individual cameras in the Camera Inspector. |
| Opaque Downsampling | Set the sampling mode on the opaque texture to one of the following:
|
| Terrain Holes | If you disable this option, the URP removes all Terrain hole Shader variants when you build for the Unity Player, which decreases build time. |
| GPU Resident Drawer | The GPU Resident Drawer automatically uses the BatchRendererGroup API to draw GameObjects with GPU instancing. For more information, refer to Use the GPU Resident Drawer.Available options:
|
| Small-Mesh Screen-Percentage | Set the screen percentage Unity uses to cull small GameObjects, to speed up rendering. Unity culls GameObjects that fill less of the screen than this value. This setting might not work if you use your own Level of Detail (LOD) meshes. Set the value to 0 to stop Unity culling small GameObjects. To prevent Unity culling an individual GameObject that covers less screen space than this value, go to the Inspector window for the GameObject and add a Disallow Small Mesh Culling component. |
| GPU Occlusion Culling | Enable Unity to use the GPU instead of the CPU to exclude GameObjects from rendering when they're hidden behind other GameObjects. Refer to Use GPU occlusion culling for more information. |
| SRP Batcher | Enable the SRP Batcher. This is useful if you have many different Materials that use the same Shader. The SRP Batcher is an inner loop that speeds up CPU rendering without affecting GPU performance. When you use the SRP Batcher, it replaces the SRP rendering code inner loop. If both SRP Batcher and Dynamic Batching are enabled, SRP Batcher will take precedence over dynamic batching as long as the shader is SRP Batcher compatible. Note: If assets or shaders in a project are not optimized for use with the SRP Batcher, low performance devices might be more performant when you disable the SRP Batcher. |
| Dynamic Batching | Enable Dynamic Batching, to make the render pipeline automatically batch small dynamic objects that share the same Material. This is useful for platforms and graphics APIs that do not support GPU instancing. If your targeted hardware does support GPU instancing, disable Dynamic Batching. You can change this at run time. |
| Debug Level | Set the level of debug information that the render pipeline generates. Available options:
|
| Shader Variant Log Level | Set the level of information about Shader Stripping and Shader Variants you want to display when Unity finishes a build. Available options:
You can check the information in Console panel when your build has finished. |
| Store Actions | Defines if Unity discards or stores the render targets of the DrawObjects Passes. Available options:
|
Quality
These settings control the quality level of the URP. This is where you can make performance better on lower-end hardware or make graphics look better on higher-end hardware.
Tip: If you want to have different settings for different hardware, you can configure these settings across multiple Universal Render Pipeline assets, and switch them out as needed.
| Property | Description |
|---|---|
| HDR | Enable this to allow rendering in High Dynamic Range (HDR) by default for every camera in your scene. With HDR, the brightest part of the image can be greater than 1. This gives you a wider range of light intensities, so your lighting looks more realistic, such as being able to pick out details and experience less saturation even with bright light. This is useful if you want a wide range of lighting or to use bloom effects. If you’re targeting lower-end hardware, you can disable this to skip HDR calculations and get better performance. You can override this for individual cameras in the Camera Inspector. |
| HDR Precision | The precision of the Camera color buffer in HDR rendering. The 64 bit precision lets you avoid banding artifacts, but requires higher bandwidth and might make sampling slower. Default value: 32 bit. |
| Anti Aliasing (MSAA) | Use Multisample Anti-aliasing by default for every Camera in your scene while rendering. This softens edges of your geometry, so they’re not jagged or flickering. In the drop-down menu, select how many samples to use per pixel: 2x, 4x, or 8x. The more samples you choose, the smoother your object edges are. If you want to skip MSAA calculations, or you don’t need them in a 2D game, select Disabled. You can override this for individual cameras in the Camera Inspector. Note: On mobile platforms that do not support the StoreAndResolve store action, if Opaque Texture is selected in the URP asset, Unity ignores the Anti Aliasing (MSAA) property at runtime (as if Anti Aliasing (MSAA) is set to Disabled). |
| Render Scale | This slider scales the render target resolution (not the resolution of your current device). Use this when you want to render at a smaller resolution for performance reasons or to upscale rendering to improve quality. Note: This only scales the game rendering. UI rendering is left at the native resolution for the device. |
| Upscaling Filter | Select which image filter Unity uses when performing the upscaling. Unity performs upscaling when the Render Scale value is less than 1.0. |
| Automatic | Unity selects one of the filtering options based on the Render Scale value and the current screen resolution. If integer scaling is possible, Unity selects the Nearest-Neighbor option, otherwise Unity selects the Bilinear option. |
| Bilinear | Unity uses the bilinear or linear filtering provided by the graphics API. |
| Nearest-Neighbor | Unity uses the nearest-neighbor or point sampling filtering provided by the graphics API. |
| FidelityFX Super Resolution 1.0 | Unity uses the AMD FidelityFX Super Resolution 1.0 (FSR) technique to perform upscaling. Unlike most other Upscaling Filter options, this filter remains active even at a Render Scale value of 1.0. This filter can still improve image quality even when no scaling is occurring. This also makes the transition between scale values 0.99 and 1.0 less noticeable in cases where dynamic resolution scaling is active. Note: This filter is only supported on devices that support Unity shader model 4.5 or higher. On devices that do not support Unity shader model 4.5, Unity uses the Automatic option instead. |
| Override FSR Sharpness | Unity shows this check box when you select the FSR filter. Selecting this check box lets you specify the intensity of the FSR sharpening pass. |
| FSR Sharpness | Specify the intensity of the FSR sharpening pass. A value of 0.0 provides no sharpening, a value of 1.0 provides maximum sharpness. Note: This option has no effect when FSR is not the active upscaling filter. |
| Spatial-Temporal Post-Processing (STP) 1.0 | Unity uses the Spatial Temporal Post-Processing (STP) technique to perform upscaling. This filter performs temporal anti-aliasing (TAA) as part of the upscaling process, so selecting this option overrides the camera's anti-aliasing setting to TAA. This filter improves image quality even without scaling, so it remains active at the render scale value of 1.0 |
| like FSR. For more information on STP, refer to Spatial-Temporal Post-processing Note: This filter is only supported on non-GLES devices that support compute shaders. On devices that do not support STP's requirements, Unity uses the Automatic option instead. |
|
| LOD Cross Fade | Use this property to enable or disable the LOD cross-fade. If you disable this option, URP removes all LOD cross-fade shader variants when you build the Unity Player, which decreases the build time. |
| LOD Cross Fade Dithering Type | When an LOD group has Fade Mode set to Cross Fade, Unity renders the Renderer's LOD meshes with cross-fade blending between them using alpha testing. This property defines the type of LOD cross-fade. Available options:
|
Lighting
These settings affect the lights in your scene.
If you disable some of these settings, the relevant keywords are stripped from the Shader variables. If there are settings that you know for certain you won’t use in your game or app, you can disable them to improve performance and reduce build time.
| Property | Description |
|---|---|
| Main Light | These settings affect the main Directional Light in your scene. You can select this by assigning it as a Sun Source in the Lighting Inspector. If you don’t assign a sun source, the URP treats the brightest directional light in the scene as the main light. You can choose between Pixel Lighting and None. If you choose None, URP doesn’t render a main light, even if you’ve set a sun source. |
| Cast Shadows | Check this box to make the main light cast shadows in your scene. |
| Shadow Resolution | This controls how large the shadow map texture for the main light is. High resolutions give sharper, more detailed shadows. If memory or rendering time is an issue, try a lower resolution. |
| Light Probe System | Select the light probe system this URP Asset uses. Available options:
|
| Memory Budget | Limits the width and height of the textures that store baked Global Illumination data, which determines the amount of memory Unity sets aside to store baked Adaptive Probe Volume data. These textures have a fixed depth. Available options:
|
| SH Bands | Determines the spherical harmonics (SH) bands Unity uses to store probe data. L2 provides more precise results, but uses more system resources. Available options:
|
| Enable Streaming | Enable to stream Adaptive Probe Volume data from CPU memory to GPU memory at runtime. Refer to Streaming Adaptive Probe Volumes for more information. |
| Estimated GPU Memory Cost | Indicates the amount of texture data used by Adaptive Probe Volumes in your project. |
| Additional Lights | Here, you can choose to have additional lights to supplement your main light. Choose between Per Vertex, Per Pixel, or Disabled. |
| Per Object Limit | This slider sets the limit for how many additional lights can affect each GameObject. |
| Cast Shadows | Check this box to make the additional lights cast shadows in your scene. |
| Shadow Atlas Resolution | This controls the size of the textures that cast directional shadows for the additional lights. This is a sprite atlas that packs up to 16 shadow maps. High resolutions give sharper, more detailed shadows. If memory or rendering time is an issue, try a lower resolution. |
| Shadow Resolution Tiers | Set the resolution of the shadows cast by additional lights at various tiers. Resolutions must have a value of 128 or greater, and are rounded to the next power of two. Note: This property is only visible when the Cast Shadows property is enabled for Additional Lights. |
| Cookie Atlas Resolution | The size of the cookie atlas the additional lights use. All additional lights are packed into a single cookie atlas. This property is only visible when the Light Cookies property is enabled. |
| Cookie Atlas Format | The format of the cookie atlas for additional lights. All additional lights are packed into a single cookie atlas. Available options:
|
| Reflection Probes | Use these properties to control reflection probe settings. |
| Probe Blending | Smooth the transitions between Reflection Probes. For more information, refer to Reflection Probe Blending. |
| Box Projection | Create reflections on objects based on their position within the probe's box, while still using a single probe as the reflection source. For more information, refer to Advanced Reflection Probe features. |
| Mixed Lighting | Enable Mixed Lighting to configure the pipeline to include mixed lighting shader variants in the build. |
| Use Rendering Layers | With this option selected, you can configure certain Lights to affect only specific GameObjects. For more information on Rendering Layers and how to use them, refer to the documentation on Rendering Layers. |
| Light Cookies | Enables light cookies. This property enables Cookie Atlas Resolution and Cookie Atlas Format for additional lights. |
| SH Evaluation Mode | Defines the spherical harmonic (SH) lighting evaluation type. Available options:
|
Shadows
These settings let you configure how shadows look and behave, and find a good balance between the visual quality and performance.
The Shadows section has the following properties.
| Property | Description |
|---|---|
| Max Distance | The maximum distance from the Camera at which Unity renders the shadows. Unity does not render shadows farther than this distance. Note: This property is in metric units regardless of the value in the Working Unit property. |
| Working Unit | The unit in which Unity measures the shadow cascade distances. |
| Cascade Count | The number of shadow cascades. With shadow cascades, you can avoid crude shadows close to the Camera and keep the Shadow Resolution reasonably low. For more information, refer to the documentation on Shadow Cascades. Increasing the number of cascades reduces the performance. Cascade settings only affects the main light. |
| Split 1 | The distance where cascade 1 ends and cascade 2 starts. |
| Split 2 | The distance where cascade 2 ends and cascade 3 starts. |
| Split 3 | The distance where cascade 3 ends and cascade 4 starts. |
| Last Border | The size of the area where Unity fades out the shadows. Unity starts fading out shadows at the distance Max Distance - Last Border, at Max Distance the shadows fade to zero. |
| Depth Bias | Use this setting to reduce shadow acne. |
| Normal Bias | Use this setting to reduce shadow acne. |
| Soft Shadows | Select this check box to enable extra processing of the shadow maps to give them a smoother look. Performance impact: High. When this option is disabled, Unity samples the shadow map once with the default hardware filtering. |
| Quality | Select the quality level of soft shadow processing. Available options:
|
| Conservative Enclosing Sphere | Enable this option to improve shadow frustum culling and prevent Unity from excessively culling shadows in the corners of the shadow cascades. Disable this option only for compatibility purposes of existing projects created in previous Unity versions. If you enable this option in an existing project, you might need to adjust the shadows cascade distances because the shadow culling enclosing spheres change their size and position. Performance impact: Enabling this option is likely to improve performance, because the option minimizes the overlap of shadow cascades, which reduces the number of redundant static shadow casters. |
Post-processing
This section allows you to fine-tune global post-processing settings.
| Property | Description |
|---|---|
| Grading Mode | Select the color grading mode to use for the Project.
|
| LUT Size | Set the size of the internal and external look-up textures (LUTs) that the Universal Render Pipeline uses for color grading. Higher sizes provide more precision, but have a potential cost of performance and memory use. You cannot mix and match LUT sizes, so decide on a size before you start the color grading process. The default value, 32, provides a good balance of speed and quality. |
| Fast sRGB/Linear Conversions | Select this option to use faster, but less accurate approximation functions when converting between the sRGB and Linear color spaces. |
| Data Driven Lens Flare | Allocate the shader variants and memory URP needs for lens flares effect. |
| Screen Space Lens Flare | Allocate the shader variants and memory URP needs for screen space lens flares. |
Volumes
| Property | Description |
|---|---|
| Volume Update Mode | Select how Unity updates Volumes at run time.
|
| Volume Profile | Set the Volume Profile that a scene uses by default. Refer to Understand volumes for more information. |
The list of Volume Overrides that the Volume Profile contains appears below Volume Profile. You can add, remove, disable, and enable Volume Overrides, and edit their properties. Refer to Volume Overrides for more information.
Adaptive Performance
This section is available if the Adaptive Performance package is installed in the project. The Use Adaptive Performance property lets you enable the Adaptive Performance functionality.
| Property | Description |
|---|---|
| Use Adaptive Performance | Select this check box to enable the Adaptive Performance functionality, which adjusts the rendering quality at runtime. |