Changelog

All notable changes to this package will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[7.2.1] - 2020-02-14

Fixed

• Fixed incorrect light attenuation on Nintendo Switch.
• Fixed a performance issue in Hololens when using renderer with custom render passes.

[7.2.0] - 2020-02-10

Added

• Added support for Camera Stacking when using the Forward Renderer. This introduces the Camera Render Type property. A Base Camera can be initialized with either the Skybox or Solid Color, and can combine its output with that of one or more Overlay Cameras. An Overlay Camera is always initialized with the contents of the previous Camera that rendered in the Camera Stack.
• Added XR multipass rendering. Multipass rendering is a requirement on many VR platforms and allows graceful fallback when single-pass rendering isn't available.
• Added support for Post Processing Version 2 (PPv2) as a fallback post-processing solution, in addition to URP's integrated post-processing solution. This enables developers to use PPv2 with Unity 2019 LTS.
• Added Transparency Sort Mode, Transparency Sort Axis, and support for a user defined default material to 2DRendererData.
• Added the option to toggle shadow receiving on transparent objects.
• Added support for particle shaders to receive shadows.
• Added AssetPostprocessors and Shadergraphs to handle Arnold Standard Surface and 3DsMax Physical material import from FBX. Basic PBR material properties like Base Color, Metalness, Roughness, Specular IOR, Emission and Normals are imported and mapped to custom shaders in Unity.

Changed

• Removed final blit pass to force alpha to 1.0 on mobile platforms.
• Blend Styles in the 2DRendererData are now automatically enabled/disabled.
• When using the 2D Renderer, Sprites render with a faster rendering path when no lights are present.
• The Scene view now mirrors the Volume Layer Mask set on the Main Camera.

Fixed

• Fixed an issue when using the 2D Renderer where some types of renderers would not be assigned the correct material.
• Fixed an issue where viewport aspect ratio was wrong when using the Stretch Fill option of the Pixel Perfect Camera. case 1188695
• Fixed an issue where the default TerrainLit Material was outdated, which caused the default Terrain to use per-vertex normals instead of per-pixel normals.
• Fixed shader errors and warnings in the default Universal RP Terrain Shader. case 1185948
• Fixed broken images in package documentation.
• Fixed an issue where post-processing was not applied for custom renderers set to run on the "After Rendering" event case 1196219
• Fixed an issue that caused an extra blit when using custom renderers case 1156741
• Fixed an issue with transparent objects not receiving shadows when using shadow cascades. case 1116936
• Fixed issue where using a ForwardRendererData preset would cause a crash. case 1201052
• Fixed an issue that caused errors if you disabled the VR Module when building a project.
• Fixed an issue with the null check when UniversalRenderPipelineLightEditor.cs tries to access SceneView.lastActiveSceneView.
• Fixed an issue where the 'Depth Texture' drop down was incorrectly disabled in the Camera Inspector.
• Fixed issue where normal maps on terrain appeared to have flipped X-components when compared to the same normal map on a mesh. case 1181518
• Fixed RemoveComponent on Camera contextual menu to not remove Camera while a component depend on it.
• Fixed an issue where right eye is not rendered to. case 1170619
• Fixed issue where TerrainDetailLit.shader fails to compile when XR is enabled.
• Fixed an issue that allowed height-based blending on Terrains with more than 4 materials, which is not supported.
• Fixed an issue where opaque objects were outputting incorrect alpha values case 1168283
• Fixed an issue where the editor would sometimes crash when using additional lights case 1176131
• Fixed an issue that allowed height-based blending on Terrains with more than 4 materials, which is not supported and causes artifacts.
• Fixed an issue where a depth texture was always created when post-processing was enabled, even if no effects made use of it.
• Fixed an issue where the Volume System would not use the Cameras Transform when no Volume Trigger was set.
• Fixed an issue where post processing disappeared when using custom renderers and SMAA or no AA
• Fixed an issue with soft particles having dark blending when intersecting with scene geometry case 1199812
• Fixed an issue with additive particles blending incorrectly case 1215713
• Fixed XR SDK single-pass incorrectly switching to multipass issue. Add query for XR SDK single-pass availability using XR SDK renderpass descriptors.

[7.1.8] - 2020-01-20

Fixed

• Fixed an issue that caused errors if you disabled the VR Module when building a project.

Changed

• On Xbox and PS4 you will also need to download the com.unity.render-pipeline.platform (ps4 or xboxone) package from the appropriate platform developer forum

[7.1.7] - 2019-12-11

Fixed

• Fixed inconsistent lighting between the forward renderer and the deferred renderer that was caused by a missing normalize operation on vertex normals on some SpeedTree shader variants.
• Fixed issue where the Editor would crash when you used a ForwardRendererData preset. case 1201052
• Fixed an issue where Normal Map Textures didn't apply when you added them to newly-created Materials. case 1197217
• Fixed an issue with deleting shader passes in the custom renderer features list case 1201664
• Fixed an issue where particles had dark outlines when blended together case 1199812

[7.1.6] - 2019-11-22

Fixed

• Fixed issue where XR Multiview failed to render when using URP Shader Graph Shaders
• Fixed lazy initialization with last version of ResourceReloader

[7.1.5] - 2019-11-15

Fixed

• Fixed multiple issues where Shader Graph shaders failed to build for XR in the Universal RP.
• Fixed conflicting meta with HDRP

[7.1.4] - 2019-11-13

Fixed

• Terrain Holes fixes
• Fixed post-processing with XR single-pass rendering modes.

[7.1.3] - 2019-11-04

Added

• Added default implementations of OnPreprocessMaterialDescription for FBX, Obj, Sketchup and 3DS file formats.

Changed

• Moved the icon that indicates the type of a Light 2D from the Inspector header to the Light Type field.
• Eliminated some GC allocations from the 2D Renderer.
• Deprecated the CinemachineUniversalPixelPerfect extension. Use the one from Cinemachine v2.4 instead.
• Replaced PlayerSettings.virtualRealitySupported with XRGraphics.tryEnable.

Fixed

• Fixed an issue where linear to sRGB conversion occurred twice on certain Android devices.
• Fixed an issue where Unity rendered fullscreen quads with the pink error shader when you enabled the Stop NaN post-processing pass.
• Fixed an issue where 2D Lighting was broken for Perspective Cameras.
• Fixed an issue where resetting a Freeform 2D Light would throw null reference exceptions. case 1184536
• Fixed an issue where Freeform 2D Lights were not culled correctly when there was a Falloff Offset.
• Fixed an issue where Tilemap palettes were invisible in the Tile Palette window when the 2D Renderer was in use. case 1162550
• Fixed user LUT sampling being done in Linear instead of sRGB.
• Fixed an issue when trying to get the Renderer via API on the first frame case 1189196
• Fixed an issue where deleting an entry from the Renderer List and then undoing that change could cause a null reference. case 1191896
• Fixed an issue where the user would get an error if they removed the Additional Camera Data component. case 1189926
• Fixed an issue that caused shaders containing HDRP string in their path to be stripped from the build.
• Fixed an issue that caused only selected object to render in SceneView when Wireframe drawmode was selected.
• Fixed Renderer Features UI tooltips. case 1191901
• Fixed an issue where the Scene lighting button didn't work when you used the 2D Renderer.
• Fixed a performance regression when you used the 2D Renderer.
• Fixed an issue where the Freeform 2D Light gizmo didn't correctly show the Falloff offset.
• Fixed an issue where the 2D Renderer rendered nothing when you used shadow-casting lights with incompatible Renderer2DData.
• Fixed an issue where Prefab previews were incorrectly lit when you used the 2D Renderer.
• Fixed an issue where the Light didn't update correctly when you deleted a Sprite that a Sprite 2D Light uses.
• Fixed an issue where Cinemachine v2.4 couldn't be used together with Universal RP due to a circular dependency between the two packages.

[7.1.2] - 2019-09-19

Added

• Added support for additional Directional Lights. The amount of additional Directional Lights is limited by the maximum Per-object Lights in the Render Pipeline Asset.

Fixed

• Fixed an issue where there were 2 widgets showing the outer angle of a spot light.
• Fixed an issue where the Shader Graph SceneDepth node didn't work with XR single-pass (double-wide) rendering. See case 1123069.
• Fixed Unlit and BakedLit shader compilations in the meta pass.
• Fixed an issue where the Bokeh Depth of Field shader would fail to compile on PS4.
• Improved overall memory bandwidth usage.
• Added SceneSelection pass for TerrainLit shader.

[7.1.1] - 2019-09-05

Upgrade Guide

• The render pipeline now handles custom renderers differently. You must now set up renderers for the Camera on the Render Pipeline Asset.
• Render Pipeline Assets upgrades automatically and either creates a default forward renderer in your project or links the existing custom one that you've assigned.
• If you have custom renderers assigned to Cameras, you must now add them to the current Render Pipeline Asset. Then you can select which renderer to use on the Camera.

Added

• Added shader function GetMainLightShadowParams. This returns a half4 for the main light that packs shadow strength in x component and shadow soft property in y component.
• Added shader function GetAdditionalLightShadowParams. This returns a half4 for an additional light that packs shadow strength in x component and shadow soft property in y component.
• Added a Debug Level option to the Render Pipeline Asset. With this, you can control the amount of debug information generated by the render pipeline.
• Added ability to set the ScriptableRenderer that the Camera renders with via C# using UniversalAdditionalCameraData.SetRenderer(int index). This maps to the Renderer List on the Render Pipeline Asset.
• Added shadow support for the 2D Renderer.
• Added ShadowCaster2D, and CompositeShadowCaster2D components.
• Added shadow intensity and shadow volume intensity properties to Light2D.
• Added new Gizmos for Lights.
• Added CinemachineUniversalPixelPerfect, a Cinemachine Virtual Camera Extension that solves some compatibility issues between Cinemachine and Pixel Perfect Camera.
• Added an option that disables the depth/stencil buffer for the 2D Renderer.
• Added manipulation handles for the inner cone angle for spot lights.
• Added documentation for the built-in post-processing solution and Volumes framework (and removed incorrect mention of the PPv2 package).

Changed

• Increased visible lights limit for the forward renderer. It now supports 256 visible lights except in mobile platforms. Mobile platforms support 32 visible lights.
• Increased per-object lights limit for the forward renderer. It now supports 8 per-object lights in all platforms except GLES2. GLES2 supports 4 per-object lights.
• The Sprite-Lit-Default shader and the Sprite Lit Shader Graph shaders now use the vertex tangents for tangent space calculations.
• Temporary render textures for cameras rendering to render textures now use the same format and multisampling configuration as camera's target texture.
• All platforms now use R11G11B10_UFloat format for HDR render textures if supported.
• There is now a list of ScriptableRendererData on the Render Pipeline Asset as opposed to a renderer type. These are available to all Cameras and are included in builds.
• The renderer override on the Camera is now an enum that maps to the list of ScriptableRendererData on the Render Pipeline Asset.
• Pixel Perfect Camera now allows rendering to a render texture.
• Light2D GameObjects that you've created now have a default position with z equal to 0.
• Documentation: Changed the "Getting Started" section into "Install and Configure". Re-arranged the Table of Content.

Fixed

• Fixed LightProbe occlusion contribution. case 1146667
• Fixed an issue that caused a log message to be printed in the console when creating a new Material. case 1173160
• Fixed an issue where OnRenderObjectCallback was never invoked. case 1122420
• Fixed an issue where Sprite Masks didn't function properly when using the 2D Renderer. case 1163474
• Fixed memory leaks when using the Frame Debugger with the 2D Renderer.
• Fixed an issue where materials using _Time did not animate in the scene. 1175396
• Fixed an issue where the Particle Lit shader had artifacts when both soft particles and HDR were enabled. 1136285
• Fixed an issue where the Area Lights were set to Realtime, which caused them to not bake. 1159838
• Fixed an issue where the Disc Light did not generate any light. 1175097
• Fixed an issue where the alpha was killed when an opaque texture was requested on an offscreen camera with HDR enabled case 1163320.
• Fixed an issue that caused Orthographic camera with far plane set to 0 to span Unity console with errors. case 1172269
• Fixed an issue causing heap allocation in RenderPipelineManager.DoRenderLoop case 1156241
• Fixed an issue that caused shadow artifacts when using large spot angle values case 1136165
• Fixed an issue that caused self-shadowing artifacts when adjusting shadow near-plane on spot lights.
• Fixed an issue that caused specular highlights to disappear when the smoothness value was set to 1.0. case 1161827
• Fixed an issue in the Material upgrader that caused transparent Materials to not upgrade correctly to Universal RP. case 1170419.
• Fixed post-processing for the 2D Renderer.
• Fixed an issue in Light2D that caused a black line to appear for a 360 degree spotlight.
• Fixed a post-processing rendering issue with non-fullscreen viewport. case 1177660
• Fixed an issue where Undo would not undo the creation of Additional Camera Data. case 1158861
• Fixed an issue where selecting the same drop-down menu item twice would trigger a change event. case 1158861
• Fixed an issue where selecting certain objects that use instancing materials would throw console warnings. case 1127324
• Fixed a GUID conflict with LWRP. case 1179895
• Fixed an issue where the Terrain shader generated NaNs.
• Fixed an issue that caused the Opaque Color pass to never render at half or quarter resolution.
• Fixed and issue where stencil state on a ForwardRendererData was reset each time rendering happened.
• Fixed an issue where the URP Material Upgrader tried to upgrade standard Universal Shaders. case 1144710
• Fixed an issue where some Materials threw errors when you upgraded them to Universal Shaders. case 1200938

[7.0.1] - 2019-07-25

Changed

• Platform checks now provide more helpful feedback about supported features in the Inspectors.

Fixed

• Fixed specular lighting related artifacts on Mobile case 1143049 and case 1164822.
• Post-processing is no longer enabled in the previews.
• Unity no longer force-enables post-processing on a camera by default.
• Fixed an issue that caused the Scene to render darker in GLES3 and linear color space. case 1169789

[7.0.0] - 2019-07-17

Universal Render Pipeline

• LWRP has been renamed to the "Universal Render Pipeline" (UniversalRP).
• UniversalRP is the same as LWRP in terms of features and scope.
• Classes have moved to the Universal namespace (from LWRP).

Upgrade Guide

• Upgrading to UniversalRP is designed to be almost seamless from the user side.
• LWRP package still exists, this forwards includes and classes to the UniversalRP Package.
• Please see the more involved upgrade guide (https://docs.google.com/document/d/1Xd5bZa8pYZRHri-EnNkyhwrWEzSa15vtnpcg--xUCIs/).

Added

• Initial Stadia platform support.
• Added a menu option to create a new ScriptableRendererFeature script. To do so in the Editor, click on Asset > Create > Rendering > Lightweight Render Pipeline > Renderer Feature.
• Added documentation for SpeedTree Shaders in LWRP.
• Added extended features to LWRP Terrain Shader, so terrain assets can be forward-compatible with HDRP.
• Enabled per-layer advanced or legacy-mode blending in LWRP Terrain Shader.
• Added the documentation page "Rendering in LWRP", which describes the forward rendering camera loop.
• Added documentation overview for how Post Processing Version 2 works in LWRP.
• Added documentation notes and FAQ entry on the 2D Renderer affecting the LWRP Asset.

Changed

• Replaced beginCameraRendering callbacks by non obsolete implementation in Light2D
• Updated ScriptableRendererFeature and ScriptableRenderPass API docs.
• Shader type Real translates to FP16 precision on Nintendo Switch.

Fixed

• Fixed a case where built-in Shader time values could be out of sync with actual time. case 1142495
• Fixed an issue that caused forward renderer resources to not load properly when you upgraded LWRP from an older version to 7.0.0. case 1154925
• Fixed GC spikes caused by LWRP allocating heap memory every frame.
• Fixed distortion effect on particle unlit shader.
• Fixed NullReference exception caused when trying to add a ScriptableRendererFeature.
• Fixed issue with certain LWRP shaders not showing when using forward/2D renderer.
• Fixed the shadow resolve pass and the final pass, so they're not consuming unnecessary bandwidth. case 1152439
• Added missing page for 2D Lights in LWRP.
• Tilemap tiles no longer appear black when you use the 2D renderer.
• Sprites in the preview window are no longer lit by 2D Scene lighting.
• Fixed warnings for unsupported shadow map formats for GLES2 API.
• Disabled shadows for devices that do not support shadow maps or depth textures.
• Fixed support for LWRP per-pixel terrain. case 1110520
• Fixed some basic UI/usability issues with LWRP terrain Materials (use of warnings and modal value changes).
• Fixed an issue where using LWRP and Sprite Shape together would produce meta file conflicts.
• Fixed fp16 overflow in Switch in specular calculation
• Fixed shader compilation errors for Android XR projects.
• Updated the pipeline Asset UI to cap the render scale at 2x so that it matches the render pipeline implementation limit.

[6.7.0] - 2019-05-16

Added

• Added SpeedTree Shaders.
• Added two Shader Graph master nodes: Lit Sprite and Unlit Sprite. They only work with the 2D renderer.
• Added documentation for the 2D renderer.

Changed

• The 2D renderer and Light2D component received a number of improvements and are now ready to try as experimental features.
• Updated the Feature Comparison Table to reflect the current state of LWRP features.

Fixed

• When in playmode, the error 'Non matching Profiler.EndSample' no longer appears. case 1140750
• LWRP Particle Shaders now correctly render in stereo rendering modes. case 1106699
• Shaders with 'debug' in the name are no longer stripped automatically. case 1112983
• Fixed tiling issue with selection outline and baked cutout shadows.
• in the Shadergraph Unlit Master node, Premultiply no longer acts the same as Alpha. case 1114708
• Fixed an issue where Lightprobe data was missing if it was needed per-pixel and GPU instancing was enabled.
• The Soft ScreenSpaceShadows Shader variant no longer gets stripped form builds. case 1138236
• Fixed a typo in the Particle Unlit Shader, so Soft Particles now work correctly.
• Fixed emissive Materials not being baked for some meshes. case 1145297
• Camera matrices are now correctly set up when you call rendering functions in EndCameraRendering. case 1146586
• Fixed GI not baking correctly while in gamma color space.
• Fixed a NullReference exception when adding a renderer feature that is contained in a global namespace. case 1147068
• Shaders are now set up for VR stereo instancing on Vulkan. case 1142952.
• VR stereo matrices and vertex inputs are now set up on Vulkan. case 1142952.
• Fixed the Material Upgrader so it's now run upon updating the LWRP package. 1148764
• Fixed a NullReference exception when you create a new Lightweight Render Pipeline Asset. case 1153388

[6.6.0] - 2019-04-01

Added

• Added support for Baked Indirect mixed lighting.
• You can now use Light Probes for occlusion. This means that baked lights can now occlude dynamic objects.
• Added RenderObjects. You can add RenderObjects to a Renderer to perform custom rendering.
• (WIP) Added an experimental 2D renderer that implements a 2D lighting system.
• (WIP) Added a Light2D component that works with the 2D renderer to add lighting effects to 2D sprites.

Fixed

• Fixed a project import issue in the LWRP template.
• Fixed the warnings that appear when you create new Unlit Shader Graphs using the Lightweight Render Pipeline.
• Fixed light attenuation precision on mobile platforms.
• Fixed split-screen rendering on mobile platforms.
• Fixed rendering when using an off-screen camera that renders to a depth texture.
• Fixed the exposed stencil render state in the renderer.
• Fixed the default layer mask so it's now applied to a depth pre-pass.
• Made several improvements and fixes to the render pass UI.
• Fixed artifacts that appeared due to precision errors in large scaled objects.
• Fixed an XR rendering issue where Unity required a depth texture.
• Fixed an issue that caused transparent objects to sort incorrectly.

[6.5.0] - 2019-03-07

Added

• You can now create a custom forward renderer by clicking on Assets/Create/Rendering/Lightweight Render Pipeline/Forward Renderer. This creates an Asset in your Project. You can add additional features to it and drag-n-drop the renderer to either the pipeline Asset or to a camera.
• You can now add ScriptableRendererFeature to the ScriptableRenderer to extend it with custom effects. A feature is an ScriptableObject that can be drag-n-dropped in the renderer and adds one or more ScriptableRenderPass to the renderer.
• ScriptableRenderer now exposes interface to configure lights. To do so, implement SetupLights when you create a new renderer.
• ScriptableRenderer now exposes interface to configure culling. To do so, implement SetupCullingParameters when you create a new renderer.
• ScriptableRendererData contains rendering resources for ScriptableRenderer. A renderer can be overridden globally for all cameras or on a per-camera basis.
• ScriptableRenderPass now has a RenderPassEvents. This controls where in the pipeline the render pass is added.
• ScriptableRenderPass now exposes ConfigureTarget and ConfigureClear. This allows the renderer to automatically figure out the currently active rendering targets.
• ScriptableRenderPass now exposes Blit. This performs a blit and sets the active render target in the renderer.
• ScriptableRenderPass now exposes RenderPostProcessing. This renders post-processing and sets the active render target in the renderer.
• ScriptableRenderPass now exposes CreateDrawingSettings as a helper for render passes that need to call ScriptableRenderContext.DrawRenderers.

Changed

• Removed RegisterShaderPassName from ScriptableRenderPass. Instead, CreateDrawingSettings now takes one or a list of ShaderTagId.
• Removed remaining experimental namespace from LWRP. All APIrelated to ScriptableRenderer, ScriptableRenderPass, and render pass injection is now out of preview.
• Removed SetRenderTarget from ScriptableRenderPass. You should never call it. Instead, call ConfigureTarget, and the renderer automatically sets up targets for you.
• Removed RenderFullscreenQuad from ScriptableRenderer. Use CommandBuffer.DrawMesh and RenderingUtils.fullscreenMesh instead.
• Removed RenderPostProcess from ScriptableRenderer. Use ScriptableRenderPass.RenderPostProcessing instead.
• Removed postProcessingContext property from ScriptableRenderer. This is now exposed in RenderingUtils.postProcessingContext.
• Removed GetCameraClearFlag from ScriptableRenderer.

Fixed

• Fixed y-flip in VR when post-processing is active.
• Fixed occlusion mesh for VR not rendering before rendering opaques.
• Enabling or disabling SRP Batcher in runtime works now.
• Fixed video player recorder when post-processing is enabled.

[6.4.0] - 2019-02-21

[6.3.0] - 2019-02-18

[6.2.0] - 2019-02-15

Changed

• Code refactor: all macros with ARGS have been swapped with macros with PARAM. This is because the ARGS macros were incorrectly named.

[6.1.0] - 2019-02-13

[6.0.0] - 2019-02-23

Added

• You can now implement a custom renderer for LWRP. To do so, implement an IRendererData that contains all resources used in rendering. Then create an IRendererSetup that creates and queues ScriptableRenderPass. Change the renderer type either in the Pipeline Asset or in the Camera Inspector.
• LWRP now uses the Unity recorder extension. You can use this to capture the output of Cameras.
• You can now inject a custom render pass before LWRP renders opaque objects. To do so, implement an IBeforeRender interface.
• Distortion support in all Particle Shaders.
• An upgrade system for LWRP Materials with MaterialPostprocessor.
• An upgrade path for Unlit shaders
• Tooltips for Shaders.
• SRP Batcher support for Particle Shaders.
• Docs for these Shaders: Baked Lit, Particles Lit, Particles Simple Lit, and Particles Unlit.
• LWRP now supports dynamic resolution scaling. The target platform must also support it.
• LWRP now includes version defines for both C# and Shaders in the format of LWRP_X_Y_Z_OR_NEWER. For example, LWRP_5_3_0_OR_NEWER defines version 5.3.0.
• The Terrain Lit Shader now samples Spherical Harmonics if you haven't baked any lightmaps for terrain.
• Added a Priority option, which you can use to tweak the rendering order. This is similar to render queue in the built-in render pipeline. These Shaders now have this option: Lit, Simple Lit, Baked Lit, Unlit, and all three Particle Shaders.
• Added support for overriding terrain detail rendering shaders, via the render pipeline editor resources asset.

Changed

• You can now only initialize a camera by setting a Background Type. The supported options are Skybox, Solid Color, and Don't Care.
• LWRP now uses non-square shadowmap textures when it renders directional shadows with 2 shadow cascades.
• LWRP now uses RGB111110 as the HDR format on mobile devices, when this format is supported.
• Removed IAfterDepthPrePass interface.
• We’ve redesigned the Shader GUI. For example, all property names in Shaders are now inline across the board
• The Simple Lit Shader now has Smoothness, which can be stored in the alpha of specular or albedo maps.
• The Simple Lit and Particles Simple Lit Shaders now take shininess from the length (brightness) of the specular map.
• The Double sided property is now Render Face. This means you can also do front face culling.
• Changed the docs for Lit Shader, Simple Lit Shader and Unlit Shader according to Shader GUI changes.
• When you create a new LWRP Asset, it will now be initialized with settings that favor performance on mobile platforms.
• Updated the FAQ and the Built-in/LWRP feature comparison table.

Fixed

• Several tweaks to reduce bandwidth consumption on mobile devices.
• The foldouts in the Lightweight Asset inspector UI now remember their state.
• Added missing meta file for GizmosRenderingPass.cs.
• Fixed artifacts when using multiple or Depth Only cameras. Case 1072615
• Fixed a typo in ERROR_ON_UNSUPPORTED_FUNCTION() that was causing the shader compiler to run out of memory in GLES2. Case 1104271
• LWRP now renders shadows on scaled objects correctly. Case 1109017
• LWRP now allows some Asset settings to be changed at runtime. Case 1105552
• Realtime shadows now work in GLES2. Case 1087251
• Framedebugger now renders correctly when stepping through drawcalls.
• Cameras that request MSAA and Opaque Textures now use less frame bandwidth when they render.
• Fixed rendering in the gamma color space, so it doesn't appear darker.
• Particles SImple Lit and Particles Unlit Shaders now work correctly.
• Soft Particles now work correctly.
• Camera fading for particles.
• Fixed a typo in the Unlit IgnoreProjector tag.
• Particles render in both eyes with stereo instancing
• Fixed specular issues on mobile. case 1109017
• Fixed issue causing LWRP to create MSAA framebuffer even when MSAA setting was disabled.
• Post-processing in mobile VR is now forced to be disabled. It was causing many rendering issues.
• Fixed Editor Previews breaking in Play Mode when VR is enabled. Case 1109009
• A camera's HDR enable flag is now respected when rendering in XR.
• Terrain detail rendering now works correctly when LWRP is installed but inactive.

[5.2.0] - 2018-11-27

Added

• LWRP now handles blits that are required by the device when rendering to the backbuffer.
• You can now enable the SRP Batcher. To do so, go to the Pipeline Asset. Under Advanced, toggle SRP Batcher.

Changed

• Renamed shader variable unity_LightIndicesOffsetAndCount to unity_PerObjectLightData.
• Shader variables unity_4LightIndices0 and unity_4LightIndices1 are now declared as unity_PerObjectLightIndices array.

[5.1.0] - 2018-11-19

Added

• The user documentation for LWRP is now in this GitHub repo, instead of in the separate GitHub wiki. You can find the most up-to-date pages in the TableOfContents.md file. Pages not listed in that file are still in progress.

Changed

• The LWRP package is no longer in preview.
• LWRP built-in render passes are now internal.
• Changed namespace from UnityEngine.Experimental.Rendering.LightweightPipeline to UnityEngine.Rendering.LWRP.
• Changed namespace from UnityEditor.Experimental.Rendering.LightweightPipeline to UnityEditor.Rendering.LWRP.

Fixed

• LWRP now respects the iOS Player setting Force hard shadows. When you enable this setting, hardware filtering of shadows is disabled.
• Scene view mode now renders baked lightmaps correctly. Case 1092227
• Shadow bias calculations are now correct for both Shader Graph and Terrain shaders.
• Blit shader now ignores culling.
• When you select Per Vertex option for Additional Lights, the Per Object Limit option is not greyed out anymore.
• When you change camera viewport height to values above 1.0, the Unity Editor doesn't freeze anymore. Case 1097497
• When you use AR with LWRP, the following error message is not displayed in the console anymore: "The camera list passed to the render pipeline is either null or empty."

[5.0.0-preview] - 2018-09-28

Added

• Added occlusion mesh rendering/hookup for VR
• You can now configure default depth and normal shadow bias values in the pipeline asset.
• You can now add the LWRPAdditionalLightData component to a Light to override the default depth and normal shadow bias.
• You can now log the amount of shader variants in your build. To do so, go to the Pipeline Asset. Under Advanced, select and set the Shader Variant Log Level. ### Changed
• Removed the supportedShaderFeatures property from LWRP core. The shader stripper now figures out which variants to strip based on the current assigned pipeline Asset in the Graphics settings. ### Fixed
• The following error does not appear in console anymore: ("Begin/End Profiler section mismatch")
• When you select a material with the Lit shader, this no longer causes the following error in the console: ("Material doesn't have..."). case 1092354
• In the Simple Lit shader, per-vertex additional lights are now shaded properly.
• Shader variant stripping now works when you're building a Project with Cloud Build. This greatly reduces build times from Cloud Build.
• Dynamic Objects now receive lighting when the light mode is set to mixed.
• MSAA now works on Desktop platforms.
• The shadow bias value is now computed correctly for shadow cascades and different shadow resolutions. case 1076285
• When you use Area Light with LWRP, Cast Shadows no longer overlaps with other UI elements in the Inspector. case 1085363

Changed

Read/write XRGraphicsConfig -> Read-only XRGraphics interface to XRSettings.

[4.0.0-preview] - 2018-09-28

Added

• When you have enabled Gizmos, they now appear correctly in the Game view.
• Added requiresDepthPrepass field to RenderingData struct to tell if the runtime platform requires a depth prepass to generate a camera depth texture.
• The RenderingData struct now holds a reference to CullResults.
• When HDR is enabled in the Camera but disabled in the Asset, an information box in the Camera Inspector informs you about it.
• When MSAA is enabled in the Camera but disabled in the Asset, an information box in the Camera Inspector informs you about it.
• Enabled instancing on the terrain shader.
• Sorting of opaque objects now respects camera opaqueSortMode setting.
• Sorting of opaque objects disables front-to-back sorting flag, when camera settings allow that and the GPU has hidden surface removal.
• LWRP now has a Custom Light Explorer that suits its feature set.
• LWRP now supports Vertex Lit shaders for detail meshes on terrain.
• LWRP now has three interactive Autodesk shaders: Autodesk Interactive, Autodesk Interactive Masked and Autodesk Interactive Transparent.
• [Shader API] The GetMainLight and GetAdditionalLight functions can now compute shadow attenuation and store it in the new shadowAttenuation field in LightData struct.
• [Shader API] Added a VertexPositionInputs struct that contains vertex position in difference spaces (world, view, hclip).
• [Shader API] Added a GetVertexPositionInputs function to get an initialized VertexPositionInputs.
• [Shader API] Added a GetPerObjectLightIndex function to return the per-object index given a for-loop index.
• [Shader API] Added a GetShadowCoord function that takes a VertexPositionInputs as input.
• [ShaderLibrary] Added VertexNormalInputs struct that contains data for per-pixel normal computation.
• [ShaderLibrary] Added GetVertexNormalInputs function to return an initialized VertexNormalInputs.

Changed

• The RenderingData struct is now read-only.
• ScriptableRendereralways performs a Clear before calling IRendererSetup::Setup.
• ScriptableRenderPass::Execute no longer takes CullResults as input. Instead, use RenderingDataas input, since that references CullResults.
• IRendererSetup_Setup no longer takes ScriptableRenderContext and CullResults as input.
• Shader includes are now referenced via package relative paths instead of via the deprecated shader export path mechanism https://docs.unity3d.com/2018.3/Documentation/ScriptReference/ShaderIncludePathAttribute.html.
• The LWRP Asset settings were re-organized to be more clear.
• Vertex lighting now controls if additional lights should be shaded per-vertex or per-pixel.
• Renamed all Local Lights nomenclature to Additional Lights.
• Changed shader naming to conform to our SRP shader code convention.
• [Shader API] Renamed SpotAttenuation function to AngleAttenuation.
• [Shader API] Renamed _SHADOWS_ENABLED keyword to _MAIN_LIGHT_SHADOWS
• [Shader API] Renamed _SHADOWS_CASCADE keyword to _MAIN_LIGHT_SHADOWS_CASCADE
• [Shader API] Renamed _VERTEX_LIGHTS keyword to _ADDITIONAL_LIGHTS_VERTEX.
• [Shader API] Renamed _LOCAL_SHADOWS_ENABLED to _ADDITIONAL_LIGHT_SHADOWS
• [Shader API] Renamed GetLight function to GetAdditionalLight.
• [Shader API] Renamed GetPixelLightCount function to GetAdditionalLightsCount.
• [Shader API] Renamed attenuation to distanceAttenuation in LightData.
• [Shader API] Renamed GetLocalLightShadowStrength function to GetAdditionalLightShadowStrength.
• [Shader API] Renamed SampleScreenSpaceShadowMap functions to SampleScreenSpaceShadowmap.
• [Shader API] Renamed MainLightRealtimeShadowAttenuation function to MainLightRealtimeShadow.
• [Shader API] Renamed light constants from Directional and Local to MainLight and AdditionalLights.
• [Shader API] Renamed GetLocalLightShadowSamplingData function to GetAdditionalLightShadowSamplingData.
• [Shader API] Removed OUTPUT_NORMAL macro.
• [Shader API] Removed lightIndex and substractiveAttenuation from LightData.
• [Shader API] Removed ComputeShadowCoord function. GetShadowCoord is provided instead.
• All LightweightPipeline references in API and classes are now named LightweightRenderPipeline.
• Files no longer have the Lightweight prefix.
• Renamed Physically Based shaders to Lit, ParticlesLit, and TerrainLit.
• Renamed Simple Lighting shaders to SimpleLit, and ParticlesSimpleLit.
• [ShaderLibrary] Renamed InputSurfacePBR.hlsl, InputSurfaceSimple.hlsl, and InputSurfaceUnlit to LitInput.hlsl, SimpleLitInput.hlsl, and UnlitInput.hlsl. These files were moved from the ShaderLibrary folder to theShaders.
• [ShaderLibrary] Renamed LightweightPassLit.hlsl and LightweightPassLitSimple.hlsl to LitForwardPass.hlsl and SimpleLitForwardPass.hlsl. These files were moved from the ShaderLibrary folder to Shaders.
• [ShaderLibrary] Renamed LightweightPassMetaPBR.hlsl, LightweightPassMetaSimple.hlsl and LighweightPassMetaUnlit to LitMetaPass.hlsl, SimpleLitMetaPass.hlsl and UnlitMetaPass.hlsl. These files were moved from the ShaderLibrary folder to Shaders.
• [ShaderLibrary] Renamed LightweightPassShadow.hlsl to ShadowCasterPass.hlsl. This file was moved to the Shaders folder.
• [ShaderLibrary] Renamed LightweightPassDepthOnly.hlsl to DepthOnlyPass.hlsl. This file was moved to the Shaders folder.
• [ShaderLibrary] Renamed InputSurfaceTerrain.hlsl to TerrainLitInput.hlsl. This file was moved to the Shaders folder.
• [ShaderLibrary] Renamed LightweightPassLitTerrain.hlsl to TerrainLitPases.hlsl. This file was moved to the Shaders folder.
• [ShaderLibrary] Renamed ParticlesPBR.hlsl to ParticlesLitInput.hlsl. This file was moved to the Shaders folder.
• [ShaderLibrary] Renamed InputSurfacePBR.hlsl to LitInput.hlsl. This file was moved to the Shaders folder.
• [ShaderLibrary] Renamed InputSurfaceUnlit.hlsl to UnlitInput.hlsl. This file was moved to the Shaders folder.
• [ShaderLibrary] Renamed InputBuiltin.hlsl to UnityInput.hlsl.
• [ShaderLibrary] Renamed LightweightPassMetaCommon.hlsl to MetaInput.hlsl.
• [ShaderLibrary] Renamed InputSurfaceCommon.hlsl to SurfaceInput.hlsl.
• [ShaderLibrary] Removed LightInput struct and GetLightDirectionAndAttenuation. Use GetAdditionalLight function instead.
• [ShaderLibrary] Removed ApplyFog and ApplyFogColor functions. Use MixFog and MixFogColor instead.
• [ShaderLibrary] Removed TangentWorldToNormal function. Use TransformTangentToWorld instead.
• [ShaderLibrary] Removed view direction normalization functions. View direction should always be normalized per pixel for accurate results.
• [ShaderLibrary] Renamed FragmentNormalWS function to NormalizeNormalPerPixel.

Fixed

• If you have more than 16 lights in a scene, LWRP no longer causes random glitches while rendering lights.
• The Unlit shader now samples Global Illumination correctly.
• The Inspector window for the Unlit shader now displays correctly.
• Reduced GC pressure by removing several per-frame memory allocations.
• The tooltip for the the camera MSAA property now appears correctly.
• Fixed multiple C# code analysis rule violations.
• The fullscreen mesh is no longer recreated upon every call to ScriptableRenderer.fullscreenMesh.

[3.3.0-preview] - 2018-01-01

Added

• Added callbacks to LWRP that can be attached to a camera (IBeforeCameraRender, IAfterDepthPrePass, IAfterOpaquePass, IAfterOpaquePostProcess, IAfterSkyboxPass, IAfterTransparentPass, IAfterRender)

Changed

• Clean up LWRP creation of render textures. If we are not going straight to screen ensure that we create both depth and color targets.
• UNITY_DECLARE_FRAMEBUFFER_INPUT and UNITY_READ_FRAMEBUFFER_INPUT macros were added. They are necessary for reading transient attachments.
• UNITY_MATRIX_I_VP is now defined.
• Renamed LightweightForwardRenderer to ScriptableRenderer.
• Moved all light constants to _LightBuffer CBUFFER. Now _PerCamera CBUFFER contains all other per camera constants.
• Change real-time attenuation to inverse square.
• Change attenuation for baked GI to inverse square, to match real-time attenuation.
• Small optimization in light attenuation shader code.

Fixed

• Lightweight Unlit shader UI doesn't throw an error about missing receive shadow property anymore.

[3.2.0-preview] - 2018-01-01

Changed

• Receive Shadows property is now exposed in the material instead of in the renderer.
• The UI for Lightweight asset has been updated with new categories. A more clean structure and foldouts has been added to keep things organized.

Fixed

• Shadow casters are now properly culled per cascade. (case 1059142)
• Rendering no longer breaks when Android platform is selected in Build Settings. (case 1058812)
• Scriptable passes no longer have missing material references. Now they access cached materials in the renderer.(case 1061353)
• When you change a Shadow Cascade option in the Pipeline Asset, this no longer warns you that you've exceeded the array size for the _WorldToShadow property.
• Terrain shader optimizations.

[3.1.0-preview] - 2018-01-01

Fixed

• Fixed assert errors caused by multi spot lights
• Fixed LWRP-DirectionalShadowConstantBuffer params setting

[3.0.0-preview] - 2018-01-01

Added

• Added camera additional data component to control shadows, depth and color texture.
• pipeline now uses XRSEttings.eyeTextureResolutionScale as renderScale when in XR.
• New pass architecture. Allows for custom passes to be written and then used on a per camera basis in LWRP

Changed

• Shadow rendering has been optimized for the Mali Utgard architecture by removing indexing and avoiding divisions for orthographic projections. This reduces the frame time by 25% on the Overdraw benchmark.
• Removed 7x7 tent filtering when using cascades.
• Screenspace shadow resolve is now only done when rendering shadow cascades.
• Updated the UI for the Lighweight pipeline asset.
• Update assembly definitions to output assemblies that match Unity naming convention (Unity.*).

Fixed

• Post-processing now works with VR on PC.
• PS4 compiler error
• Fixed VR multiview rendering by forcing MSAA to be off. There's a current issue in engine that breaks MSAA and Texture2DArray.
• Fixed UnityPerDraw CB layout
• GLCore compute buffer compiler error
• Occlusion strength not being applied on LW standard shaders
• CopyDepth pass is being called even when a depth from prepass is available
• GLES2 shader compiler error in IntegrationTests
• Can't set RenderScale and ShadowDistance by script
• VR Single Pass Instancing shadows
• Fixed compilation errors on Nintendo Switch (limited XRSetting support).

[2.0.0-preview] - 2018-01-01

Added

• Explicit render target load/store actions were added to improve tile utilization
• Camera opaque color can be requested on the pipeline asset. It can be accessed in the shader by defining a _CameraOpaqueTexture. This can be used as an alternative to GrabPass.
• Dynamic Batching can be enabled in the pipeline asset
• Pipeline now strips unused or invalid variants and passes based on selected pipeline capabilities in the asset. This reduces build and memory consuption on target.
• Shader stripping settings were added to pipeline asset

Changed

Pipeline

• Pipeline code is now more modular and extensible. A ForwardRenderer class is initialized by the pipeline with RenderingData and it's responsible for enqueueing and executing passes. In the future pluggable renderers will be supported.
• On mobile 1 directional light + up to 4 local lights (point or spot) are computed
• On other platforms 1 directional light + up to 8 local lights are computed
• Multiple shadow casting lights are supported. Currently only 1 directional + 4 spots light shadows. #### Shading Framework
• Directional Lights are always considered a main light in shader. They have a fast shading path with no branching and no indexing.
• GetMainLight() is provided in shader to initialize Light struct with main light shading data.
• Directional lights have a dedicated shadowmap for performance reasons. Shadow coord always comes from interpolator.
• MainLigthRealtimeShadowAttenuation(float4 shadowCoord) is provided to compute main light realtime shadows.
• Spot and Point lights are always shaded in the light loop. Branching on uniform and indexing happens when shading them.
• GetLight(half index, float3 positionWS) is provided in shader to initialize Light struct for spot and point lights.
• Spot light shadows are baked into a single shadow atlas.
• Shadow coord for spot lights is always computed on fragment.
• Use LocalLightShadowAttenuation(int lightIndex, float3 positionWS) to comppute realtime shadows for spot lights.

Fixed

• Issue that was causing VR on Android to render black
• Camera viewport issues
• UWP build issues
• Prevent nested camera rendering in the pipeline

[1.1.4-preview] - 2018-01-01

Added

• Terrain and grass shaders ported
• Updated materials and shader default albedo and specular color to midgrey.
• Exposed _ScaledScreenParams to shader. It works the same as _ScreenParams but takes pipeline RenderScale into consideration
• Performance Improvements in mobile

Fixed

• SRP Shader library issue that was causing all constants to be highp in mobile
• shader error that prevented LWRP to build to UWP
• shader compilation errors in Linux due to case sensitive includes
• Rendering Texture flipping issue
• Standard Particles shader cutout and blending modes
• crash caused by using projectors
• issue that was causing Shadow Strength to not be computed on mobile
• Material Upgrader issue that caused editor to SoftLocks
• GI in Unlit shader
• Null reference in the Unlit material shader GUI

[1.1.2-preview] - 2018-01-01

Changed

• Performance improvements in mobile

Fixed

• Shadows on GLES 2.0
• CPU performance regression in shadow rendering
• Alpha clip shadow issues
• Unmatched command buffer error message
• Null reference exception caused by missing resource in LWRP
• Issue that was causing Camera clear flags was being ignored in mobile

[1.1.1-preview] - 2018-01-01

Added

• Added Cascade Split selection UI
• Added SHADER_HINT_NICE_QUALITY. If user defines this to 1 in the shader Lightweight pipeline will favor quality even on mobile platforms.

Changed

• Shadowmap uses 16bit format instead of 32bit.
• Small shader performance improvements

Fixed

• Subtractive Mode
• Shadow Distance does not accept negative values anymore

[0.1.24] - 2018-01-01

Added

• Added Light abstraction layer on lightweight shader library.
• Added HDR global setting on pipeline asset.
• Added Soft Particles settings on pipeline asset.
• Ported particles shaders to SRP library

Changed

• HDR RT now uses what format is configured in Tier settings.
• Refactored lightweight standard shaders and shader library to improve ease of use.
• Optimized tile LOAD op on mobile.
• Reduced GC pressure
• Reduced shader variant count by ~56% by improving fog and lightmap keywords
• Converted LW shader library files to use real/half when necessary.

Fixed

• Realtime shadows on OpenGL
• Shader compiler errors in GLES 2.0
• Issue sorting issues when BeforeTransparent custom fx was enabled.
• VR single pass rendering.
• Viewport rendering issues when rendering to backbuffer.
• Viewport rendering issues when rendering to with MSAA turned off.
• Multi-camera rendering.

[0.1.23] - 2018-01-01

Added

• UI Improvements (Rendering features not supported by LW are hidden)

Changed

• Shaders were ported to the new SRP shader library.
• Constant Buffer refactor to use new Batcher
• Shadow filtering and bias improved.
• Pipeline now updates color constants in gamma when in Gamma colorspace.
• Optimized ALU and CB usage on Shadows.
• Reduced shader variant count by ~33% by improving shadow and light classification keywords
• Default resources were removed from the pipeline asset.

Fixed

• Fixed shader include path when using SRP from package manager.
• Fixed spot light attenuation to match Unity Built-in pipeline.
• Fixed depth pre-pass clearing issue.

[0.1.12] - 2018-01-01

Added

• Standard Unlit shader now has an option to sample GI.
• Added Material Upgrader for stock Unity Mobile and Legacy Shaders.
• UI improvements

Changed

• Realtime shadow filtering was improved.

Fixed

• Fixed an issue that was including unreferenced shaders in the build.
• Fixed a null reference caused by Particle System component lights.