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

   1 /*
   2  * Copyright (C) 2009 Apple Inc. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  * 1. Redistributions of source code must retain the above copyright
   8  *    notice, this list of conditions and the following disclaimer.
   9  * 2. Redistributions in binary form must reproduce the above copyright
  10  *    notice, this list of conditions and the following disclaimer in the
  11  *    documentation and/or other materials provided with the distribution.
  12  *
  13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
  14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
  17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24  */
  25
  26 #ifndef GraphicsLayerClient_h
  27 #define GraphicsLayerClient_h
  28
  29 #include "platform/PlatformExport.h"
  30 #include "wtf/text/WTFString.h"
  31
  32 namespace blink {
  33
  34 class GraphicsContext;
  35 class GraphicsLayer;
  36 class IntRect;
  37
  38 enum GraphicsLayerPaintingPhaseFlags {
  39     GraphicsLayerPaintBackground = (1 << 0),
  40     GraphicsLayerPaintForeground = (1 << 1),
  41     GraphicsLayerPaintMask = (1 << 2),
  42     GraphicsLayerPaintOverflowContents = (1 << 3),
  43     GraphicsLayerPaintCompositedScroll = (1 << 4),
  44     GraphicsLayerPaintChildClippingMask = (1 << 5),
  45     GraphicsLayerPaintAllWithOverflowClip = (GraphicsLayerPaintBackground | GraphicsLayerPaintForeground | GraphicsLayerPaintMask)
  46 };
  47 typedef unsigned GraphicsLayerPaintingPhase;
  48
  49 enum {
  50     LayerTreeNormal = 0,
  51     LayerTreeIncludesDebugInfo = 1 << 0, // Dump extra debugging info like layer addresses.
  52     LayerTreeIncludesPaintInvalidationRects = 1 << 1,
  53     LayerTreeIncludesPaintingPhases = 1 << 2,
  54     LayerTreeIncludesRootLayer = 1 << 3,
  55     LayerTreeIncludesClipAndScrollParents = 1 << 4,
  56     LayerTreeIncludesPaintInvalidationObjects = 1 << 5,
  57     LayerTreeIncludesCompositingReasons = 1 << 6,
  58 };
  59 typedef unsigned LayerTreeFlags;
  60
  61 class PLATFORM_EXPORT GraphicsLayerClient {
  62 public:
  63     virtual ~GraphicsLayerClient() {}
  64
  65     // Callback for when compositor animation started.
  66     virtual void notifyAnimationStarted(const GraphicsLayer*, double monotonicTime, int group) { }
  67
  68     virtual void paintContents(const GraphicsLayer*, GraphicsContext&, GraphicsLayerPaintingPhase, const IntRect& inClip) = 0;
  69     virtual bool isTrackingPaintInvalidations() const { return false; }
  70
  71     virtual String debugName(const GraphicsLayer*) = 0;
  72
  73 #if ENABLE(ASSERT)
  74     // CompositedLayerMapping overrides this to verify that it is not
  75     // currently painting contents. An ASSERT fails, if it is.
  76     // This is executed in GraphicsLayer construction and destruction
  77     // to verify that we don't create or destroy GraphicsLayers
  78     // while painting.
  79     virtual void verifyNotPainting() { }
  80 #endif
  81 };
  82
  83 } // namespace blink
  84
  85 #endif // GraphicsLayerClient_h