Index: cc/occlusion_tracker.h |
diff --git a/cc/occlusion_tracker.h b/cc/occlusion_tracker.h |
index 638cbb270ce9b24689d5095baf174ade4f4d1a13..c2526cdc38eb04639c92ab76a344a2d4b60137e4 100644 |
--- a/cc/occlusion_tracker.h |
+++ b/cc/occlusion_tracker.h |
@@ -1,3 +1,105 @@ |
// Copyright 2012 The Chromium Authors. All rights reserved. |
// Use of this source code is governed by a BSD-style license that can be |
// found in the LICENSE file. |
+ |
+#ifndef CCOcclusionTracker_h |
+#define CCOcclusionTracker_h |
+ |
+#include "base/basictypes.h" |
+#include "CCLayerIterator.h" |
+#include "FloatQuad.h" |
+#include "Region.h" |
+ |
+namespace cc { |
+class CCOverdrawMetrics; |
+class CCLayerImpl; |
+class CCRenderSurface; |
+class LayerChromium; |
+class RenderSurfaceChromium; |
+ |
+// This class is used to track occlusion of layers while traversing them in a front-to-back order. As each layer is visited, one of the |
+// methods in this class is called to notify it about the current target surface. |
+// Then, occlusion in the content space of the current layer may be queried, via methods such as occluded() and unoccludedContentRect(). |
+// If the current layer owns a RenderSurface, then occlusion on that RenderSurface may also be queried via surfaceOccluded() and surfaceUnoccludedContentRect(). |
+// Finally, once finished with the layer, occlusion behind the layer should be marked by calling markOccludedBehindLayer(). |
+template<typename LayerType, typename RenderSurfaceType> |
+class CCOcclusionTrackerBase { |
+public: |
+ CCOcclusionTrackerBase(IntRect rootTargetRect, bool recordMetricsForFrame); |
+ |
+ // Called at the beginning of each step in the CCLayerIterator's front-to-back traversal. |
+ void enterLayer(const CCLayerIteratorPosition<LayerType>&); |
+ // Called at the end of each step in the CCLayerIterator's front-to-back traversal. |
+ void leaveLayer(const CCLayerIteratorPosition<LayerType>&); |
+ |
+ // Returns true if the given rect in content space for the layer is fully occluded in either screen space or the layer's target surface. |
+ bool occluded(const LayerType*, const IntRect& contentRect, bool* hasOcclusionFromOutsideTargetSurface = 0) const; |
+ // Gives an unoccluded sub-rect of |contentRect| in the content space of the layer. Used when considering occlusion for a layer that paints/draws something. |
+ IntRect unoccludedContentRect(const LayerType*, const IntRect& contentRect, bool* hasOcclusionFromOutsideTargetSurface = 0) const; |
+ |
+ // Gives an unoccluded sub-rect of |contentRect| in the content space of the renderTarget owned by the layer. |
+ // Used when considering occlusion for a contributing surface that is rendering into another target. |
+ IntRect unoccludedContributingSurfaceContentRect(const LayerType*, bool forReplica, const IntRect& contentRect, bool* hasOcclusionFromOutsideTargetSurface = 0) const; |
+ |
+ // Report operations for recording overdraw metrics. |
+ CCOverdrawMetrics& overdrawMetrics() const { return *m_overdrawMetrics.get(); } |
+ |
+ // Gives the region of the screen that is not occluded by something opaque. |
+ Region computeVisibleRegionInScreen() const { return subtract(Region(m_rootTargetRect), m_stack.last().occlusionInScreen); } |
+ |
+ void setMinimumTrackingSize(const IntSize& size) { m_minimumTrackingSize = size; } |
+ |
+ // The following is used for visualization purposes. |
+ void setOccludingScreenSpaceRectsContainer(Vector<IntRect>* rects) { m_occludingScreenSpaceRects = rects; } |
+ |
+protected: |
+ struct StackObject { |
+ StackObject() : target(0) { } |
+ StackObject(const LayerType* target) : target(target) { } |
+ const LayerType* target; |
+ Region occlusionInScreen; |
+ Region occlusionInTarget; |
+ }; |
+ |
+ // The stack holds occluded regions for subtrees in the RenderSurface-Layer tree, so that when we leave a subtree we may |
+ // apply a mask to it, but not to the parts outside the subtree. |
+ // - The first time we see a new subtree under a target, we add that target to the top of the stack. This can happen as a layer representing itself, or as a target surface. |
+ // - When we visit a target surface, we apply its mask to its subtree, which is at the top of the stack. |
+ // - When we visit a layer representing itself, we add its occlusion to the current subtree, which is at the top of the stack. |
+ // - When we visit a layer representing a contributing surface, the current target will never be the top of the stack since we just came from the contributing surface. |
+ // We merge the occlusion at the top of the stack with the new current subtree. This new target is pushed onto the stack if not already there. |
+ Vector<StackObject, 1> m_stack; |
+ |
+ // Allow tests to override this. |
+ virtual IntRect layerClipRectInTarget(const LayerType*) const; |
+ |
+private: |
+ // Called when visiting a layer representing itself. If the target was not already current, then this indicates we have entered a new surface subtree. |
+ void enterRenderTarget(const LayerType* newTarget); |
+ |
+ // Called when visiting a layer representing a target surface. This indicates we have visited all the layers within the surface, and we may |
+ // perform any surface-wide operations. |
+ void finishedRenderTarget(const LayerType* finishedTarget); |
+ |
+ // Called when visiting a layer representing a contributing surface. This indicates that we are leaving our current surface, and |
+ // entering the new one. We then perform any operations required for merging results from the child subtree into its parent. |
+ void leaveToRenderTarget(const LayerType* newTarget); |
+ |
+ // Add the layer's occlusion to the tracked state. |
+ void markOccludedBehindLayer(const LayerType*); |
+ |
+ IntRect m_rootTargetRect; |
+ OwnPtr<CCOverdrawMetrics> m_overdrawMetrics; |
+ IntSize m_minimumTrackingSize; |
+ |
+ // This is used for visualizing the occlusion tracking process. |
+ Vector<IntRect>* m_occludingScreenSpaceRects; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(CCOcclusionTrackerBase); |
+}; |
+ |
+typedef CCOcclusionTrackerBase<LayerChromium, RenderSurfaceChromium> CCOcclusionTracker; |
+typedef CCOcclusionTrackerBase<CCLayerImpl, CCRenderSurface> CCOcclusionTrackerImpl; |
+ |
+} |
+#endif // CCOcclusionTracker_h |