| OLD | NEW |
| 1 // Copyright 2012 The Chromium Authors. All rights reserved. | 1 // Copyright 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CC_OCCLUSION_TRACKER_H_ | 5 #ifndef CC_OCCLUSION_TRACKER_H_ |
| 6 #define CC_OCCLUSION_TRACKER_H_ | 6 #define CC_OCCLUSION_TRACKER_H_ |
| 7 | 7 |
| 8 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
| 9 #include "cc/cc_export.h" | 9 #include "cc/cc_export.h" |
| 10 #include "cc/layer_iterator.h" | 10 #include "cc/layer_iterator.h" |
| 11 #include "cc/region.h" | 11 #include "cc/region.h" |
| 12 #include "ui/gfx/rect.h" | 12 #include "ui/gfx/rect.h" |
| 13 | 13 |
| 14 namespace cc { | 14 namespace cc { |
| 15 class OverdrawMetrics; | 15 class OverdrawMetrics; |
| 16 class LayerImpl; | 16 class LayerImpl; |
| 17 class RenderSurfaceImpl; | 17 class RenderSurfaceImpl; |
| 18 class Layer; | 18 class Layer; |
| 19 class RenderSurface; | 19 class RenderSurface; |
| 20 | 20 |
| 21 // This class is used to track occlusion of layers while traversing them in a fr
ont-to-back order. As each layer is visited, one of the | 21 // This class is used to track occlusion of layers while traversing them in a fr
ont-to-back order. As each layer is visited, one of the |
| 22 // methods in this class is called to notify it about the current target surface
. | 22 // methods in this class is called to notify it about the current target surface
. |
| 23 // Then, occlusion in the content space of the current layer may be queried, via
methods such as occluded() and unoccludedContentRect(). | 23 // Then, occlusion in the content space of the current layer may be queried, via
methods such as occluded() and unoccludedContentRect(). |
| 24 // If the current layer owns a RenderSurfaceImpl, then occlusion on that RenderS
urfaceImpl may also be queried via surfaceOccluded() and surfaceUnoccludedConten
tRect(). | 24 // If the current layer owns a RenderSurfaceImpl, then occlusion on that RenderS
urfaceImpl may also be queried via surfaceOccluded() and surfaceUnoccludedConten
tRect(). |
| 25 // Finally, once finished with the layer, occlusion behind the layer should be m
arked by calling markOccludedBehindLayer(). | 25 // Finally, once finished with the layer, occlusion behind the layer should be m
arked by calling markOccludedBehindLayer(). |
| 26 template<typename LayerType, typename RenderSurfaceType> | 26 template<typename LayerType, typename RenderSurfaceType> |
| 27 class CC_EXPORT OcclusionTrackerBase { | 27 class CC_EXPORT OcclusionTrackerBase { |
| 28 public: | 28 public: |
| 29 OcclusionTrackerBase(gfx::Rect rootTargetRect, bool recordMetricsForFrame); | 29 OcclusionTrackerBase(gfx::Rect screenSpaceClipRect, bool recordMetricsForFra
me); |
| 30 ~OcclusionTrackerBase(); | 30 ~OcclusionTrackerBase(); |
| 31 | 31 |
| 32 // Called at the beginning of each step in the LayerIterator's front-to-back
traversal. | 32 // Called at the beginning of each step in the LayerIterator's front-to-back
traversal. |
| 33 void enterLayer(const LayerIteratorPosition<LayerType>&); | 33 void enterLayer(const LayerIteratorPosition<LayerType>&); |
| 34 // Called at the end of each step in the LayerIterator's front-to-back trave
rsal. | 34 // Called at the end of each step in the LayerIterator's front-to-back trave
rsal. |
| 35 void leaveLayer(const LayerIteratorPosition<LayerType>&); | 35 void leaveLayer(const LayerIteratorPosition<LayerType>&); |
| 36 | 36 |
| 37 // Returns true if the given rect in content space for a layer is fully occl
uded in either screen space or the layer's target surface. |renderTarget| is th
e contributing layer's render target, and |drawTransform|, |transformsToTargetKn
own| and |clippedRectInTarget| are relative to that. | 37 // Returns true if the given rect in content space for a layer is fully occl
uded in either screen space or the layer's target surface. |renderTarget| is th
e contributing layer's render target, and |drawTransform|, |transformsToTargetKn
own| and |clippedRectInTarget| are relative to that. |
| 38 bool occluded(const LayerType* renderTarget, const gfx::Rect& contentRect, c
onst gfx::Transform& drawTransform, bool implDrawTransformIsUnknown, const gfx::
Rect& clippedRectInTarget, bool* hasOcclusionFromOutsideTargetSurface = 0) const
; | 38 bool occluded(const LayerType* renderTarget, const gfx::Rect& contentRect, c
onst gfx::Transform& drawTransform, bool implDrawTransformIsUnknown, const gfx::
Rect& clippedRectInTarget, bool* hasOcclusionFromOutsideTargetSurface = 0) const
; |
| 39 // Gives an unoccluded sub-rect of |contentRect| in the content space of a l
ayer. Used when considering occlusion for a layer that paints/draws something. |
renderTarget| is the contributing layer's render target, and |drawTransform|, |t
ransformsToTargetKnown| and |clippedRectInTarget| are relative to that. | 39 // Gives an unoccluded sub-rect of |contentRect| in the content space of a l
ayer. Used when considering occlusion for a layer that paints/draws something. |
renderTarget| is the contributing layer's render target, and |drawTransform|, |t
ransformsToTargetKnown| and |clippedRectInTarget| are relative to that. |
| 40 gfx::Rect unoccludedContentRect(const LayerType* renderTarget, const gfx::Re
ct& contentRect, const gfx::Transform& drawTransform, bool implDrawTransformIsUn
known, const gfx::Rect& clippedRectInTarget, bool* hasOcclusionFromOutsideTarget
Surface = 0) const; | 40 gfx::Rect unoccludedContentRect(const LayerType* renderTarget, const gfx::Re
ct& contentRect, const gfx::Transform& drawTransform, bool implDrawTransformIsUn
known, const gfx::Rect& clippedRectInTarget, bool* hasOcclusionFromOutsideTarget
Surface = 0) const; |
| 41 | 41 |
| 42 // Gives an unoccluded sub-rect of |contentRect| in the content space of the
renderTarget owned by the layer. | 42 // Gives an unoccluded sub-rect of |contentRect| in the content space of the
renderTarget owned by the layer. |
| 43 // Used when considering occlusion for a contributing surface that is render
ing into another target. | 43 // Used when considering occlusion for a contributing surface that is render
ing into another target. |
| 44 gfx::Rect unoccludedContributingSurfaceContentRect(const LayerType*, bool fo
rReplica, const gfx::Rect& contentRect, bool* hasOcclusionFromOutsideTargetSurfa
ce = 0) const; | 44 gfx::Rect unoccludedContributingSurfaceContentRect(const LayerType*, bool fo
rReplica, const gfx::Rect& contentRect, bool* hasOcclusionFromOutsideTargetSurfa
ce = 0) const; |
| 45 | 45 |
| 46 // Report operations for recording overdraw metrics. | 46 // Report operations for recording overdraw metrics. |
| 47 OverdrawMetrics& overdrawMetrics() const { return *m_overdrawMetrics.get();
} | 47 OverdrawMetrics& overdrawMetrics() const { return *m_overdrawMetrics.get();
} |
| 48 | 48 |
| 49 // Gives the region of the screen that is not occluded by something opaque. | 49 // Gives the region of the screen that is not occluded by something opaque. |
| 50 Region computeVisibleRegionInScreen() const { return SubtractRegions(m_rootT
argetRect, m_stack.back().occlusionInScreen); } | 50 Region computeVisibleRegionInScreen() const { |
| 51 DCHECK(!m_stack.back().target->parent()); |
| 52 return SubtractRegions(m_screenSpaceClipRect, m_stack.back().occlusionFr
omInsideTarget); |
| 53 } |
| 51 | 54 |
| 52 void setMinimumTrackingSize(const gfx::Size& size) { m_minimumTrackingSize =
size; } | 55 void setMinimumTrackingSize(const gfx::Size& size) { m_minimumTrackingSize =
size; } |
| 53 | 56 |
| 54 // The following is used for visualization purposes. | 57 // The following is used for visualization purposes. |
| 55 void setOccludingScreenSpaceRectsContainer(std::vector<gfx::Rect>* rects) {
m_occludingScreenSpaceRects = rects; } | 58 void setOccludingScreenSpaceRectsContainer(std::vector<gfx::Rect>* rects) {
m_occludingScreenSpaceRects = rects; } |
| 56 void setNonOccludingScreenSpaceRectsContainer(std::vector<gfx::Rect>* rects)
{ m_nonOccludingScreenSpaceRects = rects; } | 59 void setNonOccludingScreenSpaceRectsContainer(std::vector<gfx::Rect>* rects)
{ m_nonOccludingScreenSpaceRects = rects; } |
| 57 | 60 |
| 58 protected: | 61 protected: |
| 59 struct StackObject { | 62 struct StackObject { |
| 60 StackObject() : target(0) { } | 63 StackObject() : target(0) { } |
| 61 StackObject(const LayerType* target) : target(target) { } | 64 StackObject(const LayerType* target) : target(target) { } |
| 62 const LayerType* target; | 65 const LayerType* target; |
| 63 Region occlusionInScreen; | 66 Region occlusionFromOutsideTarget; |
| 64 Region occlusionInTarget; | 67 Region occlusionFromInsideTarget; |
| 65 }; | 68 }; |
| 66 | 69 |
| 67 // The stack holds occluded regions for subtrees in the RenderSurfaceImpl-La
yer tree, so that when we leave a subtree we may | 70 // The stack holds occluded regions for subtrees in the RenderSurfaceImpl-La
yer tree, so that when we leave a subtree we may |
| 68 // apply a mask to it, but not to the parts outside the subtree. | 71 // apply a mask to it, but not to the parts outside the subtree. |
| 69 // - 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. | 72 // - 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. |
| 70 // - When we visit a target surface, we apply its mask to its subtree, which
is at the top of the stack. | 73 // - When we visit a target surface, we apply its mask to its subtree, which
is at the top of the stack. |
| 71 // - When we visit a layer representing itself, we add its occlusion to the
current subtree, which is at the top of the stack. | 74 // - When we visit a layer representing itself, we add its occlusion to the
current subtree, which is at the top of the stack. |
| 72 // - 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 contributi
ng surface. | 75 // - 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 contributi
ng surface. |
| 73 // We merge the occlusion at the top of the stack with the new current subtr
ee. This new target is pushed onto the stack if not already there. | 76 // We merge the occlusion at the top of the stack with the new current subtr
ee. This new target is pushed onto the stack if not already there. |
| 74 std::vector<StackObject> m_stack; | 77 std::vector<StackObject> m_stack; |
| 75 | 78 |
| 76 // Allow tests to override this. | 79 // Allow tests to override this. |
| 77 virtual gfx::Rect layerClipRectInTarget(const LayerType*) const; | 80 virtual gfx::Rect layerClipRectInTarget(const LayerType*) const; |
| 78 | 81 |
| 79 private: | 82 private: |
| 80 // Called when visiting a layer representing itself. If the target was not a
lready current, then this indicates we have entered a new surface subtree. | 83 // Called when visiting a layer representing itself. If the target was not a
lready current, then this indicates we have entered a new surface subtree. |
| 81 void enterRenderTarget(const LayerType* newTarget); | 84 void enterRenderTarget(const LayerType* newTarget); |
| 82 | 85 |
| 83 // Called when visiting a layer representing a target surface. This indicate
s we have visited all the layers within the surface, and we may | 86 // Called when visiting a layer representing a target surface. This indicate
s we have visited all the layers within the surface, and we may |
| 84 // perform any surface-wide operations. | 87 // perform any surface-wide operations. |
| 85 void finishedRenderTarget(const LayerType* finishedTarget); | 88 void finishedRenderTarget(const LayerType* finishedTarget); |
| 86 | 89 |
| 87 // Called when visiting a layer representing a contributing surface. This in
dicates that we are leaving our current surface, and | 90 // Called when visiting a layer representing a contributing surface. This in
dicates that we are leaving our current surface, and |
| 88 // entering the new one. We then perform any operations required for merging
results from the child subtree into its parent. | 91 // entering the new one. We then perform any operations required for merging
results from the child subtree into its parent. |
| 89 void leaveToRenderTarget(const LayerType* newTarget); | 92 void leaveToRenderTarget(const LayerType* newTarget); |
| 90 | 93 |
| 91 // Add the layer's occlusion to the tracked state. | 94 // Add the layer's occlusion to the tracked state. |
| 92 void markOccludedBehindLayer(const LayerType*); | 95 void markOccludedBehindLayer(const LayerType*); |
| 93 | 96 |
| 94 gfx::Rect m_rootTargetRect; | 97 gfx::Rect m_screenSpaceClipRect; |
| 95 scoped_ptr<OverdrawMetrics> m_overdrawMetrics; | 98 scoped_ptr<OverdrawMetrics> m_overdrawMetrics; |
| 96 gfx::Size m_minimumTrackingSize; | 99 gfx::Size m_minimumTrackingSize; |
| 97 | 100 |
| 98 // This is used for visualizing the occlusion tracking process. | 101 // This is used for visualizing the occlusion tracking process. |
| 99 std::vector<gfx::Rect>* m_occludingScreenSpaceRects; | 102 std::vector<gfx::Rect>* m_occludingScreenSpaceRects; |
| 100 std::vector<gfx::Rect>* m_nonOccludingScreenSpaceRects; | 103 std::vector<gfx::Rect>* m_nonOccludingScreenSpaceRects; |
| 101 | 104 |
| 102 DISALLOW_COPY_AND_ASSIGN(OcclusionTrackerBase); | 105 DISALLOW_COPY_AND_ASSIGN(OcclusionTrackerBase); |
| 103 }; | 106 }; |
| 104 | 107 |
| 105 typedef OcclusionTrackerBase<Layer, RenderSurface> OcclusionTracker; | 108 typedef OcclusionTrackerBase<Layer, RenderSurface> OcclusionTracker; |
| 106 typedef OcclusionTrackerBase<LayerImpl, RenderSurfaceImpl> OcclusionTrackerImpl; | 109 typedef OcclusionTrackerBase<LayerImpl, RenderSurfaceImpl> OcclusionTrackerImpl; |
| 107 #if !defined(COMPILER_MSVC) | 110 #if !defined(COMPILER_MSVC) |
| 108 extern template class OcclusionTrackerBase<Layer, RenderSurface>; | 111 extern template class OcclusionTrackerBase<Layer, RenderSurface>; |
| 109 extern template class OcclusionTrackerBase<LayerImpl, RenderSurfaceImpl>; | 112 extern template class OcclusionTrackerBase<LayerImpl, RenderSurfaceImpl>; |
| 110 #endif | 113 #endif |
| 111 | 114 |
| 112 } // namespace cc | 115 } // namespace cc |
| 113 | 116 |
| 114 #endif // CC_OCCLUSION_TRACKER_H_ | 117 #endif // CC_OCCLUSION_TRACKER_H_ |
| OLD | NEW |