Search Unity

The Lightweight Render Pipeline: Optimizing Real Time Performance

February 21, 2018 in Technology | 7 min. read
Topics covered

Is this article helpful for you?

Thank you for your feedback!

Update: LWRP is now out of preview and production-ready. Get more info in our 2019.1 release post.

In a recent blog post we introduced the concept of Scriptable Render Pipelines. In short, SRP allow developers to control how Unity renders a frame in C#. We will release two built-in render pipelines with Unity 2018.1: the Lightweight Pipeline and HD Pipeline. In this article we’re going to focus on the Lightweight Pipeline or LWRP.

By exposing the rendering pipelines to C# our goal is to make Unity less of a black box and enable developers to explicitly control what is happening during rendering. Developers can use the built-in pipelines we’re providing, develop their own pipeline from scratch or start by modifying  one of the provided pipelines to meet their specific requirements.

We’ve released a video which provides a short overview of the Scriptable Render Pipeline concept including some footage of projects using the various pipelines:

This content is hosted by a third party provider that does not allow video views without acceptance of Targeting Cookies. Please set your cookie preferences for Targeting Cookies to yes if you wish to view videos from these providers.

The goal of the LWRP is to provide optimized real time performance on performance constrained platforms by making some tradeoffs with regard to lighting and shading.

The target audience for LWRP is developers targeting a broad range of mobile platforms, VR and those that develop games with limited realtime lighting needs. The LWRP performs single-pass forward rendering with one real time shadow light and light culling per-object with the advantage that all lights are shaded in a single pass. Compared to the legacy pipeline forward rendering, which performs an additional pass per pixel light within range, using the LW pipeline will result in less draw calls. This is at the expense of some additional shader complexity due to more lights per pass.  The LWRP is also supported by our Shader Graph tool, which will provide some additional benefits with regard to shader authoring workflow.

Lightweight Shaders

The LWRP has its own process for rendering and therefore requires shaders which are written with it in mind. We have developed a new set of Standard Shaders that are located under the Lightweight Pipeline group in the material’s shader selection dropdown. These include a Standard PBR shader, a Non PBR Standard shader with a simplified lighting model, a Standard Terrain shader and a Standard Unlit shader.  It’s worth noting that all Unity’s unlit stock shaders work already with LWRP. This includes legacy particles, UI, skybox, and sprite shader.

The Lightweight Pipeline also provides material upgraders to upgrade Unity’s stock lit shaders to shaders compatible with the pipeline. In order to upgrade materials go to Edit -> Render Pipeline -> Upgrade -> Lightweight. You can choose to either upgrade all material in a project, or selected materials.

Material Upgraders

The Render Pipeline Asset

The currently selected render pipeline is selected by assigning a pipeline asset in the Scriptable Render Pipeline Settings of the Graphics Settings window. It can also be assigned from script via the GraphicsSettings.renderPipelineAsset property.

In addition to selecting a pipeline to define the overall rendering approach of your project at the outset, it’s possible to store multiple quality settings within different instances of the same type of render pipeline. The pipeline asset controls the global rendering quality settings and is responsible for creating the pipeline instance. The pipeline instance contains intermediate resources and the render loop implementation.

Lightweight Rendering

The rendering features of LWRP are mainly a subset of the built-in renderer. In order to improve performance on performance limited platforms, certain functionality has been deliberately excluded. Unity provides developers with a wide array of tools and techniques to apply to their games. The risk in this is that sometimes the wrong technique is applied to a game which doesn’t have the performance resources to support it.  The goal of providing specialized rendering pipelines as templates is to mitigate the possibility for users to make certain potentially costly mistakes in terms of performance. Deploying inappropriate post processing effects for a target platform for example may make the game slow on a device, even though those effects are supported in Unity and might perform appropriately on the appropriate target platform.

Realtime global illumination is another example of a feature which is rarely used on the LW RP target platforms and has therefore been removed. The single supported rendering path is single-pass forward, which is another decision which privileges performance over rendering complexity. The table below provides further detail about which techniques are supported in the Built-In Pipeline, and which are supported in Lightweight.

Unity Built-In PipelineLightweight Pipeline
Platform CoverageAllAll
Rendering PathsMulti-pass Forward

Multi-pass Deferred

Single-pass Forward
Lighting Attenuation Separate precomputed attenuation textures for Point and Spot

Vertex light attenuation does not reach 0 intensity at range boundary.

Attenuation computed in the shader smoothly fading to light range. Inner and outer angle for spot lights.
Color SpaceLinear with sRGB light intensity


Linear preferred, Gamma supported

Linear light intensities

Realtime LightsDirectional, Spot and Point

Amount of pixel lights controlled by Quality Settings

Forward path limited to 8 pixel lights.

Supports up to 4 vertex point lights.

Directional, Spot and Point

Amount of pixel lights controlled by Pipeline Asset

Limited to 8 pixel lights.

Supports up to 4 vertex point lights.

Light ModesBaked


Baked Indirect

Shadow Mask

Distance Shadowmask





Baked Indirect


Global IlluminationDirectional, Spot, Point and Rectangular Area Lights


Lightmap (Non-Directional and Directional)

Light Probes


Dynamic Lightmap

Realtime Lightprobes

Directional, Spot, Point and Rectangular Area Lights


Lightmap (Non-Directional and Directional)

Light Probes

Realtime GI Not Supported.

Light CullingPer-Object. No Compute.Per-Object. No Compute.
Shader LibraryDozens of non physically based shaders specializations

Unified Standard PBS Shaders:

Metallic workflow

Specular workflow

Roughness workflow

Unified Standard non physically based Shader (covers most legacy and mobile lit shaders)

Unified Standard Shader (Metallic or Specular workflow)

Physically Based ShadingDisney Diffuse + Cook Torrance (GGX, Smith, Schlick) Specular

Lambertian Diffuse + Simplified Cook Torrance (GGX, Simplified KSK and Schlick) Specular

Lambertian Diffuse + Non-Microfaceted LUT Specular

Lambertian Diffuse + Simplified Cook Torrance (GGX, Simplified KSK and Schlick) Specular
Light CookiesMonochromeNot supported in V1
Light Probes ModesOne interpolated probe


One interpolated probe
Reflection ProbesSorted per-object, blend between at most 2 probesSorted per-object, no blending
Shadows FeaturesPSSM Stable and Close Fit

Filtering: PCF

No depth clip. Pancaking done in vertex.

PSSM Stable Fit

Filtering: PCF

No depth clip. Pancaking done in vertex.

Shadow ModesLight Space

Screen Space

Screen Space
Shadow Casting LightsDirectional, Spot, Point

Multiple shadow light casters, one per-pass.

Directional and Spot

Single shadow light caster supported as main light.

CameraSorts camera by depth value

Stack Management

Groups by common camera state

Handles depth state between cameras

Sorts camera by depth value

No stack management

RenderTarget scale supported

Game renders at scaled resolution

UI renders at native resolution

Anti-AliasingMSAA, TAAMSAA
Pipeline Additional DataMotion VectorsNone
Post-ProcessingLegacy Post-Processing stack

new Post-Processing Stack

Subset of the new Post-Processing Stack FX

No support for: TAA, Motion Blur, SSR

Debug optionDisplay GBuffer

Display various bake lighting view mode

Sky lightingProcedural Sky

Cubemap/LatLong Sky

Ambient Lighting

Procedural Sky


Ambient Lighting

Customizing The Lightweight Pipeline

The incredible potential of the Scriptable Render Pipeline architecture is that it’s more open and customizable than rendering in Unity ever has been. If you want to have access to Lightweight Pipeline source, take a look at the Scriptable Render Pipeline github page. There you can grab the C# source for the LW RP and begin making modifications to create a pipeline which is uniquely suited to your project. If you run into any issues, we’d love to hear about them via our github page. We’re also looking forward to hearing from you on the beta forum.

February 21, 2018 in Technology | 7 min. read

Is this article helpful for you?

Thank you for your feedback!

Topics covered