third_party/WebKit/Source/platform/graphics/GraphicsLayer.h

/*
 * Copyright (C) 2009 Apple Inc. All rights reserved.
 * Copyright (C) 2013 Intel Corporation. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef GraphicsLayer_h
#define GraphicsLayer_h

#include "cc/layers/layer_client.h"
#include "platform/PlatformExport.h"
#include "platform/geometry/FloatPoint.h"
#include "platform/geometry/FloatPoint3D.h"
#include "platform/geometry/FloatSize.h"
#include "platform/geometry/IntRect.h"
#include "platform/graphics/Color.h"
#include "platform/graphics/CompositorElementId.h"
#include "platform/graphics/ContentLayerDelegate.h"
#include "platform/graphics/GraphicsContext.h"
#include "platform/graphics/GraphicsLayerClient.h"
#include "platform/graphics/GraphicsLayerDebugInfo.h"
#include "platform/graphics/ImageOrientation.h"
#include "platform/graphics/PaintInvalidationReason.h"
#include "platform/graphics/paint/DisplayItemClient.h"
#include "platform/graphics/paint/PaintController.h"
#include "platform/heap/Handle.h"
#include "platform/transforms/TransformationMatrix.h"
#include "public/platform/WebContentLayer.h"
#include "public/platform/WebImageLayer.h"
#include "public/platform/WebLayerScrollClient.h"
#include "public/platform/WebLayerStickyPositionConstraint.h"
#include "third_party/skia/include/core/SkFilterQuality.h"
#include "third_party/skia/include/core/SkRefCnt.h"
#include "wtf/Vector.h"
#include <memory>

namespace blink {

class CompositorFilterOperations;
class Image;
class JSONObject;
class LinkHighlight;
class PaintController;
struct RasterInvalidationTracking;
class ScrollableArea;
class WebLayer;

typedef Vector<GraphicsLayer*, 64> GraphicsLayerVector;

// GraphicsLayer is an abstraction for a rendering surface with backing store,
// which may have associated transformation and animations.

class PLATFORM_EXPORT GraphicsLayer : public WebLayerScrollClient,
                                      public cc::LayerClient,
                                      public DisplayItemClient {
  WTF_MAKE_NONCOPYABLE(GraphicsLayer);
  USING_FAST_MALLOC(GraphicsLayer);

 public:
  static std::unique_ptr<GraphicsLayer> create(GraphicsLayerClient*);

  ~GraphicsLayer() override;

  GraphicsLayerClient* client() const { return m_client; }

  GraphicsLayerDebugInfo& debugInfo();

  void setCompositingReasons(CompositingReasons);
  CompositingReasons getCompositingReasons() const {
    return m_debugInfo.getCompositingReasons();
  }
  void setSquashingDisallowedReasons(SquashingDisallowedReasons);
  void setOwnerNodeId(int);

  GraphicsLayer* parent() const { return m_parent; }
  void setParent(GraphicsLayer*);  // Internal use only.

  const Vector<GraphicsLayer*>& children() const { return m_children; }
  // Returns true if the child list changed.
  bool setChildren(const GraphicsLayerVector&);

  // Add child layers. If the child is already parented, it will be removed from
  // its old parent.
  void addChild(GraphicsLayer*);
  void addChildBelow(GraphicsLayer*, GraphicsLayer* sibling);

  void removeAllChildren();
  void removeFromParent();

  GraphicsLayer* maskLayer() const { return m_maskLayer; }
  void setMaskLayer(GraphicsLayer*);

  GraphicsLayer* contentsClippingMaskLayer() const {
    return m_contentsClippingMaskLayer;
  }
  void setContentsClippingMaskLayer(GraphicsLayer*);

  enum ShouldSetNeedsDisplay { DontSetNeedsDisplay, SetNeedsDisplay };

  // The offset is the origin of the layoutObject minus the origin of the
  // graphics layer (so either zero or negative).
  IntSize offsetFromLayoutObject() const {
    return flooredIntSize(m_offsetFromLayoutObject);
  }
  void setOffsetFromLayoutObject(const IntSize&,
                                 ShouldSetNeedsDisplay = SetNeedsDisplay);
  LayoutSize offsetFromLayoutObjectWithSubpixelAccumulation() const;

  // The double version is only used in updateScrollingLayerGeometry() for
  // detecting a scroll offset change at floating point precision.
  DoubleSize offsetDoubleFromLayoutObject() const {
    return m_offsetFromLayoutObject;
  }
  void setOffsetDoubleFromLayoutObject(const DoubleSize&,
                                       ShouldSetNeedsDisplay = SetNeedsDisplay);

  // The position of the layer (the location of its top-left corner in its
  // parent).
  const FloatPoint& position() const { return m_position; }
  void setPosition(const FloatPoint&);

  const FloatPoint3D& transformOrigin() const { return m_transformOrigin; }
  void setTransformOrigin(const FloatPoint3D&);

  // The size of the layer.
  const FloatSize& size() const { return m_size; }
  void setSize(const FloatSize&);

  const TransformationMatrix& transform() const { return m_transform; }
  void setTransform(const TransformationMatrix&);
  void setShouldFlattenTransform(bool);
  void setRenderingContext(int id);

  bool masksToBounds() const;
  void setMasksToBounds(bool);

  bool drawsContent() const { return m_drawsContent; }
  void setDrawsContent(bool);

  bool contentsAreVisible() const { return m_contentsVisible; }
  void setContentsVisible(bool);

  void setScrollParent(WebLayer*);
  void setClipParent(WebLayer*);

  // For special cases, e.g. drawing missing tiles on Android.
  // The compositor should never paint this color in normal cases because the
  // Layer will paint the background by itself.
  void setBackgroundColor(const Color&);

  // opaque means that we know the layer contents have no alpha
  bool contentsOpaque() const { return m_contentsOpaque; }
  void setContentsOpaque(bool);

  bool backfaceVisibility() const { return m_backfaceVisibility; }
  void setBackfaceVisibility(bool visible);

  float opacity() const { return m_opacity; }
  void setOpacity(float);

  void setBlendMode(WebBlendMode);
  void setIsRootForIsolatedGroup(bool);

  void setFilters(CompositorFilterOperations);
  void setBackdropFilters(CompositorFilterOperations);

  void setStickyPositionConstraint(const WebLayerStickyPositionConstraint&);

  void setFilterQuality(SkFilterQuality);

  // Some GraphicsLayers paint only the foreground or the background content
  GraphicsLayerPaintingPhase paintingPhase() const { return m_paintingPhase; }
  void setPaintingPhase(GraphicsLayerPaintingPhase);

  void setNeedsDisplay();
  // Mark the given rect (in layer coords) as needing display. Never goes deep.
  void setNeedsDisplayInRect(const IntRect&,
                             PaintInvalidationReason,
                             const DisplayItemClient&);

  void setContentsNeedsDisplay();

  // Set that the position/size of the contents (image or video).
  void setContentsRect(const IntRect&);

  // Layer contents
  void setContentsToImage(
      Image*,
      RespectImageOrientationEnum = DoNotRespectImageOrientation);
  void setContentsToPlatformLayer(WebLayer* layer) { setContentsTo(layer); }
  bool hasContentsLayer() const { return m_contentsLayer; }

  // For hosting this GraphicsLayer in a native layer hierarchy.
  WebLayer* platformLayer() const;

  int paintCount() const { return m_paintCount; }

  // Return a string with a human readable form of the layer tree. If debug is
  // true, pointers for the layers and timing data will be included in the
  // returned string.
  String layerTreeAsText(LayerTreeFlags = LayerTreeNormal) const;

  std::unique_ptr<JSONObject> layerTreeAsJSON(LayerTreeFlags) const;

  void setTracksRasterInvalidations(bool);
  bool isTrackingOrCheckingRasterInvalidations() const {
    return RuntimeEnabledFeatures::paintUnderInvalidationCheckingEnabled() ||
           m_isTrackingRasterInvalidations;
  }

  void resetTrackedRasterInvalidations();
  bool hasTrackedRasterInvalidations() const;
  const RasterInvalidationTracking* getRasterInvalidationTracking() const;
  void trackRasterInvalidation(const DisplayItemClient&,
                               const IntRect&,
                               PaintInvalidationReason);

  void addLinkHighlight(LinkHighlight*);
  void removeLinkHighlight(LinkHighlight*);
  // Exposed for tests
  unsigned numLinkHighlights() { return m_linkHighlights.size(); }
  LinkHighlight* getLinkHighlight(int i) { return m_linkHighlights[i]; }

  void setScrollableArea(ScrollableArea*, bool isVisualViewport);
  ScrollableArea* getScrollableArea() const { return m_scrollableArea; }

  WebContentLayer* contentLayer() const { return m_layer.get(); }

  static void registerContentsLayer(WebLayer*);
  static void unregisterContentsLayer(WebLayer*);

  IntRect interestRect();
  void paint(const IntRect* interestRect,
             GraphicsContext::DisabledMode = GraphicsContext::NothingDisabled);

  // WebLayerScrollClient implementation.
  void didScroll() override;

  // cc::LayerClient implementation.
  std::unique_ptr<base::trace_event::ConvertableToTraceFormat> TakeDebugInfo(
      cc::Layer*) override;
  void didUpdateMainThreadScrollingReasons() override;
  void didChangeScrollbarsHidden(bool);

  PaintController& getPaintController();

  // Exposed for tests.
  WebLayer* contentsLayer() const { return m_contentsLayer; }

  void setElementId(const CompositorElementId&);
  CompositorElementId elementId() const;

  void setCompositorMutableProperties(uint32_t);

  ContentLayerDelegate* contentLayerDelegateForTesting() const {
    return m_contentLayerDelegate.get();
  }

  // DisplayItemClient methods
  String debugName() const final { return m_client->debugName(this); }
  LayoutRect visualRect() const override;

  void setHasWillChangeTransformHint(bool);

  // See comments in cc::Layer::SetPreferredRasterBounds.
  void setPreferredRasterBounds(const IntSize&);
  void clearPreferredRasterBounds();

 protected:
  String debugName(cc::Layer*) const;
  bool shouldFlattenTransform() const { return m_shouldFlattenTransform; }

  explicit GraphicsLayer(GraphicsLayerClient*);
  // for testing
  friend class CompositedLayerMappingTest;
  friend class PaintControllerPaintTestBase;

 private:
  // Returns true if PaintController::paintArtifact() changed and needs commit.
  bool paintWithoutCommit(
      const IntRect* interestRect,
      GraphicsContext::DisabledMode = GraphicsContext::NothingDisabled);

  // Adds a child without calling updateChildList(), so that adding children
  // can be batched before updating.
  void addChildInternal(GraphicsLayer*);

#if ENABLE(ASSERT)
  bool hasAncestor(GraphicsLayer*) const;
#endif

  void incrementPaintCount() { ++m_paintCount; }

  void notifyFirstPaintToClient();

  // Helper functions used by settors to keep layer's the state consistent.
  void updateChildList();
  void updateLayerIsDrawable();
  void updateContentsRect();

  void setContentsTo(WebLayer*);
  void setupContentsLayer(WebLayer*);
  void clearContentsLayerIfUnregistered();
  WebLayer* contentsLayerIfRegistered();

  typedef HashMap<int, int> RenderingContextMap;
  std::unique_ptr<JSONObject> layerTreeAsJSONInternal(
      LayerTreeFlags,
      RenderingContextMap&) const;
  // Outputs the layer tree rooted at |this| as a JSON array, in paint order.
  void layersAsJSONArray(LayerTreeFlags,
                         RenderingContextMap&,
                         JSONArray*) const;
  std::unique_ptr<JSONObject> layerAsJSONInternal(LayerTreeFlags,
                                                  RenderingContextMap&) const;

  sk_sp<SkPicture> capturePicture();
  void checkPaintUnderInvalidations(const SkPicture&);

  GraphicsLayerClient* m_client;

  // Offset from the owning layoutObject
  DoubleSize m_offsetFromLayoutObject;

  // Position is relative to the parent GraphicsLayer
  FloatPoint m_position;
  FloatSize m_size;

  TransformationMatrix m_transform;
  FloatPoint3D m_transformOrigin;

  Color m_backgroundColor;
  float m_opacity;

  WebBlendMode m_blendMode;

  bool m_hasTransformOrigin : 1;
  bool m_contentsOpaque : 1;
  bool m_shouldFlattenTransform : 1;
  bool m_backfaceVisibility : 1;
  bool m_drawsContent : 1;
  bool m_contentsVisible : 1;
  bool m_isRootForIsolatedGroup : 1;

  bool m_hasScrollParent : 1;
  bool m_hasClipParent : 1;

  bool m_painted : 1;

  bool m_isTrackingRasterInvalidations : 1;

  GraphicsLayerPaintingPhase m_paintingPhase;

  Vector<GraphicsLayer*> m_children;
  GraphicsLayer* m_parent;

  GraphicsLayer* m_maskLayer;  // Reference to mask layer. We don't own this.
  GraphicsLayer* m_contentsClippingMaskLayer;  // Reference to clipping mask
                                               // layer. We don't own this.

  IntRect m_contentsRect;

  int m_paintCount;

  std::unique_ptr<WebContentLayer> m_layer;
  std::unique_ptr<WebImageLayer> m_imageLayer;
  WebLayer* m_contentsLayer;
  // We don't have ownership of m_contentsLayer, but we do want to know if a
  // given layer is the same as our current layer in setContentsTo(). Since
  // |m_contentsLayer| may be deleted at this point, we stash an ID away when we
  // know |m_contentsLayer| is alive and use that for comparisons from that
  // point on.
  int m_contentsLayerId;

  Vector<LinkHighlight*> m_linkHighlights;

  std::unique_ptr<ContentLayerDelegate> m_contentLayerDelegate;

  WeakPersistent<ScrollableArea> m_scrollableArea;
  GraphicsLayerDebugInfo m_debugInfo;
  int m_renderingContext3d;

  std::unique_ptr<PaintController> m_paintController;

  IntRect m_previousInterestRect;
  IntSize m_preferredRasterBounds;
  bool m_hasPreferredRasterBounds;
};

}  // namespace blink

#ifndef NDEBUG
// Outside the blink namespace for ease of invocation from gdb.
void PLATFORM_EXPORT showGraphicsLayerTree(const blink::GraphicsLayer*);
#endif

#endif  // GraphicsLayer_h