1 // Copyright 2014 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
6 #include "core/rendering/compositing/CompositingReasonFinder.h"
8 #include "CSSPropertyNames.h"
10 #include "core/frame/FrameView.h"
11 #include "core/frame/LocalFrame.h"
12 #include "core/frame/Settings.h"
13 #include "core/html/HTMLCanvasElement.h"
14 #include "core/html/HTMLIFrameElement.h"
15 #include "core/html/HTMLMediaElement.h"
16 #include "core/html/canvas/CanvasRenderingContext.h"
17 #include "core/page/Chrome.h"
18 #include "core/page/Page.h"
19 #include "core/rendering/RenderApplet.h"
20 #include "core/rendering/RenderEmbeddedObject.h"
21 #include "core/rendering/RenderFullScreen.h"
22 #include "core/rendering/RenderGeometryMap.h"
23 #include "core/rendering/RenderIFrame.h"
24 #include "core/rendering/RenderLayer.h"
25 #include "core/rendering/RenderLayerStackingNode.h"
26 #include "core/rendering/RenderLayerStackingNodeIterator.h"
27 #include "core/rendering/RenderReplica.h"
28 #include "core/rendering/RenderVideo.h"
29 #include "core/rendering/RenderView.h"
30 #include "core/rendering/compositing/RenderLayerCompositor.h"
34 CompositingReasonFinder::CompositingReasonFinder(RenderView& renderView)
35 : m_renderView(renderView)
36 , m_compositingTriggers(static_cast<CompositingTriggerFlags>(AllCompositingTriggers))
41 void CompositingReasonFinder::updateTriggers()
43 m_compositingTriggers = 0;
45 Settings& settings = m_renderView.document().page()->settings();
46 if (settings.acceleratedCompositingForVideoEnabled())
47 m_compositingTriggers |= VideoTrigger;
48 if (settings.acceleratedCompositingForCanvasEnabled())
49 m_compositingTriggers |= CanvasTrigger;
50 if (settings.compositedScrollingForFramesEnabled())
51 m_compositingTriggers |= ScrollableInnerFrameTrigger;
52 if (settings.acceleratedCompositingForFiltersEnabled())
53 m_compositingTriggers |= FilterTrigger;
55 // We map both these settings to universal overlow scrolling.
56 // FIXME: Replace these settings with a generic compositing setting for HighDPI.
57 if (settings.acceleratedCompositingForOverflowScrollEnabled() || settings.compositorDrivenAcceleratedScrollingEnabled())
58 m_compositingTriggers |= OverflowScrollTrigger;
60 // FIXME: acceleratedCompositingForFixedPositionEnabled should be renamed acceleratedCompositingForViewportConstrainedPositionEnabled().
61 // Or the sticky and fixed position elements should be behind different flags.
62 if (settings.acceleratedCompositingForFixedPositionEnabled())
63 m_compositingTriggers |= ViewportConstrainedPositionedTrigger;
66 bool CompositingReasonFinder::hasOverflowScrollTrigger() const
68 return m_compositingTriggers & OverflowScrollTrigger;
71 // FIXME: This is a temporary trigger for enabling the old, opt-in path for
72 // accelerated overflow scroll. It should be removed once the "universal"
73 // path is ready (crbug.com/254111).
74 bool CompositingReasonFinder::hasLegacyOverflowScrollTrigger() const
76 return m_compositingTriggers & LegacyOverflowScrollTrigger;
79 bool CompositingReasonFinder::isMainFrame() const
81 // FIXME: LocalFrame::isMainFrame() is probably better.
82 return !m_renderView.document().ownerElement();
85 CompositingReasons CompositingReasonFinder::directReasons(const RenderLayer* layer, bool* needToRecomputeCompositingRequirements) const
87 CompositingReasons styleReasons = layer->styleDeterminedCompositingReasons();
88 ASSERT(styleDeterminedReasons(layer->renderer()) == styleReasons);
89 return styleReasons | nonStyleDeterminedDirectReasons(layer, needToRecomputeCompositingRequirements);
92 // This information doesn't appear to be incorporated into CompositingReasons.
93 bool CompositingReasonFinder::requiresCompositingForScrollableFrame() const
95 // Need this done first to determine overflow.
96 ASSERT(!m_renderView.needsLayout());
100 if (!(m_compositingTriggers & ScrollableInnerFrameTrigger))
103 FrameView* frameView = m_renderView.frameView();
104 return frameView->isScrollable();
107 CompositingReasons CompositingReasonFinder::styleDeterminedReasons(RenderObject* renderer) const
109 CompositingReasons directReasons = CompositingReasonNone;
111 if (requiresCompositingForTransform(renderer))
112 directReasons |= CompositingReason3DTransform;
114 if (requiresCompositingForBackfaceVisibilityHidden(renderer))
115 directReasons |= CompositingReasonBackfaceVisibilityHidden;
117 if (requiresCompositingForAnimation(renderer))
118 directReasons |= CompositingReasonActiveAnimation;
120 if (requiresCompositingForFilters(renderer))
121 directReasons |= CompositingReasonFilters;
123 if (requiresCompositingForWillChangeCompositingHint(renderer))
124 directReasons |= CompositingReasonWillChangeCompositingHint;
126 ASSERT(!(directReasons & ~CompositingReasonComboAllStyleDeterminedReasons));
127 return directReasons;
130 bool CompositingReasonFinder::requiresCompositingForTransform(RenderObject* renderer) const
132 // Note that we ask the renderer if it has a transform, because the style may have transforms,
133 // but the renderer may be an inline that doesn't suppport them.
134 return renderer->hasTransform() && renderer->style()->transform().has3DOperation();
137 bool CompositingReasonFinder::requiresCompositingForBackfaceVisibilityHidden(RenderObject* renderer) const
139 return renderer->style()->backfaceVisibility() == BackfaceVisibilityHidden;
142 bool CompositingReasonFinder::requiresCompositingForFilters(RenderObject* renderer) const
144 if (!(m_compositingTriggers & FilterTrigger))
147 return renderer->hasFilter();
150 bool CompositingReasonFinder::requiresCompositingForWillChangeCompositingHint(const RenderObject* renderer) const
152 return renderer->style()->hasWillChangeCompositingHint();
155 CompositingReasons CompositingReasonFinder::nonStyleDeterminedDirectReasons(const RenderLayer* layer, bool* needToRecomputeCompositingRequirements) const
157 CompositingReasons directReasons = CompositingReasonNone;
158 RenderObject* renderer = layer->renderer();
160 if (hasOverflowScrollTrigger()) {
161 if (requiresCompositingForOutOfFlowClipping(layer))
162 directReasons |= CompositingReasonOutOfFlowClipping;
164 if (requiresCompositingForOverflowScrollingParent(layer))
165 directReasons |= CompositingReasonOverflowScrollingParent;
168 if (requiresCompositingForOverflowScrolling(layer))
169 directReasons |= CompositingReasonOverflowScrollingTouch;
171 if (requiresCompositingForPositionSticky(renderer, layer))
172 directReasons |= CompositingReasonPositionSticky;
174 if (requiresCompositingForPositionFixed(renderer, layer, 0, needToRecomputeCompositingRequirements))
175 directReasons |= CompositingReasonPositionFixed;
177 directReasons |= renderer->additionalCompositingReasons(m_compositingTriggers);
179 ASSERT(!(directReasons & CompositingReasonComboAllStyleDeterminedReasons));
180 return directReasons;
183 bool CompositingReasonFinder::requiresCompositingForAnimation(RenderObject* renderer) const
185 return renderer->style()->shouldCompositeForCurrentAnimations();
188 bool CompositingReasonFinder::requiresCompositingForOutOfFlowClipping(const RenderLayer* layer) const
190 return layer->isUnclippedDescendant();
193 bool CompositingReasonFinder::requiresCompositingForOverflowScrollingParent(const RenderLayer* layer) const
195 if (!hasOverflowScrollTrigger())
197 return layer->scrollParent();
200 bool CompositingReasonFinder::requiresCompositingForOverflowScrolling(const RenderLayer* layer) const
202 return layer->needsCompositedScrolling();
205 bool CompositingReasonFinder::requiresCompositingForPosition(RenderObject* renderer, const RenderLayer* layer, RenderLayer::ViewportConstrainedNotCompositedReason* viewportConstrainedNotCompositedReason, bool* needToRecomputeCompositingRequirements) const
207 return requiresCompositingForPositionSticky(renderer, layer) || requiresCompositingForPositionFixed(renderer, layer, viewportConstrainedNotCompositedReason, needToRecomputeCompositingRequirements);
210 bool CompositingReasonFinder::requiresCompositingForPositionSticky(RenderObject* renderer, const RenderLayer* layer) const
212 if (!(m_compositingTriggers & ViewportConstrainedPositionedTrigger))
214 if (renderer->style()->position() != StickyPosition)
216 // FIXME: This probably isn't correct for accelerated overflow scrolling. crbug.com/361723
217 // Instead it should return false only if the layer is not inside a scrollable region.
218 return !layer->enclosingOverflowClipLayer(ExcludeSelf);
221 bool CompositingReasonFinder::requiresCompositingForPositionFixed(RenderObject* renderer, const RenderLayer* layer, RenderLayer::ViewportConstrainedNotCompositedReason* viewportConstrainedNotCompositedReason, bool* needToRecomputeCompositingRequirements) const
223 if (!(m_compositingTriggers & ViewportConstrainedPositionedTrigger))
226 if (renderer->style()->position() != FixedPosition)
229 RenderObject* container = renderer->container();
230 // If the renderer is not hooked up yet then we have to wait until it is.
232 *needToRecomputeCompositingRequirements = true;
236 // Don't promote fixed position elements that are descendants of a non-view container, e.g. transformed elements.
237 // They will stay fixed wrt the container rather than the enclosing frame.
238 if (container != &m_renderView) {
239 if (viewportConstrainedNotCompositedReason)
240 *viewportConstrainedNotCompositedReason = RenderLayer::NotCompositedForNonViewContainer;
244 // If the fixed-position element does not have any scrollable ancestor between it and
245 // its container, then we do not need to spend compositor resources for it. Start by
246 // assuming we can opt-out (i.e. no scrollable ancestor), and refine the answer below.
247 bool hasScrollableAncestor = false;
249 // The FrameView has the scrollbars associated with the top level viewport, so we have to
250 // check the FrameView in addition to the hierarchy of ancestors.
251 FrameView* frameView = m_renderView.frameView();
252 if (frameView && frameView->isScrollable())
253 hasScrollableAncestor = true;
255 RenderLayer* ancestor = layer->parent();
256 while (ancestor && !hasScrollableAncestor) {
257 if (ancestor->scrollsOverflow())
258 hasScrollableAncestor = true;
259 if (ancestor->renderer() == &m_renderView)
261 ancestor = ancestor->parent();
264 if (!hasScrollableAncestor) {
265 if (viewportConstrainedNotCompositedReason)
266 *viewportConstrainedNotCompositedReason = RenderLayer::NotCompositedForUnscrollableAncestors;
270 // Subsequent tests depend on layout. If we can't tell now, just keep things the way they are until layout is done.
271 if (m_renderView.document().lifecycle().state() < DocumentLifecycle::LayoutClean) {
272 *needToRecomputeCompositingRequirements = true;
273 return layer->hasCompositedLayerMapping();
276 bool paintsContent = layer->isVisuallyNonEmpty() || layer->hasVisibleDescendant();
277 if (!paintsContent) {
278 if (viewportConstrainedNotCompositedReason)
279 *viewportConstrainedNotCompositedReason = RenderLayer::NotCompositedForNoVisibleContent;
283 // Fixed position elements that are invisible in the current view don't get their own layer.
284 if (FrameView* frameView = m_renderView.frameView()) {
285 LayoutRect viewBounds = frameView->viewportConstrainedVisibleContentRect();
286 LayoutRect layerBounds = layer->boundingBoxForCompositing(layer->compositor()->rootRenderLayer(), RenderLayer::ApplyBoundsChickenEggHacks);
287 if (!viewBounds.intersects(enclosingIntRect(layerBounds))) {
288 if (viewportConstrainedNotCompositedReason) {
289 *viewportConstrainedNotCompositedReason = RenderLayer::NotCompositedForBoundsOutOfView;
290 *needToRecomputeCompositingRequirements = true;