Skip to main content

Cylinder Light Component

The cylinder light component (plCylinderLightComponent) adds a light that emits from the surface of a tube, such as a fluorescent tube, a neon tube or an LED light bar. Its specular highlights are long streaks along the tube, as on a real tube, instead of a point. It is more expensive than a point or spot light; see Area Lights for when it is worth it.

The tube is centred on its game object and runs along the object's local Y axis, Length long. It emits all around the tube, and from its two round ends when EndCaps is on. The defaults are a 1.2 m T8 fluorescent tube: 3350 lm at 4000 K, 26 mm thick.

Two cylinder lights, over a rough floor (left) and a mirror floor (right), where the tube's shape is reflected

Left: a rough floor (roughness 0.9) shows how the light spreads. Right: a mirror floor (roughness 0.02) shows the light's own shape in its reflection. Two identical lights at default intensity, one over each half, same exposure.

Component Properties​

The Color, Shading and Shadows groups are shared with the other lights; see Light Properties.

PropertyDefaultDescription
Temperature4000 KLight colour as a colour temperature, when UseColorTemperature is on.
IntensityUnitLumenLumen: total output, kept when the tube is resized. Nits: brightness of the tube's surface.
Intensity3350Brightness in the selected unit.
Radius0.013 mRadius of the tube, at least 0.001 m.
Length1.2 mLength of the tube along local Y, at least 0.01 m.
RangeAutoDistance at which the light ends. Auto computes it from the brightness of the tube seen side-on. See Range and falloff.
Falloff1Exponent of the distance falloff. 1 is physical.
EndCapsOnThe two ends of the tube emit as well. Adds their area to the emitting area, so in lumens the tube's surface gets slightly dimmer.

In lumens, the surface luminance is lm / (π · area), with the area of the tube's side (2πr · length) plus the ends. The default tube has a surface of about 10,800 nits and an automatic range of about 26 m. The light header shows these values for the selected light. Fixture preset includes Fluorescent tube, 1.2 m.

Shadows​

A cylinder light emits all around, but its shadow map covers only a cone of about 79° along the object's local −X axis. Objects on the other sides cast no shadow-map shadows. For a ceiling tube, rotate the object so that −X points down and its Y axis stays along the tube. Contact shadows and ray-traced direct lighting are not limited to that cone. See Area Lights.

Troubleshooting​

ProblemCause and fix
The tube is lit along the wrong axis.The tube runs along local Y. Rotate the object, not the light's Length.
Objects above or beside the tube cast no shadows.The shadow map only looks along local −X. Point −X at the area that needs shadows, or rely on contact shadows.
The tube is very bright up close but weak across the room.Expected for a thin emitter: brightness falls off with distance like any light. Check the readout in the light header against real values (an office of 300–500 lux needs several tubes).

See Also​