| title | description |
|---|---|
Light sources |
Light sources simulate realistic lighting from objects such as torches, spotlights, and screens. |
Local light sources simulate realistic lighting from objects such as
lamps, torches, spotlights, and TV screens. By using the different types of
light sources instead of just general global lighting through the Class.Lighting
service, you can create immersive environments such as cyberpunk cities,
traditional light festivals, and moody detective scenes.
Local light sources include PointLight, SpotLight, and SurfaceLight. Each shares various properties from the Class.Light class, including Class.Light.Color|Color, Class.Light.Brightness|Brightness, and Class.Light.Shadows|Shadows.
A Class.PointLight emits light spherically from a single point. This object is ideal for non-directional lights like bulbs, torches, and fireballs.
To create a point light in Studio, insert a Class.PointLight into an Class.Attachment or a Class.BasePart (Class.Attachment is recommended for point‑specific light emission). Then adjust the object's Class.PointLight.Range|Range as well as shared properties like Class.PointLight.Brightness|Brightness and Class.PointLight.Color|Color.
A point light's Class.PointLight.Range|Range property defines the radial distance of illumination from the light's position, measured in studs.
A Class.SpotLight emits light in the shape of a cone with a spherical base. This object is ideal for directional lights like street lamps, flashlights, and headlights.
To create a spotlight in Studio, insert a Class.SpotLight into an Class.Attachment or a Class.BasePart and set its Class.SpotLight.Face|Face property to specify which direction light emits from. Then adjust the Class.SpotLight.Angle|Angle and Class.SpotLight.Range|Range, as well as shared properties like Class.SpotLight.Brightness|Brightness and Class.SpotLight.Color|Color.
A spotlight's Class.SpotLight.Face|Face property determines which face/axis light emits from, as shown from the following streetlamp's glowing light part:
A spotlight's Class.SpotLight.Angle|Angle property defines the angle of light emission from the cone's apex. The maximum value is 180 which illuminates a full half sphere from the apex.
A Class.SurfaceLight emits light from the face of a Class.BasePart. This object is ideal for lighting from computer screens, billboards, signs, and fluorescent panels.
To create a surface light in Studio, insert a Class.SurfaceLight into a Class.BasePart and set its Class.SurfaceLight.Face|Face property to specify which surface light emits from. Then adjust the Class.SurfaceLight.Angle|Angle and Class.SurfaceLight.Range|Range, as well as shared properties like Class.SurfaceLight.Brightness|Brightness and Class.SurfaceLight.Color|Color.
A surface light's Class.SurfaceLight.Face|Face property determines the face of the Class.BasePart from which light emanates. Notice that light emits from the entire surface, not just a point on the surface.
A surface light's Class.SurfaceLight.Angle|Angle property defines the angle of light emission from the part's surface. An angle of 0 means that light travels directly outward from the surface while an angle of 180 means light travels outward perpendicular to the surface.
All light sources share various properties from the Class.Light class, including color, brightness, and shadows.
The Class.Light.Color|Color property sets the Datatype.Color3 value of the emitted light.
The Class.Light.Brightness|Brightness property sets the light's brightness with maximum effect at the center of the light. Note that Class.Light.Brightness|Brightness is still limited to the light's defined range, so a higher Class.Light.Brightness|Brightness value doesn't light up a larger region around the light.
The Class.Light.Shadows|Shadows property projects shadows where light is blocked by an obstacle.
