Interface DepthOfFieldEffect

A DepthOfFieldEffect allows you to apply a Depth of Field effect on a 3D map.

Depth of Field is an effect that blurs out parts of your map, based on distance to the camera. This mimics the effect of a camera-wide aperture: objects you are focusing on are sharp, while the background is blurred.

Left: Depth of Field disabled, Right: Depth of Field enabled, with focus on the church

This implementation uses the GPU to calculate the effects of depth of field on-the-fly for your active view. You can toggle it on and off, as well as change any of its parameters at any time, with no additional overhead.

Depth of field has two main uses:

• Increase the visual quality of your map.
• Focus on a specific area of your map, so that it draws the attention of a user more effectively.

Depth of Field only has effect on 3D maps.

  map.effects.depthOfField = {
    focalDepth: 300,
    focusRange: 400
  }
Copy