LightOptions interface
The options for the map's lighting.
- Extends
Properties
anchor | Specifies wether extruded geometries are lit relative to the map or viewport.
Supported values: |
color | Color tint for lighting extruded geometries.
Default: |
intensity | Intensity of lighting (on a scale from 0 to 1).
Higher numbers will present as more extreme contrast.
Default |
position | Position of the light source relative to lit (extruded) geometries,
in [r radial coordinate, a azimuthal angle, p polar angle]
where r indicates the distance from the center of the base of an object to its light,
a indicates the position of the light relative to 0°
(0° when |
Property Details
anchor
Specifies wether extruded geometries are lit relative to the map or viewport.
Supported values:
"map"
: The position of the light source is aligned to the rotation of the map.
"viewport"
: The position fo the light source is aligned to the rotation of the viewport.
Default: "map"
anchor?: "map" | "viewport"
Property Value
"map" | "viewport"
color
Color tint for lighting extruded geometries.
Default: "#FFFFFF"
color?: string | DataDrivenPropertyValueSpecification<string>
Property Value
string | DataDrivenPropertyValueSpecification<string>
intensity
Intensity of lighting (on a scale from 0 to 1).
Higher numbers will present as more extreme contrast.
Default 0.5
intensity?: number | DataDrivenPropertyValueSpecification<number>
Property Value
number | DataDrivenPropertyValueSpecification<number>
position
Position of the light source relative to lit (extruded) geometries,
in [r radial coordinate, a azimuthal angle, p polar angle]
where r indicates the distance from the center of the base of an object to its light,
a indicates the position of the light relative to 0°
(0° when anchor
is set to viewport corresponds to the top of the viewport,
or 0° when anchor
is set to map corresponds to due north, and degrees proceed clockwise),
and p indicates the height of the light (from 0°, directly above, to 180°, directly below).
position?: [number, number, number] | Expression
Property Value
[number, number, number] | Expression