Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface BloomEffect

A BloomEffect allows you to configure the bloom effect of shapes styled with a BloomStyle on a WebGLMap.

Bloom is a way to convey intense brightness to the viewer by adding a glow to the bright object. The light then bleeds around these bright areas. This creates the illusion that they are intensely bright. This effect can greatly add to the perceived realism of a scene. It can also for example be used to draw focus to certain shapes.

Bloom
Left: Using a color to highlight an area, Right: Using bloom to highlight an area

The BloomEffect uses 2 properties:

  • the strength property defines how intense the bloom should be.
  • the radius property determines whether the bloom is more focused (values close to 0) or more spread out (values close to 1).

Bloom only has an effect on WebGLMaps.

Example

  map.effects.bloom = {
    strength: 3,
    radius: 0
  };
since

2022.1

Hierarchy

  • BloomEffect

Overview

Properties

Optional radius

radius: number

The radius is a value between 0 and 1, inclusive, that determines how focused or spread out the bloom effect should be. Lower values produce a more concentrated bloom. Higher values produce a more diffuse bloom.

default

0.5

Optional strength

strength: number

The strength is a non-negative number to make the bloom effect more or less pronounced.

default

1

Optional threshold

threshold: number | null

The threshold is a non-negative number that, if set, will cause any pixel more bright than the threshold to bloom. This is in addition to all shapes styled with a BloomStyle. If threshold is not set or null, only the shapes styled with a BloomStyle will bloom.

A typical value is 1. In most cases only objects styled with PBR shading will produce sufficiently bright pixels.

default

null

Legend

  • Module
  • Object literal
  • Variable
  • Function
  • Function with type parameter
  • Index signature
  • Type alias
  • Type alias with type parameter
  • Enumeration
  • Enumeration member
  • Property
  • Method
  • Interface
  • Interface with type parameter
  • Constructor
  • Property
  • Method
  • Index signature
  • Class
  • Class with type parameter
  • Constructor
  • Property
  • Method
  • Accessor
  • Index signature
  • Inherited constructor
  • Inherited property
  • Inherited method
  • Inherited accessor
  • Protected property
  • Protected method
  • Protected accessor
  • Private property
  • Private method
  • Private accessor
  • Static property
  • Static method