image/svg+xml
docs.unity3d.com
  • Manual
  • Scripting API
  • Changelog
  • License
    Show / Hide Table of Contents
    • Universal Render Pipeline
    • Requirements
      • Building for Closed platforms
    • What's new in URP
    • Features
      • Feature Comparison with the Built-in Render Pipeline
    • Getting started
      • Create a Project from a Template
      • Install URP into an existing Project
    • Render Pipeline Concepts
      • The URP Asset
      • URP Global Settings
      • Universal Renderer
      • Deferred Rendering Path
      • Renderer Feature
        • How to add a Renderer Feature
        • Render Objects Renderer Feature
        • Ambient Occlusion
        • Decal
          • Decal Shader Graph
    • Upgrade guides
      • Render Pipeline Converter
      • Upgrading to URP 12.​0.​x
      • Upgrading to URP 11.​0.​x
      • Upgrading to URP 10.​1.​x
      • Upgrading to URP 10.​0.​x
      • Upgrading to URP 9.​0.​x
      • Upgrading to URP 8.​2.​0
      • Upgrading to URP 8.​1.​0
      • Upgrading to URP 8.​0.​0
      • Upgrading to URP 7.​4.​0
      • Upgrading to URP 7.​3.​0
      • Upgrading to URP 7.​2.​0
      • Upgrading from LWRP to URP
    • Rendering
      • How to use Render Objects Renderer Feature
    • Lighting
      • Light component reference
      • Lighting Mode
      • The Universal Additional Light Data component
      • Shadows in the Universal Render Pipeline
      • Reflection probes
      • Light Layers
      • Lens Flare asset
    • Cameras
      • The Universal Additional Camera Data component
      • Render Type
      • Working with multiple cameras
        • Camera Stacking
        • Rendering from multiple Cameras to the same render target
        • Rendering to a Render Texture
      • Clearing, rendering order and overdraw
      • Camera component reference
    • Post-processing
      • How to configure
      • Volumes
        • Volume Profile
        • Volume Overrides
      • Effect List
        • Ambient Occlusion
        • Bloom
        • Channel Mixer
        • Chromatic Aberration
        • Color Adjustments
        • Color Curves
        • Depth of Field
        • Film Grain
        • Lens Distortion
        • Lift, Gamma, and Gain
        • Motion Blur
        • Panini Projection
        • Shadows Midtones Highlights
        • Split Toning
        • Tonemapping
        • Vignette
        • White Balance
        • Lens Flare
    • Shaders and Materials
      • Shading Models
      • Complex Lit
      • Lit
      • Simple Lit
      • Baked Lit
      • Unlit
      • Particles Lit
      • Particles Simple Lit
      • Particles Unlit
      • Decal
      • Upgrading shaders from Built-in
      • Shader stripping
      • Writing custom shaders
        • Creating a sample scene
        • URP basic unlit shader
        • URP unlit shader with color input
        • Drawing a texture
        • Visualizing normal vectors
        • Reconstruct the world space positions
      • URP Shader​Lab Pass tags
    • Customizing URP
      • begin​Camera​Rendering event
    • 2D graphic features
      • Introduction to Lights 2D
        • Requirements and setup
        • Configuring the 2D Renderer Asset
          • HDR emulation scale
          • Light Blend Styles
        • Preparing and upgrading
        • Normal map and mask Textures
        • Common Lights 2D properties
          • Lights 2D types and specific properties
        • 2D Shadows
        • 2D Renderer and Shader Graph
      • 2D Pixel Perfect
        • Cinemachine Pixel Perfect extension
    • Frequently asked questions (FAQ.​md)
    • Known issues
    • Manual
    • Lighting
    • Light component reference

    The Light component

    Lights determine the shading of an object and the shadows it casts.

    This page contains information on Light components in the Universal Render Pipeline (URP). For a general introduction to lighting in Unity and examples of common lighting workflows, see the Lighting section of the Unity Manual.

    Properties

    The Light Inspector includes the following groups of properties:

    • General
    • Shape
    • Emission
    • Rendering
    • Shadows

    General

    Property: Function:
    Type The current type of light. Possible values are Directional, Point, Spot and Area.
    Mode Specify the Light Mode used to determine if and how a light is "baked". Possible modes are Realtime, Mixed and Baked.

    Shape

    Property: Function:
    Spot Angle Define the angle (in degrees) at the base of a spot light’s cone (Spot light only).

    Emission

    Property: Function:
    Color Use the color picker to set the color of the emitted light.
    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.
    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.
    Range Define how far the light emitted from the center of the object travels (Point and Spot lights only).

    Rendering

    Property: Function:
    Render Mode Use this drop-down to set the rendering priority of the selected Light. This can affect lighting fidelity and performance (see Performance Considerations, below).
        Auto The rendering method is determined at run time, depending on the brightness of nearby lights and the current Quality settings.
        Important The light is always rendered at per-pixel quality. Use Important mode only for the most noticeable visual effects (for example, the headlights of a player’s car).
        Not Important The light is always rendered in a faster, vertex/object light mode.
    Culling Mask Use this to selectively exclude groups of objects from being affected by the Light. For more information, see Layers.

    Shadows

    Property: Function:
    Shadow Type Determine whether this Light casts Hard Shadows, Soft Shadows, or no shadows at all. See the page Lights for information on hard and soft shadows.
        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.
        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.
        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.
            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.
            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.
            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.
            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.
            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.

    Preset

    When using Preset of Light Component, only a subset of properties are supported. Unsupported properties are hidden.

    In This Article
    • Properties
      • General
      • Shape
      • Emission
    • Rendering
    • Shadows
    • Preset
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023