344a8eefbab2705c7e95e4ac4fdc193a7b2e944d
[WebKit-https.git] / Source / WebCore / rendering / RenderView.h
1 /*
2  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
3  * Copyright (C) 2006 Apple Inc.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Library General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Library General Public License for more details.
14  *
15  * You should have received a copy of the GNU Library General Public License
16  * along with this library; see the file COPYING.LIB.  If not, write to
17  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18  * Boston, MA 02110-1301, USA.
19  *
20  */
21
22 #ifndef RenderView_h
23 #define RenderView_h
24
25 #include "FrameView.h"
26 #include "LayoutState.h"
27 #include "Region.h"
28 #include "RenderBlockFlow.h"
29 #include "RenderWidget.h"
30 #include "SelectionSubtreeRoot.h"
31 #include <memory>
32 #include <wtf/HashSet.h>
33
34 #if ENABLE(SERVICE_CONTROLS)
35 #include "SelectionRectGatherer.h"
36 #endif
37
38 namespace WebCore {
39
40 class FlowThreadController;
41 class ImageQualityController;
42 class RenderLayerCompositor;
43 class RenderQuote;
44
45 class RenderView final : public RenderBlockFlow, public SelectionSubtreeRoot {
46 public:
47     RenderView(Document&, Ref<RenderStyle>&&);
48     virtual ~RenderView();
49
50     WEBCORE_EXPORT bool hitTest(const HitTestRequest&, HitTestResult&);
51     bool hitTest(const HitTestRequest&, const HitTestLocation&, HitTestResult&);
52
53     virtual const char* renderName() const override { return "RenderView"; }
54
55     virtual bool requiresLayer() const override { return true; }
56
57     virtual bool isChildAllowed(const RenderObject&, const RenderStyle&) const override;
58
59     virtual void layout() override;
60     virtual void updateLogicalWidth() override;
61     virtual void computeLogicalHeight(LayoutUnit logicalHeight, LayoutUnit logicalTop, LogicalExtentComputedValues&) const override;
62
63     virtual LayoutUnit availableLogicalHeight(AvailableLogicalHeightType) const override;
64
65     // The same as the FrameView's layoutHeight/layoutWidth but with null check guards.
66     int viewHeight() const;
67     int viewWidth() const;
68     int viewLogicalWidth() const { return style().isHorizontalWritingMode() ? viewWidth() : viewHeight(); }
69     int viewLogicalHeight() const;
70
71     LayoutUnit clientLogicalWidthForFixedPosition() const;
72     LayoutUnit clientLogicalHeightForFixedPosition() const;
73
74     float zoomFactor() const;
75
76     FrameView& frameView() const { return m_frameView; }
77
78     virtual LayoutRect visualOverflowRect() const override;
79     virtual void computeRectForRepaint(const RenderLayerModelObject* repaintContainer, LayoutRect&, bool fixed = false) const override;
80     void repaintRootContents();
81     void repaintViewRectangle(const LayoutRect&) const;
82     void repaintViewAndCompositedLayers();
83
84     virtual void paint(PaintInfo&, const LayoutPoint&) override;
85     virtual void paintBoxDecorations(PaintInfo&, const LayoutPoint&) override;
86
87     enum SelectionRepaintMode { RepaintNewXOROld, RepaintNewMinusOld, RepaintNothing };
88     void setSelection(RenderObject* start, int startPos, RenderObject* end, int endPos, SelectionRepaintMode = RepaintNewXOROld);
89     void getSelection(RenderObject*& startRenderer, int& startOffset, RenderObject*& endRenderer, int& endOffset) const;
90     void clearSelection();
91     RenderObject* selectionUnsplitStart() const { return m_selectionUnsplitStart; }
92     RenderObject* selectionUnsplitEnd() const { return m_selectionUnsplitEnd; }
93     IntRect selectionBounds(bool clipToVisibleContent = true) const;
94     void repaintSelection() const;
95
96     bool printing() const;
97
98     virtual void absoluteRects(Vector<IntRect>&, const LayoutPoint& accumulatedOffset) const override;
99     virtual void absoluteQuads(Vector<FloatQuad>&, bool* wasFixed) const override;
100
101     void setMaximalOutlineSize(int o);
102     int maximalOutlineSize() const { return m_maximalOutlineSize; }
103
104     LayoutRect viewRect() const;
105
106     // layoutDelta is used transiently during layout to store how far an object has moved from its
107     // last layout location, in order to repaint correctly.
108     // If we're doing a full repaint m_layoutState will be 0, but in that case layoutDelta doesn't matter.
109     LayoutSize layoutDelta() const
110     {
111         return m_layoutState ? m_layoutState->m_layoutDelta : LayoutSize();
112     }
113     void addLayoutDelta(const LayoutSize& delta) 
114     {
115         if (m_layoutState) {
116             m_layoutState->m_layoutDelta += delta;
117 #if !ASSERT_DISABLED && ENABLE(SATURATED_LAYOUT_ARITHMETIC)
118             m_layoutState->m_layoutDeltaXSaturated |= m_layoutState->m_layoutDelta.width() == LayoutUnit::max() || m_layoutState->m_layoutDelta.width() == LayoutUnit::min();
119             m_layoutState->m_layoutDeltaYSaturated |= m_layoutState->m_layoutDelta.height() == LayoutUnit::max() || m_layoutState->m_layoutDelta.height() == LayoutUnit::min();
120 #endif
121         }
122     }
123     
124 #if !ASSERT_DISABLED
125     bool layoutDeltaMatches(const LayoutSize& delta)
126     {
127         if (!m_layoutState)
128             return false;
129 #if ENABLE(SATURATED_LAYOUT_ARITHMETIC)
130         return (delta.width() == m_layoutState->m_layoutDelta.width() || m_layoutState->m_layoutDeltaXSaturated) && (delta.height() == m_layoutState->m_layoutDelta.height() || m_layoutState->m_layoutDeltaYSaturated);
131 #else
132         return delta == m_layoutState->m_layoutDelta;
133 #endif
134     }
135 #endif
136
137     bool doingFullRepaint() const { return frameView().needsFullRepaint(); }
138
139     // Subtree push/pop
140     void pushLayoutState(RenderObject&);
141     void popLayoutState(RenderObject&) { return popLayoutState(); } // Just doing this to keep popLayoutState() private and to make the subtree calls symmetrical.
142
143     bool shouldDisableLayoutStateForSubtree(RenderObject*) const;
144
145     // Returns true if layoutState should be used for its cached offset and clip.
146     bool layoutStateEnabled() const { return m_layoutStateDisableCount == 0 && m_layoutState; }
147     LayoutState* layoutState() const { return m_layoutState.get(); }
148
149     virtual void updateHitTestResult(HitTestResult&, const LayoutPoint&) override;
150
151     LayoutUnit pageLogicalHeight() const { return m_pageLogicalHeight; }
152     void setPageLogicalHeight(LayoutUnit height)
153     {
154         if (m_pageLogicalHeight != height) {
155             m_pageLogicalHeight = height;
156             m_pageLogicalHeightChanged = true;
157         }
158     }
159     LayoutUnit pageOrViewLogicalHeight() const;
160
161     // This method is used to assign a page number only when pagination modes have
162     // a block progression. This happens with vertical-rl books for example, but it
163     // doesn't happen for normal horizontal-tb books. This is a very specialized
164     // function and should not be mistaken for a general page number API.
165     unsigned pageNumberForBlockProgressionOffset(int offset) const;
166
167     unsigned pageCount() const;
168
169     // FIXME: These functions are deprecated. No code should be added that uses these.
170     int bestTruncatedAt() const { return m_legacyPrinting.m_bestTruncatedAt; }
171     void setBestTruncatedAt(int y, RenderBoxModelObject* forRenderer, bool forcedBreak = false);
172     int truncatedAt() const { return m_legacyPrinting.m_truncatedAt; }
173     void setTruncatedAt(int y)
174     { 
175         m_legacyPrinting.m_truncatedAt = y;
176         m_legacyPrinting.m_bestTruncatedAt = 0;
177         m_legacyPrinting.m_truncatorWidth = 0;
178         m_legacyPrinting.m_forcedPageBreak = false;
179     }
180     const IntRect& printRect() const { return m_legacyPrinting.m_printRect; }
181     void setPrintRect(const IntRect& r) { m_legacyPrinting.m_printRect = r; }
182     // End deprecated functions.
183
184     // Notification that this view moved into or out of a native window.
185     void setIsInWindow(bool);
186
187     WEBCORE_EXPORT RenderLayerCompositor& compositor();
188     WEBCORE_EXPORT bool usesCompositing() const;
189
190     WEBCORE_EXPORT IntRect unscaledDocumentRect() const;
191     LayoutRect unextendedBackgroundRect(RenderBox* backgroundRenderer) const;
192     LayoutRect backgroundRect(RenderBox* backgroundRenderer) const;
193
194     WEBCORE_EXPORT IntRect documentRect() const;
195
196     // Renderer that paints the root background has background-images which all have background-attachment: fixed.
197     bool rootBackgroundIsEntirelyFixed() const;
198     
199     bool hasRenderNamedFlowThreads() const;
200     bool checkTwoPassLayoutForAutoHeightRegions() const;
201     FlowThreadController& flowThreadController();
202
203     virtual void styleDidChange(StyleDifference, const RenderStyle* oldStyle) override;
204
205     IntSize viewportSizeForCSSViewportUnits() const;
206
207     void setRenderQuoteHead(RenderQuote* head) { m_renderQuoteHead = head; }
208     RenderQuote* renderQuoteHead() const { return m_renderQuoteHead; }
209
210     // FIXME: This is a work around because the current implementation of counters
211     // requires walking the entire tree repeatedly and most pages don't actually use either
212     // feature so we shouldn't take the performance hit when not needed. Long term we should
213     // rewrite the counter and quotes code.
214     void addRenderCounter() { m_renderCounterCount++; }
215     void removeRenderCounter() { ASSERT(m_renderCounterCount > 0); m_renderCounterCount--; }
216     bool hasRenderCounters() { return m_renderCounterCount; }
217     
218     ImageQualityController& imageQualityController();
219
220     void setHasSoftwareFilters(bool hasSoftwareFilters) { m_hasSoftwareFilters = hasSoftwareFilters; }
221     bool hasSoftwareFilters() const { return m_hasSoftwareFilters; }
222
223     uint64_t rendererCount() const { return m_rendererCount; }
224     void didCreateRenderer() { ++m_rendererCount; }
225     void didDestroyRenderer() { --m_rendererCount; }
226
227     void resumePausedImageAnimationsIfNeeded(IntRect visibleRect);
228     void addRendererWithPausedImageAnimations(RenderElement&);
229     void removeRendererWithPausedImageAnimations(RenderElement&);
230
231     class RepaintRegionAccumulator {
232         WTF_MAKE_NONCOPYABLE(RepaintRegionAccumulator);
233     public:
234         RepaintRegionAccumulator(RenderView*);
235         ~RepaintRegionAccumulator();
236
237     private:
238         RenderView* m_rootView;
239         bool m_wasAccumulatingRepaintRegion;
240     };
241
242     void scheduleLazyRepaint(RenderBox&);
243     void unscheduleLazyRepaint(RenderBox&);
244
245     void protectRenderWidgetUntilLayoutIsDone(RenderWidget& widget) { m_protectedRenderWidgets.append(&widget); }
246     void releaseProtectedRenderWidgets() { m_protectedRenderWidgets.clear(); }
247
248 protected:
249     virtual void mapLocalToContainer(const RenderLayerModelObject* repaintContainer, TransformState&, MapCoordinatesFlags, bool* wasFixed) const override;
250     virtual const RenderObject* pushMappingToContainer(const RenderLayerModelObject* ancestorToStopAt, RenderGeometryMap&) const override;
251     virtual void mapAbsoluteToLocalPoint(MapCoordinatesFlags, TransformState&) const override;
252     virtual bool requiresColumns(int desiredColumnCount) const override;
253
254 private:
255     void initializeLayoutState(LayoutState&);
256
257     virtual void computeColumnCountAndWidth() override;
258
259     bool shouldRepaint(const LayoutRect&) const;
260     void flushAccumulatedRepaintRegion() const;
261
262     // These functions may only be accessed by LayoutStateMaintainer.
263     bool pushLayoutState(RenderBox& renderer, const LayoutSize& offset, LayoutUnit pageHeight = 0, bool pageHeightChanged = false)
264     {
265         // We push LayoutState even if layoutState is disabled because it stores layoutDelta too.
266         if (!doingFullRepaint() || m_layoutState->isPaginated() || renderer.flowThreadContainingBlock()
267             || m_layoutState->lineGrid() || (renderer.style().lineGrid() != RenderStyle::initialLineGrid() && renderer.isRenderBlockFlow())) {
268             m_layoutState = std::make_unique<LayoutState>(WTF::move(m_layoutState), &renderer, offset, pageHeight, pageHeightChanged);
269             pushLayoutStateForCurrentFlowThread(renderer);
270             return true;
271         }
272         return false;
273     }
274
275     void popLayoutState()
276     {
277         popLayoutStateForCurrentFlowThread();
278         m_layoutState = WTF::move(m_layoutState->m_next);
279     }
280
281     // Suspends the LayoutState optimization. Used under transforms that cannot be represented by
282     // LayoutState (common in SVG) and when manipulating the render tree during layout in ways
283     // that can trigger repaint of a non-child (e.g. when a list item moves its list marker around).
284     // Note that even when disabled, LayoutState is still used to store layoutDelta.
285     // These functions may only be accessed by LayoutStateMaintainer or LayoutStateDisabler.
286     void disableLayoutState() { m_layoutStateDisableCount++; }
287     void enableLayoutState() { ASSERT(m_layoutStateDisableCount > 0); m_layoutStateDisableCount--; }
288
289     void layoutContent(const LayoutState&);
290     void layoutContentInAutoLogicalHeightRegions(const LayoutState&);
291     void layoutContentToComputeOverflowInRegions(const LayoutState&);
292 #ifndef NDEBUG
293     void checkLayoutState(const LayoutState&);
294 #endif
295
296     void pushLayoutStateForCurrentFlowThread(const RenderObject&);
297     void popLayoutStateForCurrentFlowThread();
298
299     friend class LayoutStateMaintainer;
300     friend class LayoutStateDisabler;
301
302     virtual bool isScrollableOrRubberbandableBox() const override;
303
304     void splitSelectionBetweenSubtrees(const RenderObject* startRenderer, int startPos, const RenderObject* endRenderer, int endPos, SelectionRepaintMode blockRepaintMode);
305     void clearSubtreeSelection(const SelectionSubtreeRoot&, SelectionRepaintMode, OldSelectionData&) const;
306     void updateSelectionForSubtrees(RenderSubtreesMap&, SelectionRepaintMode);
307     void applySubtreeSelection(const SelectionSubtreeRoot&, SelectionRepaintMode, const OldSelectionData&);
308     LayoutRect subtreeSelectionBounds(const SelectionSubtreeRoot&, bool clipToVisibleContent = true) const;
309     void repaintSubtreeSelection(const SelectionSubtreeRoot&) const;
310
311 private:
312     FrameView& m_frameView;
313
314     RenderObject* m_selectionUnsplitStart;
315     RenderObject* m_selectionUnsplitEnd;
316     int m_selectionUnsplitStartPos;
317     int m_selectionUnsplitEndPos;
318
319     uint64_t m_rendererCount;
320
321     mutable std::unique_ptr<Region> m_accumulatedRepaintRegion;
322
323     // FIXME: Only used by embedded WebViews inside AppKit NSViews.  Find a way to remove.
324     struct LegacyPrinting {
325         LegacyPrinting()
326             : m_bestTruncatedAt(0)
327             , m_truncatedAt(0)
328             , m_truncatorWidth(0)
329             , m_forcedPageBreak(false)
330         { }
331
332         int m_bestTruncatedAt;
333         int m_truncatedAt;
334         int m_truncatorWidth;
335         IntRect m_printRect;
336         bool m_forcedPageBreak;
337     };
338     LegacyPrinting m_legacyPrinting;
339     // End deprecated members.
340
341     int m_maximalOutlineSize; // Used to apply a fudge factor to dirty-rect checks on blocks/tables.
342
343     bool shouldUsePrintingLayout() const;
344
345     void lazyRepaintTimerFired();
346
347     Timer m_lazyRepaintTimer;
348     HashSet<RenderBox*> m_renderersNeedingLazyRepaint;
349
350     std::unique_ptr<ImageQualityController> m_imageQualityController;
351     LayoutUnit m_pageLogicalHeight;
352     bool m_pageLogicalHeightChanged;
353     std::unique_ptr<LayoutState> m_layoutState;
354     unsigned m_layoutStateDisableCount;
355     std::unique_ptr<RenderLayerCompositor> m_compositor;
356     std::unique_ptr<FlowThreadController> m_flowThreadController;
357
358     RenderQuote* m_renderQuoteHead;
359     unsigned m_renderCounterCount;
360
361     bool m_selectionWasCaret;
362     bool m_hasSoftwareFilters;
363
364     HashSet<RenderElement*> m_renderersWithPausedImageAnimation;
365     Vector<RefPtr<RenderWidget>> m_protectedRenderWidgets;
366
367 #if ENABLE(SERVICE_CONTROLS)
368     SelectionRectGatherer m_selectionRectGatherer;
369 #endif
370 };
371
372 // Stack-based class to assist with LayoutState push/pop
373 class LayoutStateMaintainer {
374     WTF_MAKE_NONCOPYABLE(LayoutStateMaintainer);
375 public:
376     // Constructor to push now.
377     explicit LayoutStateMaintainer(RenderView& view, RenderBox& root, LayoutSize offset, bool disableState = false, LayoutUnit pageHeight = 0, bool pageHeightChanged = false)
378         : m_view(view)
379         , m_disabled(disableState)
380         , m_didStart(false)
381         , m_didEnd(false)
382         , m_didCreateLayoutState(false)
383     {
384         push(root, offset, pageHeight, pageHeightChanged);
385     }
386
387     // Constructor to maybe push later.
388     explicit LayoutStateMaintainer(RenderView& view)
389         : m_view(view)
390         , m_disabled(false)
391         , m_didStart(false)
392         , m_didEnd(false)
393         , m_didCreateLayoutState(false)
394     {
395     }
396
397     ~LayoutStateMaintainer()
398     {
399         ASSERT(m_didStart == m_didEnd);   // if this fires, it means that someone did a push(), but forgot to pop().
400     }
401
402     void push(RenderBox& root, LayoutSize offset, LayoutUnit pageHeight = 0, bool pageHeightChanged = false)
403     {
404         ASSERT(!m_didStart);
405         // We push state even if disabled, because we still need to store layoutDelta
406         m_didCreateLayoutState = m_view.pushLayoutState(root, offset, pageHeight, pageHeightChanged);
407         if (m_disabled && m_didCreateLayoutState)
408             m_view.disableLayoutState();
409         m_didStart = true;
410     }
411
412     void pop()
413     {
414         if (m_didStart) {
415             ASSERT(!m_didEnd);
416             if (m_didCreateLayoutState) {
417                 m_view.popLayoutState();
418                 if (m_disabled)
419                     m_view.enableLayoutState();
420             }
421             
422             m_didEnd = true;
423         }
424     }
425
426     bool didPush() const { return m_didStart; }
427
428 private:
429     RenderView& m_view;
430     bool m_disabled : 1;        // true if the offset and clip part of layoutState is disabled
431     bool m_didStart : 1;        // true if we did a push or disable
432     bool m_didEnd : 1;          // true if we popped or re-enabled
433     bool m_didCreateLayoutState : 1; // true if we actually made a layout state.
434 };
435
436 class LayoutStateDisabler {
437     WTF_MAKE_NONCOPYABLE(LayoutStateDisabler);
438 public:
439     LayoutStateDisabler(RenderView* view)
440         : m_view(view)
441     {
442         if (m_view)
443             m_view->disableLayoutState();
444     }
445
446     ~LayoutStateDisabler()
447     {
448         if (m_view)
449             m_view->enableLayoutState();
450     }
451 private:
452     RenderView* m_view;
453 };
454
455 } // namespace WebCore
456
457 SPECIALIZE_TYPE_TRAITS_RENDER_OBJECT(RenderView, isRenderView())
458
459 #endif // RenderView_h