This is the documentation of version 0.63.0. Go to the latest version, 1.0.0-rc.5.

Grade, tint, fog, edge blur and vignette

Five of the map effects plugin's effects are overlays laid over the map: grade and tint mute the base map so your data reads first, fog and edge blur give the rim of the view depth or focus, and vignette darkens or lightens the edges. Each is off by default. The playground below puts them on one panel with the other effects:

Muting the base map: grade and tint

grade sets the brightness, contrast and saturation of the whole frame, and tint lays a colour over it. Together they quiet the base map under your own data layers — the visual half of the data-viz styling preset, which quiets the map's content:

effects.updateConfig({ 'grade.saturation': 0.4, 'grade.brightness': 0.85, 'tint.opacity': 0.15 });

Fog or edge blur?

Both blur the rim of the view and both take a reach, so they are easy to confuse. The difference is what happens to the rim's colour:

Use fog for depth, edge blur for focus. Together they compound, which is rarely what you want.

effects.updateConfig({ 'fog.intensity': 0.6, 'fog.reach': 0.4 });

Vignette

vignette.intensity darkens the edges of the frame when negative and lightens them when positive, and vignette.reach sets how far in it reaches:

setKnob(effects, effectKnobCatalogue, 'vignette.intensity', -0.5);

The knobs

Knob Range Default
grade.brightness, grade.contrast 0.5–1.5 1
grade.saturation 0–1.5 1
tint.color, tint.opacity colour, 0–1 #1f2937, 0 (off)
fog.intensity, fog.reach 0–1 0 (off), 0.4
edgeBlur.intensity (CSS px), edgeBlur.reach 0–30, 0–1 0 (off), 0.5
vignette.intensity (negative darkens, positive lightens), vignette.reach −1–1, 0–1 0 (off), 0.45

How they render

The overlays stack over the result of the GPU chain: backdrop-filter for grade, fog and edge blur, a gradient for vignette, a flat layer for tint. They are CSS, so they need no redrawing as the map moves and need no readable map canvas. They never take pointer events and sit below the map's controls. The overview shows where they sit relative to bloom and the GPU chain.

Related guides and examples

Related guides

Related examples