Skip to content

SurfaceLight

Supported Class GUI

A light source that emits illumination of a specified color and brightness from a face for a specified range.

Description

A SurfaceLight is a light source that emits illumination of a specified Light.Color and Light.Brightness from a SurfaceLight.Face for a specified SurfaceLight.Range.

In order for a SurfaceLight to provide illumination, it must be the direct child of a BasePart or Attachment (the part or attachment itself must be a descendant of the Workspace). If a SurfaceLight is parented to a part, then the light will emanate from the part's selected face(s). If parented to an attachment SurfaceLight is equivalent to a SpotLight.

For more light types, please see the see also section.

See Also

Inheritance

Object → Instance → Light → SurfaceLight

Nova inheritance: Instance → Light → SurfaceLight

Properties

Angle Supported Property The angle of which the light is shone from the SurfaceLight.
Angle: float

The angle of which the light is shone from the SurfaceLight.

Roblox documentation

Face Supported Property Sets the side of the parent that the SurfaceLight comes from.
Face: NormalId

Sets the side of the parent that the SurfaceLight comes from.

Roblox documentation

Range Supported Property The distance from the SurfaceLight's face that will illuminate.
Range: float

The distance from the SurfaceLight's face that will illuminate.

Roblox documentation

Inherited members

Inherited from Light: 12 properties, 36 methods, 7 events. They are documented on the base class page.

Roblox reference: SurfaceLight

Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.