docs.unity3d.com
    Show / Hide Table of Contents

    Freeform

    Freeform Properties

    Select the Freeform Light type to create a Light from an editable polygon with a spline editor. To begin editing your shape, select the Light and find the button in its Inspector window. Select it to enable the shape editing mode.

    Add new control points by clicking the mouse along the inner polygon’s outline. Remove control points selecting the point and pressing the Delete key.

    The following additional properties are available to the Freeform Light type.

    Property Function
    Falloff Adjust the amount the blending from solid to transparent, starting from the center of the shape to its edges.
    Falloff Intensity Adjusts the falloff curve of the Light.
    Falloff Offset Sets the offset for the outer falloff shape.
    Light Editing Mode Light Effect
    Freeform Light in edit mode Resulting Light Effect

    When creating a Freeform Light, take care to avoid self-intersection as this may cause unintended lighting results. Self-intersection may occur by creating outlines where edges cross one another, or by enlarging falloff until it overlaps itself. To prevent such issues, it is recommended to edit the shape of the Light until the conditions creating the self-intersection no longer occur.

    Freeform Self Intersection Freeform Self Intersection
    Outline self-intersection in Edit mode. Light effect with a black triangular artifact
    Freeform Self Intersection Freeform Self Intersection
    Falloff overlap in Edit mode Light effect with double lighted areas with overlapping falloff

    Parametric

    The Parametric light type has been deprecated. To convert existing Parametric lights to Freeform lights, Edit > Rendering > Lights > Upgrade Project/Scene URP Parametric Lights to Freeform

    Sprite

    Select the Sprite Light type to create a Light based on a selected Sprite by assigning the selected Sprite to the additional Sprite property.

    The Sprite property

    Property Function
    Sprite Select a Sprite as the Light source.
    Selected Sprite Resulting Light effect
    Selected Sprite Resulting Light effect

    Spot

    Select the Spot Light type for great control over the angle and direction of the selected Light with the following additional properties.

    Point Light properties

    Property Function
    Radius Inner Set the inner radius here or with the gizmo. Light within the inner radius will be at maximum intensity.
    Radius Outer Set the outer radius here or with the gizmo. Light intensity decreases to zero as it approaches the outer radius.
    Inner / Outer Spot Angle Set the angles with this slider or with the gizmo. Light within the inner and outer angles will be at the intensity specified by inner and outer radius.
    Point Light editing Mode Resulting light effect
    Point Light in Edit mode Resulting Light effect

    Global

    Global Lights light all objects on the targeted sorting layers. Only one global Light can be used per Blend Style, and per sorting layer.

    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