Skip to main content

Light Data

The Light Data section provides options for changing features relating to the data used for lighting and shading the material. Options here significantly influence the functionality of the Shading section.

AO Maps​

  • Type: Data Texture (sRGB OFF)

A texture used to define the Ambient Occlusion (AO) for different areas on the material. Ambient occlusion darkens the lighting provided by ambient (indirect) lighting, an effect frequently seen in physical environments. This texture is generally baked in a 3d program like Blender or Substance Painter.

The AO map texture reads all 4 RGBA channels independently, allowing different AO maps to be packed into individual channels, and the intensity of each channel can be adjusted independently using the sliders visible on dropdown. This can be used to create different AO maps for different material states, for example, different AO maps on the skin of a character with different combinations of clothing.

Generally, if only a single map is being used (such as in the case of a black and white AO map), only one slider should generally be used.

AO Map R/G/B/A Intensity​

  • Type: Float, Range: 0.0 - 1.0

Intensity of each AO map channel.

Detail Shadows​

  • Type: Data Texture (sRGB OFF)

A texture used to define the Detail Shadows for different areas on the material. Detail Shadows darken the lighting provided by direct lighting. In some cases, this texture is similar to (or identical to) the AO texture.

For certain styles, this can be used with hand-painted shadows to provide hard edged shadows in controlled areas. This can be preferable to painting the shadows directly onto the main texture, because in dark environments without much direct light, the shadows will disappear. In some cases, a mix of light shadows painted onto the main texture and those same shadows being used in a detail shadow texture.

The Detail Shadow texture reads all 4 RGBA channels independently, allowing different Detail Shadow maps to be packed into individual channels, and the intensity of each channel can be adjusted independently using the sliders visible on dropdown. This can be used to create different Detail Shadow maps for different material states, for example, different Detail Shadow maps on the skin of a character with different combinations of clothing.

Generally, if only a single map is being used (such as in the case of a black and white Detail Shadow map), only one slider should generally be used.

Detail Shadow R/G/B/A Intensity​

  • Type: Float, Range: 0.0 - 1.0

Intensity of each Detail Shadow map channel.

Shadow Masks​

  • Type: Data Texture (sRGB OFF)

A texture used to define the shadow mask on different areas of the material. Shadow Masks reduce the influence of shadows, and can be used to to create stylized models and appearances.

The Shadow Mask texture reads all 4 RGBA channels independently, allowing different Shadow Masks to be packed into individual channels, and the intensity of each channel can be adjusted independently using the sliders visible on dropdown. This can be used to create different Shadow Masks for different material states, for example, different Shadow Masks on the skin of a character with different combinations of clothing.

Shadow Mask R/G/B/A Intensity​

  • Type: Float, Range: 0.0 - 1.0

Intensity of each Shadow mask channel.

Base Pass Lighting​

Options controlling the lighting in the base pass. The base pass is used for basic lighting functionality like baked lighting, reflections, and the first directional light in a scene.

Light Color Mode​

  • Type: Dropdown, Options: Poi Custom/Standard/UTS2

Defines how to calculate the light color. These will generally exhibit small differences under simple or ideal lighting, but will diverge in more complex or adverse lighting conditions.

Poi Custom (Light Color)​

Poi Custom light color uses a custom light calculation to better handle adverse lighting conditions, such as those often encountered in user-created content.

Poi Custom light color mode adds the Indirect uses Normals option.

Standard​

Standard light color uses a light calculation that more closely matches the Unity Standard shader. It can often break down in adverse lighting conditions.

UTS2 (Light Color)​

UTS2 (UnityChan Toon Shader 2) light color uses a calculation that produces a result that's generally consistent, but often incoherent with the environmental lighting conditions.

This mode adds the Unlit Intensity option.

Light Map Mode​

  • Type: Dropdown, Options: Poi Custom/Normalized NDotL/Saturated NDotL

Changes how the light map is calculated.

This option may be removed in future versions of the shader.

Poi Custom (Light Map)​

Poi Custom light map uses a custom calculation for the lightmap. It takes into account the baked lighting conditions.

Normalized NDotL​

Normalized NDotL uses the dot product between the mesh normal and the light direction, normalized from 0-1.

Saturated NDotL​

Normalized NDotL uses the dot product between the mesh normal and the light direction, saturated at 0 and 1.

Light Direction Mode​

Options: Poi Custom/Forced Local Direction/Forced World Direction/UTS2

Defines how the light direction should be calculated. This can be used to emulate the look of other shaders, or to force a certain appearance while still remaining lit.

Poi Custom (Light Direction)​

Poi Custom light direction calculates the light direction taking into account the lighting conditions. This will be only slightly different from the Unity Standard Shader's light direction under ideal cases, but will handle a lack of direct lighting better.

Technically, this option calculates the light direction as the sum of the World-space light position and the first order R, G, and B spherical harmonic components.

Forced Local Direction​

Forced Local Direction forces the light direction to a specific vector. This vector is kept constant relative to the model's coordinate system.

This option adds the Forced Direction option.

Forced World Direction​

Forced World Direction forces the light direction to a specific vector. This vector is kept constant relative to the world coordinate system.

This option adds the Forced Direction option.

UTS2 (Light Direction)​

UTS2 calculates the light direction the same as the Unity Standard Shader, but will use the view direction to "fake" a light direction, which results in better handling of a lack of direct lighting.

Forced Direction​

  • Type: Vector3

What direction to force the lighting to.

This option is only visible when Light Direction Mode is set to Forced Local Direction or Forced World Direction.

Force Light Color​

  • Type: Checkbox

Whether to force the light color to a specific color. Enabling this option adds the Forced Color option.

Forced Color​

  • Type: Color

What color the light should be forced to.

This option is only visible when Force Light Color is enabled.

Unlit Intensity​

  • Type: Float, Range: 0.001-4

How much the model should be lit, even in the absence of direct lighting.

This option is only visible when Light Color Mode is set to UTS2.

Limit Brightness​

  • Type: Checkbox

Whether to cap the brightness value to a specific maximum. Enabling this option adds the Max Brightness option.

Max Brightness​

  • Type: Float, Range: 0.0 - 10.0

If Limit Brightness is enabled, the brightness due to base pass lighting calculations will never go above this value. Add pass lighting or emission can cause the final color to exceed this value.

This option is only visible when Limit Brightness is enabled.

Min Brightness​

  • Type: Float, Range: 0.0 - 1.0

Sets the minimum value for direct lighting. This can be useful for preventing a model from getting too dark in adverse lighting conditions.

Indirect Uses Normals​

  • Type: Float, Range: 0.0 - 1.0

Defines how much to use normals when calculating indirect lighting direction. If not enabled, the indirect lighting will be sampled using the 0-vector.

This option is only visible when Light Color Mode is set to Poi Custom.

Receieve Casted Shadows​

  • Type: Float, Range: 0.0 - 1.0

Defines how much to apply Unity's built-in casted shadows to the model. These can look good under certain conditions, but often will look blocky or otherwise produce undesirable results.

Grayscale Lighting​

  • Type: Float, Range: 0.0 - 1.0

Defines how much to desaturate the base pass lighting color. This keeps the perceptual luminance the same, but reduces the saturation.

Add Pass Lighting​

Options relating to lighting performed in the add pass. The add pass is used for any realtime point lights or directional lights beyond the first in a scene.

Enable Additive​

  • Type: Checkbox

Enables or disables add pass lighting in general.

Ignore Directional​

  • Type: Checkbox

Ignore directional lights in the add pass.

Limit Brightness​

  • Type: Checkbox

Whether to limit the brightness of add pass lights. Enabling this adds the Max Brightness option.

Max Brightness​

  • Type: Float, Range: 0.0 - 10.0

Defines the maximum allowed brightness resulting from the add pass.

Grayscale Lighting?​

  • Type: Float, Range: 0.0 - 1.0

Defines how much to desaturate the add pass lighting color. This keeps the perceptual luminance the same, but reduces the saturation.

Point Light Passthrough​

  • Type: Float, Range: 0.0 - 1.0

How much to apply realtime point lighting to the indirect color.

Vertex Lighting​

Vertex lighting allows realtime lights set to non-important to perform their lighting calculations on a per-vertex basis instead of a per-pixel basis. This results in these lights being much lighter to process at runtime.

Enabled​

  • Type: Checkbox

Enables or Disables vertex lighting.

Debug Visualization​

Debug visualization provides visualizations of the results of lighting data settings and calculations.

Debug​

  • Type: Checkbox

Enable or Disable debug view.

Direct Color​

Shows the Direct Color across the model.

Indirect Color​

Shows the Indirect Color across the model.

Light Map​

Shows the Light Map across the model.

Attenuation​

Shows the Attenuation (Unity Shadows) across the model.

N Dot L​

Shows the N Dot L result (Normal dot Light) across the model.

Half Dir​

Shows the Half Dir (normalized sum of light direction and view direction) across the model.

Direction​

Shows the Light Direction across the model.

Add Color​

Shows the color resulting from any Add Pass lights across the model.

Add Attenuation​

Shows the attenuation from any Add Pass lights across the model.

Add Shadow​

Shows the shadow map from any Add Pass lighting across the model.

Add NDotL​

Shows the N Dot L result (Normal dot Light) from any Add Pass lighting across the model.

Last updated on