Skip to main content

Physical Light Units

Lights, the sky and the camera use real-world photometric units. A lamp is set in lumens, the sun in lux, a screen or sky in nits, and the camera exposes the result like a real camera, with an exposure value (EV100). A scene lit with the values from a lamp's box or a light meter looks natural without tuning, and the same light works in a dim interior and in daylight, because the exposure adapts and the light does not have to.

Units​

QuantityUnitMeaningUsed by
Luminous fluxlumen (lm)Total light a source emits. The number printed on a bulb's box.Point, spot and area lights with IntensityUnit Lumen
Luminous intensitycandela (cd)Light per solid angle in one direction. A bare point source of 1 cd emits 4π lm.Point and spot lights with IntensityUnit Candela
Luminancenit (cd/m²)Brightness of a surface as seen by the camera.Area lights with IntensityUnit Nits, the sky, emissive materials
Illuminancelux (lm/m²)Light arriving at a surface. What a light meter reads.Directional light, sky calibration
Exposure valueEV100Camera setting that maps scene luminance to the image. One EV is a factor of 2.Camera component

The renderer works in candela for point and spot lights, nits for area lights and emissive surfaces, and lux for directional lights. Lumens are converted when the light is extracted, so either unit costs the same.

Units per light type​

LightUnitsEditor defaultConversion from lumens
PointLumen, Candela800 lm, 2700 K (a 60 W household bulb)cd = lm / 4π
SpotLumen, Candela800 lm, 3000 K, Reflector onReflector on: cd = lm / Ω, with Ω = 2π(1 − cos(outer angle / 2)). Reflector off: cd = lm / 4π
RectLumen, Nits1000 lm, 4000 K, 1 × 1 mnits = lm / (π · area)
DiskLumen, Nits1000 lm, 3000 K, radius 0.5 mnits = lm / (π · area)
CylinderLumen, Nits3350 lm, 4000 K, radius 0.013 m, length 1.2 m (a T8 tube)nits = lm / (π · area); the area includes the end caps when EndCaps is on
Directionallux110,000 lux, 5700 K (the sun at noon)none

A few details:

  • Lumens keep the output when you resize an area light. A rect light of 1000 lm stays at 1000 lm when it grows; its surface gets dimmer. In Nits the surface keeps its brightness and the total output grows with the area.
  • TwoSided rect and disk lights emit from both faces, so their emitting area, and the lumens for a given luminance, double.
  • Reflector only matters while a spot light is in lumens. On, the spot behaves like a lamp with a reflector: all its lumens go into the cone, so narrowing the cone makes the beam brighter. Off, it behaves like a bare bulb behind a mask: the beam keeps its brightness and the light outside the cone is lost.
  • Changing the unit in the editor converts Intensity, so the light looks the same.
  • Lights created from code default to Candela (point, spot) and Nits (area lights).

The light header in the inspector shows the output of the selected light in the other units, and warns about implausible values.

Colour temperature​

Light colour is set as a blackbody temperature in kelvin when UseColorTemperature is on (the default for new lights). The colours are white-balanced so that 6500 K (daylight, D65) renders white. Lower temperatures are warmer, higher ones cooler:

SourceKelvin
Candle flame1850
Sodium street light2100
Incandescent bulb, warm-white LED2700
Halogen lamp3000
Office fluorescent, neutral LED4000
Sun at noon on the ground5700
Sun above the atmosphere5900
Overcast daylight6500

The colour only sets the hue: it is normalised to luminance 1, so changing the colour never changes the brightness.

The camera has a matching white balance (White Balance group): WhiteBalanceKelvin (default 6500 K) is the temperature that renders as neutral white, WhiteBalanceTint shifts from green (−1) to magenta (+1). Setting it to 2700 K in a room lit by household bulbs makes the bulbs look white, as a phone camera would.

Exposure​

A physically lit scene spans a huge range: a moonlit field is a few thousandths of a nit, a sunlit wall thousands of nits. The camera's exposure maps that to the image. It is expressed as EV100, the exposure value at ISO 100; one EV more halves the brightness of the image. The exposure applied is 1 / (1.2 · 2^EV100): a surface of 1.2 · 2^EV100 nits reaches the tonemapper's white.

Each camera component has an Exposure group with three modes:

ExposureModeHow EV100 is chosen
Auto (default)Meters the rendered image and adapts towards it at AutoSpeedUp / AutoSpeedDown EV per second, within AutoMinEV100 (−4) and AutoMaxEV100 (18). AutoMetering picks Average, CenterWeighted or Spot metering. NightCurve keeps night scenes darker than day. Needs Rendering.PreExposure; without it the camera uses its Physical settings.
ManualManualEV100 (default 13).
PhysicalFrom the lens Aperture and the ShutterTime and ISO: EV100 = log2(N² / t · 100 / ISO). The defaults f/8, 1/125 s, ISO 100 give EV100 13.

ExposureCompensation adds stops in every mode (positive brightens). The read-only EV100 and FinalExposure show the exposure in use. See Camera Component for the lens and the other camera settings.

The editor viewports have their own Exposure menu in the toolbar: Scene Camera (the exposure of the scene's camera and the post-process volumes at the viewport), Auto (the default), Fixed EV 100 (set with the Fixed EV100 slider in the same menu) and Lock Current (keeps the current exposure). The menu also shows the Current EV100 and can turn on an Exposure Histogram. If the game camera looks right but the viewport is white or black, check this menu.

Viewport Exposure menu: Exposure Mode submenu with Scene Camera, Auto, Fixed EV 100 and Lock Current, the Fixed EV100 slider, the current EV100 and Exposure Histogram

Pre-exposure​

Daylight values exceed what 16-bit render targets store with precision. With Rendering.PreExposure on (the default), the renderer multiplies light by the view's expected exposure as it enters the scene colour, so both a moonlit night and a sunny day fit. Auto exposure requires it.

Emissive materials​

Emissive surfaces are set in luminance too. In the default material, the emitted luminance is EmissiveColor × EmissiveIntensity, and EmissiveUnit says what the intensity means: Nits, EV100 (nits = 2^(EV − 3), so 10 is 128 nits) or RelativeEV (stops relative to the view's exposure, for emitters that must read the same at any exposure). With EmissiveLighting on, emissive surfaces also light their surroundings in global illumination and ray-traced direct lighting. See Materials.

Setting up a scene​

Daylight exterior. Add a directional light with the defaults (110,000 lux, 5700 K). Add a sky light in Dynamic mode with both intensities at 1, and tag the sky with SkyLight. Leave the camera on Auto exposure, or use Manual with ManualEV100 15. A white surface in the noon sun then renders at a normal brightness.

Interior lamp. Add a point light; the editor creates it with 800 lm at 2700 K. Leave Range on Auto. Expose the camera for an interior: Auto, or Manual around EV100 5 to 7. To make the lamp's light look neutral, set the camera's WhiteBalanceKelvin to 2700 K.

Scene > Lighting > Apply Scenario sets the sun or moon, the sky, the cameras' exposure and white balance and the fog of a whole scene to a time of day or kind of place (clear noon, golden hour, overcast, blue hour, full-moon night, interior by daylight, interior at night, studio) as one undo step. Projects can add their own scenarios in Lighting/LightingScenarios.ddl.

Reference values​

Light sources​

SourceValue
Candle12 lm
Household bulb, 40 / 60 / 100 W incandescent equivalent450 / 800 / 1600 lm
Torch300 lm
Car headlight, halogen low beam1500 lm
Fluorescent tube, 1.2 m T83350 lm
LED panel, 600 × 600 mm3600 lm
LED street light10,000–20,000 lm
Sodium street light, 250 W28,000 lm
Stadium floodlight150,000 lm
Phone or monitor screen200–500 nits
Neon sign1000–5000 nits
Fluorescent tube surfaceabout 11,000 nits
Clear blue sky3000–10,000 nits

Illuminance​

SituationLux
Sun above the atmosphere128,000
Direct sun at noon100,000–110,000
Clear sky alone (shade)10,000–20,000
Overcast day1000–10,000
Office300–500
Living room50–150
Street at night5–20
Full moon0.1–0.3

Exposure​

SceneEV100
Bright sun on sand or snow16
Clear day, sunlit subject15
Overcast day12–13
Office interior7–8
Home interior at night5–6
Lit street at night3–4
Landscape under a full moon−3 to −2

Console variables​

CVarDefaultDescription
Rendering.PreExposuretrueWrites light pre-multiplied by the expected exposure. Required for Auto exposure and daylight values.
Rendering.Lighting.CutoffIlluminance0.5Lux at which lights with Range Auto end. Lower reaches further and costs more.
Rendering.Exposure.AutoCalibrationEV0Auto exposure only: shifts the metered EV100 by this many stops. Positive brightens.
Rendering.Exposure.LowPercentile10Percentage of the darkest pixels auto exposure ignores.
Rendering.Exposure.HighPercentile90Auto exposure ignores the pixels brighter than this percentile.
Rendering.Emissive.RelativeReferenceEV10010EV100 that RelativeEV emissive materials are measured against in ray-traced lighting, which has no single view exposure.

All of them are saved with the project.

Troubleshooting​

ProblemCause and fix
The scene is white after setting real sun values.The camera is exposed for a dim scene. Use Auto, or Manual with EV100 around 15.
The viewport is white or black while the game camera looks right.The viewport's Exposure menu is on Fixed EV 100 or Lock Current. Switch it to Scene Camera or Auto.
A camera in Auto mode does not adapt.Rendering.PreExposure is off; the camera uses its Physical settings.
Highlights or the sun show black or magenta pixels in daylight.16-bit overflow. Turn on Rendering.PreExposure.
A spot light gets brighter when its cone narrows.Reflector is on, as with a real reflector lamp. Turn it off to keep the beam's brightness.
Changing the light colour does not change the brightness.Colour is normalised to luminance 1. Change Intensity.
An area light gets dimmer when it is made larger.It is in lumens, which keep the total output. Switch IntensityUnit to Nits to keep the surface brightness.
Lights reach too far or cost too much.Raise Rendering.Lighting.CutoffIlluminance, or set Range explicitly.
An emissive sign disappears in daylight.Its nits are far below the scene. Raise EmissiveIntensity, or use RelativeEV for signs that must always read.

See Also​