Merge e8d42c7 into 0265f68

docs/api-reference/deck.md

@@ -49,7 +49,42 @@ The array of deck.gl layers to be rendered. This array is expected to be an arra
 
 ##### `layerFilter` (Function)
 
-Optionally takes a function `({layer, viewport, isPicking}) => Boolean` that is called before a layer is rendered. Gives the application an opportunity to filter out layers from the layer list during either rendering or picking. Filtering can be done per viewport or per layer or both. This enables techniques like adding helper layers that work as masks during picking but do not show up during rendering. All the lifecycle methods are still triggered even a if a layer is filtered out using this prop.
+Default: `null`
+
+If supplied, will be called before a layer is drawn to determine whether it should be rendered. This gives the application an opportunity to filter out layers from the layer list during either rendering or picking. Filtering can be done per viewport or per layer or both. This enables techniques like adding helper layers that work as masks during picking but do not show up during rendering.
+
+```js
+new Deck({
+  // ...
+  layerFilter: ({layer, viewport}) => {
+    if (viewport.id !== 'minimap' && layer.id === 'geofence') {
+      // only display geofence in the minimap
+      return false;
+    }
+    return true;
+  }
+}
+```
+
+Notes:
+
+- `layerFilter` does not override the visibility defined by the layer's `visible` and `pickable` props.
+- All the lifecycle methods are still triggered even a if a layer is filtered out using this prop.
+
+Arguments:
+
+- `layer` (Layer) - the layer to be drawn
+- `viewport` (Viewport) - the current viewport
+- `isPicking` (Boolean) - whether this is a picking pass
+- `renderPass` (String) - the name of the current render pass. Some standard passes are:
+  + `'screen'` - drawing to screen
+  + `'picking:hover'` - drawing to offscreen picking buffer due to pointer move
+  + `'picking:query'` - drawing to offscreen picking buffer due to user-initiated query, e.g. calling `deck.pickObject`.
+  + `'shadow'` - drawing to shadow map
+
+Returns:
+
+`true` if the layer should be drawn.
 
 ##### `getCursor` (Function)
 

modules/core/src/passes/layers-pass.js

@@ -73,7 +73,7 @@ export default class LayersPass extends Pass {
     // render layers in normal colors
     layers.forEach((layer, layerIndex) => {
       // Check if we should draw layer
-      const shouldDrawLayer = this.shouldDrawLayer(layer, viewport, layerFilter);
+      const shouldDrawLayer = this.shouldDrawLayer(layer, viewport, layerFilter, pass);
 
       // Calculate stats
       if (shouldDrawLayer && layer.props.pickable) {
@@ -102,11 +102,11 @@ export default class LayersPass extends Pass {
     return renderStatus;
   }
 
-  shouldDrawLayer(layer, viewport, layerFilter) {
+  shouldDrawLayer(layer, viewport, layerFilter, pass) {
     let shouldDrawLayer = !layer.isComposite && layer.props.visible;
 
     if (shouldDrawLayer && layerFilter) {
-      shouldDrawLayer = layerFilter({layer, viewport, isPicking: false});
+      shouldDrawLayer = layerFilter({layer, viewport, isPicking: false, renderPass: pass});
     }
     return shouldDrawLayer;
   }

modules/core/src/passes/pick-layers-pass.js

@@ -64,7 +64,7 @@ export default class PickLayersPass extends LayersPass {
           layerFilter,
           viewports,
           onViewportActive,
-          pass: 'picking',
+          pass: `picking:${redrawReason}`,
           redrawReason,
           effectProps,
           parameters
@@ -74,13 +74,8 @@ export default class PickLayersPass extends LayersPass {
   }
 
   // PRIVATE
-  shouldDrawLayer(layer, viewport, layerFilter) {
-    let shouldDrawLayer = !layer.isComposite && layer.props.visible && layer.props.pickable;
-
-    if (shouldDrawLayer && layerFilter) {
-      shouldDrawLayer = layerFilter({layer, viewport, isPicking: true});
-    }
-    return shouldDrawLayer;
+  shouldDrawLayer(layer, viewport, layerFilter, pass) {
+    return layer.props.pickable && super.shouldDrawLayer(layer, viewport, layerFilter, pass);
   }
 
   getModuleParameters(layer, effects, effectProps) {

modules/core/src/passes/shadow-pass.js

@@ -61,7 +61,7 @@ export default class ShadowPass extends LayersPass {
           target.resize({width, height});
         }
 
-        super.render(Object.assign(params, {outputBuffer: target}));
+        super.render(Object.assign(params, {outputBuffer: target, pass: 'shadow'}));
       }
     );
   }