FillExtrusionLayerState

The state holder for FillExtrusionLayer's layer properties.

See also

Constructors

Link copied to clipboard

Properties

Provides a control to futher fine-tune the look of the ambient occlusion on the ground beneath the extruded buildings. Lower values give the effect a more solid look while higher values make it smoother. Default value: 0.69. Value range: 0, 1

The extent of the ambient occlusion effect on the ground beneath the extruded buildings in meters. Default value: 3. Minimum value: 0.

Link copied to clipboard

Controls the intensity of shading near ground and concave angles between walls. Default value 0.0 disables ambient occlusion and values around 0.3 provide the most plausible results for buildings. Default value: 0. Value range: 0, 1

Defines the transition of fillExtrusionAmbientOcclusionIntensity. Default value: 0. Value range: 0, 1

Link copied to clipboard

Shades area near ground and concave angles between walls where the radius defines only vertical impact. Default value 3.0 corresponds to height of one floor and brings the most plausible results for buildings. This property works only with legacy light. When 3D lights are enabled fill-extrusion-ambient-occlusion-wall-radius and fill-extrusion-ambient-occlusion-ground-radius are used instead. Default value: 3. Minimum value: 0.

Defines the transition of fillExtrusionAmbientOcclusionRadius. Default value: 3. Minimum value: 0.

Link copied to clipboard

Shades area near ground and concave angles between walls where the radius defines only vertical impact. Default value 3.0 corresponds to height of one floor and brings the most plausible results for buildings. Default value: 3. Minimum value: 0.

Link copied to clipboard

The height with which to extrude the base of this layer. Must be less than or equal to fill-extrusion-height. Default value: 0. Minimum value: 0.

Link copied to clipboard

Defines the transition of fillExtrusionBase. Default value: 0. Minimum value: 0.

Link copied to clipboard

The base color of the extruded fill. The extrusion's surfaces will be shaded differently based on this color in combination with the root light settings. If this color is specified as rgba with an alpha component, the alpha component will be ignored; use fill-extrusion-opacity to set layer opacity. Default value: "#000000".

Link copied to clipboard

Defines the transition of fillExtrusionColor. Default value: "#000000".

Link copied to clipboard

This parameter defines the range for the fade-out effect before an automatic content cutoff on pitched map views. Fade out is implemented by scaling down and removing buildings in the fade range in a staggered fashion. Opacity is not changed. The fade range is expressed in relation to the height of the map view. A value of 1.0 indicates that the content is faded to the same extent as the map's height in pixels, while a value close to zero represents a sharp cutoff. When the value is set to 0.0, the cutoff is completely disabled. Note: The property has no effect on the map if terrain is enabled. Default value: 0. Value range: 0, 1

Link copied to clipboard

Radius of a fill extrusion edge in meters. If not zero, rounds extrusion edges for a smoother appearance. Default value: 0. Value range: 0, 1

Link copied to clipboard

Controls the intensity of light emitted on the source features. Default value: 0. Minimum value: 0.

Link copied to clipboard

Defines the transition of fillExtrusionEmissiveStrength. Default value: 0. Minimum value: 0.

Link copied to clipboard

The color of the flood light effect on the walls of the extruded buildings. Default value: "#ffffff".

Link copied to clipboard
Link copied to clipboard

Provides a control to futher fine-tune the look of the flood light on the ground beneath the extruded buildings. Lower values give the effect a more solid look while higher values make it smoother. Default value: 0.69. Value range: 0, 1

Link copied to clipboard

The extent of the flood light effect on the ground beneath the extruded buildings in meters. Note: this experimental property is evaluated once per tile, during tile initialization. Changing the property value could trigger tile reload. The feature-state styling is deprecated and will get removed soon. Default value: 0.

Link copied to clipboard

The intensity of the flood light color. Default value: 0. Value range: 0, 1

Defines the transition of fillExtrusionFloodLightIntensity. Default value: 0. Value range: 0, 1

Link copied to clipboard

The extent of the flood light effect on the walls of the extruded buildings in meters. Default value: 0. Minimum value: 0.

Defines the transition of fillExtrusionFloodLightWallRadius. Default value: 0. Minimum value: 0.

Link copied to clipboard

The height with which to extrude this layer. Default value: 0. Minimum value: 0.

Link copied to clipboard

Defines the transition of fillExtrusionHeight. Default value: 0. Minimum value: 0.

Link copied to clipboard

The opacity of the entire fill extrusion layer. This is rendered on a per-layer, not per-feature, basis, and data-driven styling is not available. Default value: 1. Value range: 0, 1

Link copied to clipboard

Defines the transition of fillExtrusionOpacity. Default value: 1. Value range: 0, 1

Link copied to clipboard

Name of image in sprite to use for drawing images on extruded fills. For seamless patterns, image width and height must be a factor of two (2, 4, 8, ..., 512). Note that zoom-dependent expressions will be evaluated only at integer zoom levels.

Link copied to clipboard

Indicates whether top edges should be rounded when fill-extrusion-edge-radius has a value greater than 0. If false, rounded edges are only applied to the sides. Default is true. Default value: true.

Link copied to clipboard

The geometry's offset. Values are x, y where negatives indicate left and up (on the flat plane), respectively. Default value: 0,0.

Link copied to clipboard

Controls the frame of reference for fill-extrusion-translate. Default value: "map".

Link copied to clipboard

Defines the transition of fillExtrusionTranslate. Default value: 0,0.

Link copied to clipboard

Whether to apply a vertical gradient to the sides of a fill-extrusion layer. If true, sides will be shaded slightly darker farther down. Default value: true.

Link copied to clipboard

A global multiplier that can be used to scale base, height, AO, and flood light of the fill extrusions. Default value: 1. Minimum value: 0.

Link copied to clipboard

Defines the transition of fillExtrusionVerticalScale. Default value: 1. Minimum value: 0.

Link copied to clipboard

An expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The ["feature-state", ...] expression is not supported in filter expressions. The ["pitch"] and ["distance-from-center"] expressions are supported only for filter expressions on the symbol layer.

Link copied to clipboard

The maximum zoom level for the layer. At zoom levels equal to or greater than the maxzoom, the layer will be hidden. Value range: 0, 24

Link copied to clipboard

The minimum zoom level for the layer. At zoom levels less than the minzoom, the layer will be hidden. Value range: 0, 24

Link copied to clipboard

Layer to use from a vector tile source. Required for vector tile sources; prohibited for all other source types, including GeoJSON sources.

Link copied to clipboard

Whether this layer is displayed. Default value: "visible".