2011-06-25 Joseph Pecoraro <joepeck@webkit.org>
[WebKit.git] / Source / WebCore / rendering / RenderObject.h
1 /*
2  * Copyright (C) 2000 Lars Knoll (knoll@kde.org)
3  *           (C) 2000 Antti Koivisto (koivisto@kde.org)
4  *           (C) 2000 Dirk Mueller (mueller@kde.org)
5  *           (C) 2004 Allan Sandfeld Jensen (kde@carewolf.com)
6  * Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009 Apple Inc. All rights reserved.
7  * Copyright (C) 2009 Google Inc. All rights reserved.
8  *
9  * This library is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Library General Public
11  * License as published by the Free Software Foundation; either
12  * version 2 of the License, or (at your option) any later version.
13  *
14  * This library is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17  * Library General Public License for more details.
18  *
19  * You should have received a copy of the GNU Library General Public License
20  * along with this library; see the file COPYING.LIB.  If not, write to
21  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22  * Boston, MA 02110-1301, USA.
23  *
24  */
25
26 #ifndef RenderObject_h
27 #define RenderObject_h
28
29 #include "CachedResourceClient.h"
30 #include "Document.h"
31 #include "Element.h"
32 #include "FloatQuad.h"
33 #include "PaintPhase.h"
34 #include "RenderObjectChildList.h"
35 #include "RenderStyle.h"
36 #include "TextAffinity.h"
37 #include "TransformationMatrix.h"
38 #include <wtf/UnusedParam.h>
39
40 #if USE(CG) || USE(CAIRO) || PLATFORM(QT)
41 #define HAVE_PATH_BASED_BORDER_RADIUS_DRAWING 1
42 #endif
43
44 namespace WebCore {
45
46 class AffineTransform;
47 class AnimationController;
48 class HitTestResult;
49 class InlineBox;
50 class InlineFlowBox;
51 class OverlapTestRequestClient;
52 class Path;
53 class Position;
54 class RenderBoxModelObject;
55 class RenderInline;
56 class RenderBlock;
57 class RenderFlow;
58 class RenderLayer;
59 class RenderTheme;
60 class TransformState;
61 class VisiblePosition;
62 #if ENABLE(SVG)
63 class RenderSVGResourceContainer;
64 #endif
65
66 struct PaintInfo;
67
68 enum HitTestFilter {
69     HitTestAll,
70     HitTestSelf,
71     HitTestDescendants
72 };
73
74 enum HitTestAction {
75     HitTestBlockBackground,
76     HitTestChildBlockBackground,
77     HitTestChildBlockBackgrounds,
78     HitTestFloat,
79     HitTestForeground
80 };
81
82 // Sides used when drawing borders and outlines. The values should run clockwise from top.
83 enum BoxSide {
84     BSTop,
85     BSRight,
86     BSBottom,
87     BSLeft
88 };
89
90 const int caretWidth = 1;
91
92 #if ENABLE(DASHBOARD_SUPPORT)
93 struct DashboardRegionValue {
94     bool operator==(const DashboardRegionValue& o) const
95     {
96         return type == o.type && bounds == o.bounds && clip == o.clip && label == o.label;
97     }
98     bool operator!=(const DashboardRegionValue& o) const
99     {
100         return !(*this == o);
101     }
102
103     String label;
104     IntRect bounds;
105     IntRect clip;
106     int type;
107 };
108 #endif
109
110 #ifndef NDEBUG
111 const int showTreeCharacterOffset = 39;
112 #endif
113
114 // Base class for all rendering tree objects.
115 class RenderObject : public CachedResourceClient {
116     friend class RenderBlock;
117     friend class RenderBox;
118     friend class RenderLayer;
119     friend class RenderObjectChildList;
120     friend class RenderSVGContainer;
121 public:
122     // Anonymous objects should pass the document as their node, and they will then automatically be
123     // marked as anonymous in the constructor.
124     RenderObject(Node*);
125     virtual ~RenderObject();
126
127     RenderTheme* theme() const;
128
129     virtual const char* renderName() const = 0;
130
131     RenderObject* parent() const { return m_parent; }
132     bool isDescendantOf(const RenderObject*) const;
133
134     RenderObject* previousSibling() const { return m_previous; }
135     RenderObject* nextSibling() const { return m_next; }
136
137     RenderObject* firstChild() const
138     {
139         if (const RenderObjectChildList* children = virtualChildren())
140             return children->firstChild();
141         return 0;
142     }
143     RenderObject* lastChild() const
144     {
145         if (const RenderObjectChildList* children = virtualChildren())
146             return children->lastChild();
147         return 0;
148     }
149     RenderObject* beforePseudoElementRenderer() const
150     {
151         if (const RenderObjectChildList* children = virtualChildren())
152             return children->beforePseudoElementRenderer(this);
153         return 0;
154     }
155     RenderObject* afterPseudoElementRenderer() const
156     {
157         if (const RenderObjectChildList* children = virtualChildren())
158             return children->afterPseudoElementRenderer(this);
159         return 0;
160     }
161     virtual RenderObjectChildList* virtualChildren() { return 0; }
162     virtual const RenderObjectChildList* virtualChildren() const { return 0; }
163
164     RenderObject* nextInPreOrder() const;
165     RenderObject* nextInPreOrder(RenderObject* stayWithin) const;
166     RenderObject* nextInPreOrderAfterChildren() const;
167     RenderObject* nextInPreOrderAfterChildren(RenderObject* stayWithin) const;
168     RenderObject* previousInPreOrder() const;
169     RenderObject* childAt(unsigned) const;
170
171     RenderObject* firstLeafChild() const;
172     RenderObject* lastLeafChild() const;
173
174     // The following six functions are used when the render tree hierarchy changes to make sure layers get
175     // properly added and removed.  Since containership can be implemented by any subclass, and since a hierarchy
176     // can contain a mixture of boxes and other object types, these functions need to be in the base class.
177     RenderLayer* enclosingLayer() const;
178     void addLayers(RenderLayer* parentLayer, RenderObject* newObject);
179     void removeLayers(RenderLayer* parentLayer);
180     void moveLayers(RenderLayer* oldParent, RenderLayer* newParent);
181     RenderLayer* findNextLayer(RenderLayer* parentLayer, RenderObject* startPoint, bool checkParent = true);
182
183     // Convenience function for getting to the nearest enclosing box of a RenderObject.
184     RenderBox* enclosingBox() const;
185     RenderBoxModelObject* enclosingBoxModelObject() const;
186
187     virtual bool isEmpty() const { return firstChild() == 0; }
188
189 #ifndef NDEBUG
190     void setHasAXObject(bool flag) { m_hasAXObject = flag; }
191     bool hasAXObject() const { return m_hasAXObject; }
192     bool isSetNeedsLayoutForbidden() const { return m_setNeedsLayoutForbidden; }
193     void setNeedsLayoutIsForbidden(bool flag) { m_setNeedsLayoutForbidden = flag; }
194 #endif
195
196     // Obtains the nearest enclosing block (including this block) that contributes a first-line style to our inline
197     // children.
198     virtual RenderBlock* firstLineBlock() const;
199
200     // Called when an object that was floating or positioned becomes a normal flow object
201     // again.  We have to make sure the render tree updates as needed to accommodate the new
202     // normal flow object.
203     void handleDynamicFloatPositionChange();
204     
205     // RenderObject tree manipulation
206     //////////////////////////////////////////
207     virtual bool canHaveChildren() const { return virtualChildren(); }
208     virtual bool isChildAllowed(RenderObject*, RenderStyle*) const { return true; }
209     virtual void addChild(RenderObject* newChild, RenderObject* beforeChild = 0);
210     virtual void addChildIgnoringContinuation(RenderObject* newChild, RenderObject* beforeChild = 0) { return addChild(newChild, beforeChild); }
211     virtual void removeChild(RenderObject*);
212     virtual bool createsAnonymousWrapper() const { return false; }
213     //////////////////////////////////////////
214
215 protected:
216     //////////////////////////////////////////
217     // Helper functions. Dangerous to use!
218     void setPreviousSibling(RenderObject* previous) { m_previous = previous; }
219     void setNextSibling(RenderObject* next) { m_next = next; }
220     void setParent(RenderObject* parent) { m_parent = parent; }
221     //////////////////////////////////////////
222 private:
223     void addAbsoluteRectForLayer(IntRect& result);
224     void setLayerNeedsFullRepaint();
225
226 public:
227 #ifndef NDEBUG
228     void showTreeForThis() const;
229     void showRenderTreeForThis() const;
230     void showLineTreeForThis() const;
231
232     void showRenderObject() const;
233     // We don't make printedCharacters an optional parameter so that
234     // showRenderObject can be called from gdb easily.
235     void showRenderObject(int printedCharacters) const;
236     void showRenderTreeAndMark(const RenderObject* markedObject1 = 0, const char* markedLabel1 = 0, const RenderObject* markedObject2 = 0, const char* markedLabel2 = 0, int depth = 0) const;
237 #endif
238
239     static RenderObject* createObject(Node*, RenderStyle*);
240
241     // Overloaded new operator.  Derived classes must override operator new
242     // in order to allocate out of the RenderArena.
243     void* operator new(size_t, RenderArena*) throw();
244
245     // Overridden to prevent the normal delete from being called.
246     void operator delete(void*, size_t);
247
248 private:
249     // The normal operator new is disallowed on all render objects.
250     void* operator new(size_t) throw();
251
252 public:
253     RenderArena* renderArena() const { return document()->renderArena(); }
254
255     virtual bool isApplet() const { return false; }
256     virtual bool isBR() const { return false; }
257     virtual bool isBlockFlow() const { return false; }
258     virtual bool isBoxModelObject() const { return false; }
259     virtual bool isCounter() const { return false; }
260     virtual bool isQuote() const { return false; }
261 #if ENABLE(DETAILS)
262     virtual bool isDetails() const { return false; }
263     virtual bool isDetailsMarker() const { return false; }
264 #endif
265     virtual bool isEmbeddedObject() const { return false; }
266     virtual bool isFieldset() const { return false; }
267     virtual bool isFileUploadControl() const { return false; }
268     virtual bool isFrame() const { return false; }
269     virtual bool isFrameSet() const { return false; }
270     virtual bool isImage() const { return false; }
271     virtual bool isInlineBlockOrInlineTable() const { return false; }
272     virtual bool isListBox() const { return false; }
273     virtual bool isListItem() const { return false; }
274     virtual bool isListMarker() const { return false; }
275     virtual bool isMedia() const { return false; }
276     virtual bool isMenuList() const { return false; }
277 #if ENABLE(METER_TAG)
278     virtual bool isMeter() const { return false; }
279 #endif
280 #if ENABLE(PROGRESS_TAG)
281     virtual bool isProgress() const { return false; }
282 #endif
283     virtual bool isRenderBlock() const { return false; }
284     virtual bool isRenderButton() const { return false; }
285     virtual bool isRenderIFrame() const { return false; }
286     virtual bool isRenderImage() const { return false; }
287     virtual bool isRenderInline() const { return false; }
288     virtual bool isRenderPart() const { return false; }
289     virtual bool isRenderView() const { return false; }
290     virtual bool isReplica() const { return false; }
291
292     virtual bool isRuby() const { return false; }
293     virtual bool isRubyBase() const { return false; }
294     virtual bool isRubyRun() const { return false; }
295     virtual bool isRubyText() const { return false; }
296
297     virtual bool isSlider() const { return false; }
298 #if ENABLE(DETAILS)
299     virtual bool isSummary() const { return false; }
300 #endif
301     virtual bool isTable() const { return false; }
302     virtual bool isTableCell() const { return false; }
303     virtual bool isTableCol() const { return false; }
304     virtual bool isTableRow() const { return false; }
305     virtual bool isTableSection() const { return false; }
306     virtual bool isTextControl() const { return false; }
307     virtual bool isTextArea() const { return false; }
308     virtual bool isTextField() const { return false; }
309     virtual bool isVideo() const { return false; }
310     virtual bool isWidget() const { return false; }
311     virtual bool isCanvas() const { return false; }
312 #if ENABLE(FULLSCREEN_API)
313     virtual bool isRenderFullScreen() const { return false; }
314     virtual bool isRenderFullScreenPlaceholder() const { return false; }
315 #endif
316
317     bool isRoot() const { return document()->documentElement() == m_node; }
318     bool isBody() const;
319     bool isHR() const;
320     bool isLegend() const;
321
322     bool isHTMLMarquee() const;
323
324     inline bool isBeforeContent() const;
325     inline bool isAfterContent() const;
326     static inline bool isBeforeContent(const RenderObject* obj) { return obj && obj->isBeforeContent(); }
327     static inline bool isAfterContent(const RenderObject* obj) { return obj && obj->isAfterContent(); }
328
329     bool childrenInline() const { return m_childrenInline; }
330     void setChildrenInline(bool b = true) { m_childrenInline = b; }
331     bool hasColumns() const { return m_hasColumns; }
332     void setHasColumns(bool b = true) { m_hasColumns = b; }
333
334     virtual bool requiresForcedStyleRecalcPropagation() const { return false; }
335
336 #if ENABLE(MATHML)
337     virtual bool isRenderMathMLBlock() const { return false; }
338 #endif // ENABLE(MATHML)
339
340 #if ENABLE(SVG)
341     // FIXME: Until all SVG renders can be subclasses of RenderSVGModelObject we have
342     // to add SVG renderer methods to RenderObject with an ASSERT_NOT_REACHED() default implementation.
343     virtual bool isSVGRoot() const { return false; }
344     virtual bool isSVGContainer() const { return false; }
345     virtual bool isSVGViewportContainer() const { return false; } 
346     virtual bool isSVGGradientStop() const { return false; }
347     virtual bool isSVGHiddenContainer() const { return false; }
348     virtual bool isSVGPath() const { return false; }
349     virtual bool isSVGText() const { return false; }
350     virtual bool isSVGTextPath() const { return false; }
351     virtual bool isSVGInline() const { return false; }
352     virtual bool isSVGInlineText() const { return false; }
353     virtual bool isSVGImage() const { return false; }
354     virtual bool isSVGForeignObject() const { return false; }
355     virtual bool isSVGResourceContainer() const { return false; }
356     virtual bool isSVGResourceFilter() const { return false; }
357     virtual bool isSVGResourceFilterPrimitive() const { return false; }
358     virtual bool isSVGShadowTreeRootContainer() const { return false; }
359
360     virtual RenderSVGResourceContainer* toRenderSVGResourceContainer();
361
362     // FIXME: Those belong into a SVG specific base-class for all renderers (see above)
363     // Unfortunately we don't have such a class yet, because it's not possible for all renderers
364     // to inherit from RenderSVGObject -> RenderObject (some need RenderBlock inheritance for instance)
365     virtual void setNeedsTransformUpdate() { }
366     virtual void setNeedsBoundariesUpdate();
367
368     // Per SVG 1.1 objectBoundingBox ignores clipping, masking, filter effects, opacity and stroke-width.
369     // This is used for all computation of objectBoundingBox relative units and by SVGLocateable::getBBox().
370     // NOTE: Markers are not specifically ignored here by SVG 1.1 spec, but we ignore them
371     // since stroke-width is ignored (and marker size can depend on stroke-width).
372     // objectBoundingBox is returned local coordinates.
373     // The name objectBoundingBox is taken from the SVG 1.1 spec.
374     virtual FloatRect objectBoundingBox() const;
375     virtual FloatRect strokeBoundingBox() const;
376
377     // Returns the smallest rectangle enclosing all of the painted content
378     // respecting clipping, masking, filters, opacity, stroke-width and markers
379     virtual FloatRect repaintRectInLocalCoordinates() const;
380
381     // This only returns the transform="" value from the element
382     // most callsites want localToParentTransform() instead.
383     virtual AffineTransform localTransform() const;
384
385     // Returns the full transform mapping from local coordinates to local coords for the parent SVG renderer
386     // This includes any viewport transforms and x/y offsets as well as the transform="" value off the element.
387     virtual const AffineTransform& localToParentTransform() const;
388
389     // SVG uses FloatPoint precise hit testing, and passes the point in parent
390     // coordinates instead of in repaint container coordinates.  Eventually the
391     // rest of the rendering tree will move to a similar model.
392     virtual bool nodeAtFloatPoint(const HitTestRequest&, HitTestResult&, const FloatPoint& pointInParent, HitTestAction);
393 #endif
394
395     bool isAnonymous() const { return m_isAnonymous; }
396     void setIsAnonymous(bool b) { m_isAnonymous = b; }
397     bool isAnonymousBlock() const
398     {
399         // This function is kept in sync with anonymous block creation conditions in
400         // RenderBlock::createAnonymousBlock(). This includes creating an anonymous
401         // RenderBlock having a BLOCK or BOX display. Other classes such as RenderTextFragment
402         // are not RenderBlocks and will return false. See https://bugs.webkit.org/show_bug.cgi?id=56709. 
403         return m_isAnonymous && (style()->display() == BLOCK || style()->display() == BOX) && style()->styleType() == NOPSEUDO && isRenderBlock() && !isListMarker()
404 #if ENABLE(FULLSCREEN_API)
405             && !isRenderFullScreen()
406             && !isRenderFullScreenPlaceholder()
407 #endif
408             ;
409     }
410     bool isAnonymousColumnsBlock() const { return style()->specifiesColumns() && isAnonymousBlock(); }
411     bool isAnonymousColumnSpanBlock() const { return style()->columnSpan() && isAnonymousBlock(); }
412     bool isElementContinuation() const { return node() && node()->renderer() != this; }
413     bool isInlineElementContinuation() const { return isElementContinuation() && isInline(); }
414     bool isBlockElementContinuation() const { return isElementContinuation() && !isInline(); }
415     virtual RenderBoxModelObject* virtualContinuation() const { return 0; }
416
417     bool isFloating() const { return m_floating; }
418     bool isPositioned() const { return m_positioned; } // absolute or fixed positioning
419     bool isRelPositioned() const { return m_relPositioned; } // relative positioning
420     bool isText() const  { return m_isText; }
421     bool isBox() const { return m_isBox; }
422     bool isInline() const { return m_inline; }  // inline object
423     bool isRunIn() const { return style()->display() == RUN_IN; } // run-in object
424     bool isDragging() const { return m_isDragging; }
425     bool isReplaced() const { return m_replaced; } // a "replaced" element (see CSS)
426     bool isHorizontalWritingMode() const { return m_horizontalWritingMode; }
427
428     bool hasLayer() const { return m_hasLayer; }
429     
430     bool hasBoxDecorations() const { return m_paintBackground; }
431     bool borderImageIsLoadedAndCanBeRendered() const;
432     bool mustRepaintBackgroundOrBorder() const;
433     bool hasBackground() const { return style()->hasBackground(); }
434     bool needsLayout() const { return m_needsLayout || m_normalChildNeedsLayout || m_posChildNeedsLayout || m_needsSimplifiedNormalFlowLayout || m_needsPositionedMovementLayout; }
435     bool selfNeedsLayout() const { return m_needsLayout; }
436     bool needsPositionedMovementLayout() const { return m_needsPositionedMovementLayout; }
437     bool needsPositionedMovementLayoutOnly() const { return m_needsPositionedMovementLayout && !m_needsLayout && !m_normalChildNeedsLayout && !m_posChildNeedsLayout && !m_needsSimplifiedNormalFlowLayout; }
438     bool posChildNeedsLayout() const { return m_posChildNeedsLayout; }
439     bool needsSimplifiedNormalFlowLayout() const { return m_needsSimplifiedNormalFlowLayout; }
440     bool normalChildNeedsLayout() const { return m_normalChildNeedsLayout; }
441     
442     bool preferredLogicalWidthsDirty() const { return m_preferredLogicalWidthsDirty; }
443
444     bool isSelectionBorder() const;
445
446     bool hasClip() const { return isPositioned() && style()->hasClip(); }
447     bool hasOverflowClip() const { return m_hasOverflowClip; }
448
449     bool hasTransform() const { return m_hasTransform; }
450     bool hasMask() const { return style() && style()->hasMask(); }
451
452     inline bool preservesNewline() const;
453
454 #if !HAVE(PATH_BASED_BORDER_RADIUS_DRAWING)
455     // FIXME: This function should be removed when all ports implement GraphicsContext::clipConvexPolygon()!!
456     // At that time, everyone can use RenderObject::drawBoxSideFromPath() instead. This should happen soon.
457     void drawArcForBoxSide(GraphicsContext*, int x, int y, float thickness, const IntSize& radius, int angleStart,
458                            int angleSpan, BoxSide, Color, EBorderStyle, bool firstCorner);
459 #endif
460
461     IntRect borderInnerRect(const IntRect&, unsigned short topWidth, unsigned short bottomWidth,
462                             unsigned short leftWidth, unsigned short rightWidth) const;
463
464     // The pseudo element style can be cached or uncached.  Use the cached method if the pseudo element doesn't respect
465     // any pseudo classes (and therefore has no concept of changing state).
466     RenderStyle* getCachedPseudoStyle(PseudoId, RenderStyle* parentStyle = 0) const;
467     PassRefPtr<RenderStyle> getUncachedPseudoStyle(PseudoId, RenderStyle* parentStyle = 0, RenderStyle* ownStyle = 0) const;
468     
469     virtual void updateDragState(bool dragOn);
470
471     RenderView* view() const;
472
473     // Returns true if this renderer is rooted, and optionally returns the hosting view (the root of the hierarchy).
474     bool isRooted(RenderView** = 0);
475
476     Node* node() const { return m_isAnonymous ? 0 : m_node; }
477
478     // Returns the styled node that caused the generation of this renderer.
479     // This is the same as node() except for renderers of :before and :after
480     // pseudo elements for which their parent node is returned.
481     Node* generatingNode() const { return m_node == document() ? 0 : m_node; }
482     void setNode(Node* node) { m_node = node; }
483
484     Document* document() const { return m_node->document(); }
485     Frame* frame() const { return document()->frame(); }
486
487     bool hasOutlineAnnotation() const;
488     bool hasOutline() const { return style()->hasOutline() || hasOutlineAnnotation(); }
489
490     // Returns the object containing this one. Can be different from parent for positioned elements.
491     // If repaintContainer and repaintContainerSkipped are not null, on return *repaintContainerSkipped
492     // is true if the renderer returned is an ancestor of repaintContainer.
493     RenderObject* container(RenderBoxModelObject* repaintContainer = 0, bool* repaintContainerSkipped = 0) const;
494
495     virtual RenderObject* hoverAncestor() const { return parent(); }
496
497     // IE Extension that can be called on any RenderObject.  See the implementation for the details.
498     RenderBoxModelObject* offsetParent() const;
499
500     void markContainingBlocksForLayout(bool scheduleRelayout = true, RenderObject* newRoot = 0);
501     void setNeedsLayout(bool b, bool markParents = true);
502     void setChildNeedsLayout(bool b, bool markParents = true);
503     void setNeedsPositionedMovementLayout();
504     void setNeedsSimplifiedNormalFlowLayout();
505     void setPreferredLogicalWidthsDirty(bool, bool markParents = true);
506     void invalidateContainerPreferredLogicalWidths();
507     
508     void setNeedsLayoutAndPrefWidthsRecalc()
509     {
510         setNeedsLayout(true);
511         setPreferredLogicalWidthsDirty(true);
512     }
513
514     void setPositioned(bool b = true)  { m_positioned = b;  }
515     void setRelPositioned(bool b = true) { m_relPositioned = b; }
516     void setFloating(bool b = true) { m_floating = b; }
517     void setInline(bool b = true) { m_inline = b; }
518     void setHasBoxDecorations(bool b = true) { m_paintBackground = b; }
519     void setIsText() { m_isText = true; }
520     void setIsBox() { m_isBox = true; }
521     void setReplaced(bool b = true) { m_replaced = b; }
522     void setHorizontalWritingMode(bool b = true) { m_horizontalWritingMode = b; }
523     void setHasOverflowClip(bool b = true) { m_hasOverflowClip = b; }
524     void setHasLayer(bool b = true) { m_hasLayer = b; }
525     void setHasTransform(bool b = true) { m_hasTransform = b; }
526     void setHasReflection(bool b = true) { m_hasReflection = b; }
527
528     void scheduleRelayout();
529
530     void updateFillImages(const FillLayer*, const FillLayer*);
531     void updateImage(StyleImage*, StyleImage*);
532
533     virtual void paint(PaintInfo&, const IntPoint&);
534
535     // Recursive function that computes the size and position of this object and all its descendants.
536     virtual void layout();
537
538     /* This function performs a layout only if one is needed. */
539     void layoutIfNeeded() { if (needsLayout()) layout(); }
540     
541     // used for element state updates that cannot be fixed with a
542     // repaint and do not need a relayout
543     virtual void updateFromElement() { }
544
545 #if ENABLE(DASHBOARD_SUPPORT)
546     virtual void addDashboardRegions(Vector<DashboardRegionValue>&);
547     void collectDashboardRegions(Vector<DashboardRegionValue>&);
548 #endif
549
550     bool hitTest(const HitTestRequest&, HitTestResult&, const IntPoint& pointInContainer, const IntPoint& accumulatedOffset, HitTestFilter = HitTestAll);
551     virtual bool nodeAtPoint(const HitTestRequest&, HitTestResult&, const IntPoint& pointInContainer, const IntPoint& accumulatedOffset, HitTestAction);
552     virtual void updateHitTestResult(HitTestResult&, const IntPoint&);
553
554     VisiblePosition positionForCoordinates(int x, int y);
555     virtual VisiblePosition positionForPoint(const IntPoint&);
556     VisiblePosition createVisiblePosition(int offset, EAffinity);
557     VisiblePosition createVisiblePosition(const Position&);
558
559     virtual void dirtyLinesFromChangedChild(RenderObject*);
560
561     // Called to update a style that is allowed to trigger animations.
562     // FIXME: Right now this will typically be called only when updating happens from the DOM on explicit elements.
563     // We don't yet handle generated content animation such as first-letter or before/after (we'll worry about this later).
564     void setAnimatableStyle(PassRefPtr<RenderStyle>);
565
566     // Set the style of the object and update the state of the object accordingly.
567     virtual void setStyle(PassRefPtr<RenderStyle>);
568
569     // Updates only the local style ptr of the object.  Does not update the state of the object,
570     // and so only should be called when the style is known not to have changed (or from setStyle).
571     void setStyleInternal(PassRefPtr<RenderStyle>);
572
573     // returns the containing block level element for this element.
574     RenderBlock* containingBlock() const;
575
576     // Convert the given local point to absolute coordinates
577     // FIXME: Temporary. If useTransforms is true, take transforms into account. Eventually localToAbsolute() will always be transform-aware.
578     FloatPoint localToAbsolute(const FloatPoint& localPoint = FloatPoint(), bool fixed = false, bool useTransforms = false) const;
579     FloatPoint absoluteToLocal(const FloatPoint&, bool fixed = false, bool useTransforms = false) const;
580
581     // Convert a local quad to absolute coordinates, taking transforms into account.
582     FloatQuad localToAbsoluteQuad(const FloatQuad& quad, bool fixed = false, bool* wasFixed = 0) const
583     {
584         return localToContainerQuad(quad, 0, fixed, wasFixed);
585     }
586     // Convert a local quad into the coordinate system of container, taking transforms into account.
587     FloatQuad localToContainerQuad(const FloatQuad&, RenderBoxModelObject* repaintContainer, bool fixed = false, bool* wasFixed = 0) const;
588
589     // Return the offset from the container() renderer (excluding transforms). In multi-column layout,
590     // different offsets apply at different points, so return the offset that applies to the given point.
591     virtual IntSize offsetFromContainer(RenderObject*, const IntPoint&) const;
592     // Return the offset from an object up the container() chain. Asserts that none of the intermediate objects have transforms.
593     IntSize offsetFromAncestorContainer(RenderObject*) const;
594     
595     virtual void absoluteRects(Vector<IntRect>&, const IntPoint&) { }
596     // FIXME: useTransforms should go away eventually
597     IntRect absoluteBoundingBoxRect(bool useTransforms = false);
598
599     // Build an array of quads in absolute coords for line boxes
600     virtual void absoluteQuads(Vector<FloatQuad>&) { }
601
602     void absoluteFocusRingQuads(Vector<FloatQuad>&);
603
604     // the rect that will be painted if this object is passed as the paintingRoot
605     IntRect paintingRootRect(IntRect& topLevelRect);
606
607     virtual int minPreferredLogicalWidth() const { return 0; }
608     virtual int maxPreferredLogicalWidth() const { return 0; }
609
610     RenderStyle* style() const { return m_style.get(); }
611     RenderStyle* firstLineStyle() const { return document()->usesFirstLineRules() ? firstLineStyleSlowCase() : style(); }
612     RenderStyle* style(bool firstLine) const { return firstLine ? firstLineStyle() : style(); }
613
614     // Used only by Element::pseudoStyleCacheIsInvalid to get a first line style based off of a
615     // given new style, without accessing the cache.
616     PassRefPtr<RenderStyle> uncachedFirstLineStyle(RenderStyle*) const;
617
618     // Anonymous blocks that are part of of a continuation chain will return their inline continuation's outline style instead.
619     // This is typically only relevant when repainting.
620     virtual RenderStyle* outlineStyleForRepaint() const { return style(); }
621     
622     void getTextDecorationColors(int decorations, Color& underline, Color& overline,
623                                  Color& linethrough, bool quirksMode = false);
624
625     // Return the RenderBox in the container chain which is responsible for painting this object, or 0
626     // if painting is root-relative. This is the container that should be passed to the 'forRepaint'
627     // methods.
628     RenderBoxModelObject* containerForRepaint() const;
629     // Actually do the repaint of rect r for this object which has been computed in the coordinate space
630     // of repaintContainer. If repaintContainer is 0, repaint via the view.
631     void repaintUsingContainer(RenderBoxModelObject* repaintContainer, const IntRect& r, bool immediate = false);
632     
633     // Repaint the entire object.  Called when, e.g., the color of a border changes, or when a border
634     // style changes.
635     void repaint(bool immediate = false);
636
637     // Repaint a specific subrectangle within a given object.  The rect |r| is in the object's coordinate space.
638     void repaintRectangle(const IntRect&, bool immediate = false);
639
640     // Repaint only if our old bounds and new bounds are different. The caller may pass in newBounds and newOutlineBox if they are known.
641     bool repaintAfterLayoutIfNeeded(RenderBoxModelObject* repaintContainer, const IntRect& oldBounds, const IntRect& oldOutlineBox, const IntRect* newBoundsPtr = 0, const IntRect* newOutlineBoxPtr = 0);
642
643     // Repaint only if the object moved.
644     virtual void repaintDuringLayoutIfMoved(const IntRect& rect);
645
646     // Called to repaint a block's floats.
647     virtual void repaintOverhangingFloats(bool paintAllDescendants = false);
648
649     bool checkForRepaintDuringLayout() const;
650
651     // Returns the rect that should be repainted whenever this object changes.  The rect is in the view's
652     // coordinate space.  This method deals with outlines and overflow.
653     IntRect absoluteClippedOverflowRect()
654     {
655         return clippedOverflowRectForRepaint(0);
656     }
657     virtual IntRect clippedOverflowRectForRepaint(RenderBoxModelObject* repaintContainer);    
658     virtual IntRect rectWithOutlineForRepaint(RenderBoxModelObject* repaintContainer, int outlineWidth);
659
660     // Given a rect in the object's coordinate space, compute a rect suitable for repainting
661     // that rect in view coordinates.
662     void computeAbsoluteRepaintRect(IntRect& r, bool fixed = false)
663     {
664         return computeRectForRepaint(0, r, fixed);
665     }
666     // Given a rect in the object's coordinate space, compute a rect suitable for repainting
667     // that rect in the coordinate space of repaintContainer.
668     virtual void computeRectForRepaint(RenderBoxModelObject* repaintContainer, IntRect&, bool fixed = false);
669
670     // If multiple-column layout results in applying an offset to the given point, add the same
671     // offset to the given size.
672     virtual void adjustForColumns(IntSize&, const IntPoint&) const { }
673
674     virtual unsigned int length() const { return 1; }
675
676     bool isFloatingOrPositioned() const { return (isFloating() || isPositioned()); }
677
678     bool isTransparent() const { return style()->opacity() < 1.0f; }
679     float opacity() const { return style()->opacity(); }
680
681     bool hasReflection() const { return m_hasReflection; }
682
683     // Applied as a "slop" to dirty rect checks during the outline painting phase's dirty-rect checks.
684     int maximalOutlineSize(PaintPhase) const;
685
686     void setHasMarkupTruncation(bool b = true) { m_hasMarkupTruncation = b; }
687     bool hasMarkupTruncation() const { return m_hasMarkupTruncation; }
688
689     enum SelectionState {
690         SelectionNone, // The object is not selected.
691         SelectionStart, // The object either contains the start of a selection run or is the start of a run
692         SelectionInside, // The object is fully encompassed by a selection run
693         SelectionEnd, // The object either contains the end of a selection run or is the end of a run
694         SelectionBoth // The object contains an entire run or is the sole selected object in that run
695     };
696
697     // The current selection state for an object.  For blocks, the state refers to the state of the leaf
698     // descendants (as described above in the SelectionState enum declaration).
699     SelectionState selectionState() const { return static_cast<SelectionState>(m_selectionState);; }
700
701     // Sets the selection state for an object.
702     virtual void setSelectionState(SelectionState state) { m_selectionState = state; }
703
704     // A single rectangle that encompasses all of the selected objects within this object.  Used to determine the tightest
705     // possible bounding box for the selection.
706     IntRect selectionRect(bool clipToVisibleContent = true) { return selectionRectForRepaint(0, clipToVisibleContent); }
707     virtual IntRect selectionRectForRepaint(RenderBoxModelObject* /*repaintContainer*/, bool /*clipToVisibleContent*/ = true) { return IntRect(); }
708
709     // Whether or not an object can be part of the leaf elements of the selection.
710     virtual bool canBeSelectionLeaf() const { return false; }
711
712     // Whether or not a block has selected children.
713     bool hasSelectedChildren() const { return m_selectionState != SelectionNone; }
714
715     // Obtains the selection colors that should be used when painting a selection.
716     Color selectionBackgroundColor() const;
717     Color selectionForegroundColor() const;
718     Color selectionEmphasisMarkColor() const;
719
720     // Whether or not a given block needs to paint selection gaps.
721     virtual bool shouldPaintSelectionGaps() const { return false; }
722
723     /**
724      * Returns the local coordinates of the caret within this render object.
725      * @param caretOffset zero-based offset determining position within the render object.
726      * @param extraWidthToEndOfLine optional out arg to give extra width to end of line -
727      * useful for character range rect computations
728      */
729     virtual IntRect localCaretRect(InlineBox*, int caretOffset, int* extraWidthToEndOfLine = 0);
730
731     bool isMarginBeforeQuirk() const { return m_marginBeforeQuirk; }
732     bool isMarginAfterQuirk() const { return m_marginAfterQuirk; }
733     void setMarginBeforeQuirk(bool b = true) { m_marginBeforeQuirk = b; }
734     void setMarginAfterQuirk(bool b = true) { m_marginAfterQuirk = b; }
735
736     // When performing a global document tear-down, the renderer of the document is cleared.  We use this
737     // as a hook to detect the case of document destruction and don't waste time doing unnecessary work.
738     bool documentBeingDestroyed() const;
739
740     virtual void destroy();
741
742     // Virtual function helpers for CSS3 Flexible Box Layout
743     virtual bool isFlexibleBox() const { return false; }
744     virtual bool isFlexingChildren() const { return false; }
745     virtual bool isStretchingChildren() const { return false; }
746
747     virtual bool isCombineText() const { return false; }
748
749     virtual int caretMinOffset() const;
750     virtual int caretMaxOffset() const;
751     virtual unsigned caretMaxRenderedOffset() const;
752
753     virtual int previousOffset(int current) const;
754     virtual int previousOffsetForBackwardDeletion(int current) const;
755     virtual int nextOffset(int current) const;
756
757     virtual void imageChanged(CachedImage*, const IntRect* = 0);
758     virtual void imageChanged(WrappedImagePtr, const IntRect* = 0) { }
759     virtual bool willRenderImage(CachedImage*);
760
761     void selectionStartEnd(int& spos, int& epos) const;
762
763     bool hasOverrideSize() const { return m_hasOverrideSize; }
764     void setHasOverrideSize(bool b) { m_hasOverrideSize = b; }
765     
766     void remove() { if (parent()) parent()->removeChild(this); }
767
768     AnimationController* animation() const;
769
770     bool visibleToHitTesting() const { return style()->visibility() == VISIBLE && style()->pointerEvents() != PE_NONE; }
771
772     // Map points and quads through elements, potentially via 3d transforms. You should never need to call these directly; use
773     // localToAbsolute/absoluteToLocal methods instead.
774     virtual void mapLocalToContainer(RenderBoxModelObject* repaintContainer, bool useTransforms, bool fixed, TransformState&, bool* wasFixed = 0) const;
775     virtual void mapAbsoluteToLocalPoint(bool fixed, bool useTransforms, TransformState&) const;
776
777     bool shouldUseTransformFromContainer(const RenderObject* container) const;
778     void getTransformFromContainer(const RenderObject* container, const IntSize& offsetInContainer, TransformationMatrix&) const;
779     
780     virtual void addFocusRingRects(Vector<IntRect>&, const IntPoint&) { };
781
782     IntRect absoluteOutlineBounds() const
783     {
784         return outlineBoundsForRepaint(0);
785     }
786
787 protected:
788     // Overrides should call the superclass at the end
789     virtual void styleWillChange(StyleDifference, const RenderStyle* newStyle);
790     // Overrides should call the superclass at the start
791     virtual void styleDidChange(StyleDifference, const RenderStyle* oldStyle);
792
793     void drawLineForBoxSide(GraphicsContext*, int x1, int y1, int x2, int y2, BoxSide,
794                             Color, EBorderStyle, int adjbw1, int adjbw2, bool antialias = false);
795
796     void paintFocusRing(GraphicsContext*, const IntPoint&, RenderStyle*);
797     void paintOutline(GraphicsContext*, const IntRect&);
798     void addPDFURLRect(GraphicsContext*, const IntRect&);
799
800     virtual IntRect viewRect() const;
801
802     void adjustRectForOutlineAndShadow(IntRect&) const;
803
804     void arenaDelete(RenderArena*, void* objectBase);
805
806     virtual IntRect outlineBoundsForRepaint(RenderBoxModelObject* /*repaintContainer*/, IntPoint* /*cachedOffsetToRepaintContainer*/ = 0) const { return IntRect(); }
807
808     class LayoutRepainter {
809     public:
810         LayoutRepainter(RenderObject& object, bool checkForRepaint, const IntRect* oldBounds = 0)
811             : m_object(object)
812             , m_repaintContainer(0)
813             , m_checkForRepaint(checkForRepaint)
814         {
815             if (m_checkForRepaint) {
816                 m_repaintContainer = m_object.containerForRepaint();
817                 m_oldBounds = oldBounds ? *oldBounds : m_object.clippedOverflowRectForRepaint(m_repaintContainer);
818                 m_oldOutlineBox = m_object.outlineBoundsForRepaint(m_repaintContainer);
819             }
820         }
821         
822         // Return true if it repainted.
823         bool repaintAfterLayout()
824         {
825             return m_checkForRepaint ? m_object.repaintAfterLayoutIfNeeded(m_repaintContainer, m_oldBounds, m_oldOutlineBox) : false;
826         }
827         
828         bool checkForRepaint() const { return m_checkForRepaint; }
829         
830     private:
831         RenderObject& m_object;
832         RenderBoxModelObject* m_repaintContainer;
833         IntRect m_oldBounds;
834         IntRect m_oldOutlineBox;
835         bool m_checkForRepaint;
836     };
837     
838 private:
839     RenderStyle* firstLineStyleSlowCase() const;
840     StyleDifference adjustStyleDifference(StyleDifference, unsigned contextSensitiveProperties) const;
841
842     Color selectionColor(int colorProperty) const;
843     
844     RefPtr<RenderStyle> m_style;
845
846     Node* m_node;
847
848     RenderObject* m_parent;
849     RenderObject* m_previous;
850     RenderObject* m_next;
851
852 #ifndef NDEBUG
853     bool m_hasAXObject;
854     bool m_setNeedsLayoutForbidden : 1;
855 #endif
856
857     // 32 bits have been used here. THERE ARE NO FREE BITS AVAILABLE.
858     bool m_needsLayout               : 1;
859     bool m_needsPositionedMovementLayout :1;
860     bool m_normalChildNeedsLayout    : 1;
861     bool m_posChildNeedsLayout       : 1;
862     bool m_needsSimplifiedNormalFlowLayout  : 1;
863     bool m_preferredLogicalWidthsDirty           : 1;
864     bool m_floating                  : 1;
865
866     bool m_positioned                : 1;
867     bool m_relPositioned             : 1;
868     bool m_paintBackground           : 1; // if the box has something to paint in the
869                                           // background painting phase (background, border, etc)
870
871     bool m_isAnonymous               : 1;
872     bool m_isText                    : 1;
873     bool m_isBox                     : 1;
874     bool m_inline                    : 1;
875     bool m_replaced                  : 1;
876     bool m_horizontalWritingMode : 1;
877     bool m_isDragging                : 1;
878
879     bool m_hasLayer                  : 1;
880     bool m_hasOverflowClip           : 1; // Set in the case of overflow:auto/scroll/hidden
881     bool m_hasTransform              : 1;
882     bool m_hasReflection             : 1;
883
884     bool m_hasOverrideSize           : 1;
885     
886 public:
887     bool m_hasCounterNodeMap         : 1;
888     bool m_everHadLayout             : 1;
889
890 private:
891     // These bitfields are moved here from subclasses to pack them together
892     // from RenderBlock
893     bool m_childrenInline : 1;
894     bool m_marginBeforeQuirk : 1;
895     bool m_marginAfterQuirk : 1;
896     bool m_hasMarkupTruncation : 1;
897     unsigned m_selectionState : 3; // SelectionState
898     bool m_hasColumns : 1;
899     
900     // from RenderTableCell
901     bool m_cellWidthChanged : 1;
902
903 private:
904     // Store state between styleWillChange and styleDidChange
905     static bool s_affectsParentBlock;
906 };
907
908 inline bool RenderObject::documentBeingDestroyed() const
909 {
910     return !document()->renderer();
911 }
912
913 inline bool RenderObject::isBeforeContent() const
914 {
915     if (style()->styleType() != BEFORE)
916         return false;
917     // Text nodes don't have their own styles, so ignore the style on a text node.
918     if (isText() && !isBR())
919         return false;
920     return true;
921 }
922
923 inline bool RenderObject::isAfterContent() const
924 {
925     if (style()->styleType() != AFTER)
926         return false;
927     // Text nodes don't have their own styles, so ignore the style on a text node.
928     if (isText() && !isBR())
929         return false;
930     return true;
931 }
932
933 inline void RenderObject::setNeedsLayout(bool b, bool markParents)
934 {
935     bool alreadyNeededLayout = m_needsLayout;
936     m_needsLayout = b;
937     if (b) {
938         ASSERT(!isSetNeedsLayoutForbidden());
939         if (!alreadyNeededLayout) {
940             if (markParents)
941                 markContainingBlocksForLayout();
942             if (hasLayer())
943                 setLayerNeedsFullRepaint();
944         }
945     } else {
946         m_everHadLayout = true;
947         m_posChildNeedsLayout = false;
948         m_needsSimplifiedNormalFlowLayout = false;
949         m_normalChildNeedsLayout = false;
950         m_needsPositionedMovementLayout = false;
951     }
952 }
953
954 inline void RenderObject::setChildNeedsLayout(bool b, bool markParents)
955 {
956     bool alreadyNeededLayout = m_normalChildNeedsLayout;
957     m_normalChildNeedsLayout = b;
958     if (b) {
959         ASSERT(!isSetNeedsLayoutForbidden());
960         if (!alreadyNeededLayout && markParents)
961             markContainingBlocksForLayout();
962     } else {
963         m_posChildNeedsLayout = false;
964         m_needsSimplifiedNormalFlowLayout = false;
965         m_normalChildNeedsLayout = false;
966         m_needsPositionedMovementLayout = false;
967     }
968 }
969
970 inline void RenderObject::setNeedsPositionedMovementLayout()
971 {
972     bool alreadyNeededLayout = m_needsPositionedMovementLayout;
973     m_needsPositionedMovementLayout = true;
974     ASSERT(!isSetNeedsLayoutForbidden());
975     if (!alreadyNeededLayout) {
976         markContainingBlocksForLayout();
977         if (hasLayer())
978             setLayerNeedsFullRepaint();
979     }
980 }
981
982 inline void RenderObject::setNeedsSimplifiedNormalFlowLayout()
983 {
984     bool alreadyNeededLayout = m_needsSimplifiedNormalFlowLayout;
985     m_needsSimplifiedNormalFlowLayout = true;
986     ASSERT(!isSetNeedsLayoutForbidden());
987     if (!alreadyNeededLayout) {
988         markContainingBlocksForLayout();
989         if (hasLayer())
990             setLayerNeedsFullRepaint();
991     }
992 }
993
994 inline bool objectIsRelayoutBoundary(const RenderObject *obj) 
995 {
996     // FIXME: In future it may be possible to broaden this condition in order to improve performance.
997     // Table cells are excluded because even when their CSS height is fixed, their height()
998     // may depend on their contents.
999     return obj->isTextControl()
1000         || (obj->hasOverflowClip() && !obj->style()->width().isIntrinsicOrAuto() && !obj->style()->height().isIntrinsicOrAuto() && !obj->style()->height().isPercent() && !obj->isTableCell())
1001 #if ENABLE(SVG)
1002            || obj->isSVGRoot()
1003 #endif
1004            ;
1005 }
1006
1007 inline void RenderObject::markContainingBlocksForLayout(bool scheduleRelayout, RenderObject* newRoot)
1008 {
1009     ASSERT(!scheduleRelayout || !newRoot);
1010
1011     RenderObject* o = container();
1012     RenderObject* last = this;
1013
1014     bool simplifiedNormalFlowLayout = needsSimplifiedNormalFlowLayout() && !selfNeedsLayout() && !normalChildNeedsLayout();
1015
1016     while (o) {
1017         // Don't mark the outermost object of an unrooted subtree. That object will be 
1018         // marked when the subtree is added to the document.
1019         RenderObject* container = o->container();
1020         if (!container && !o->isRenderView())
1021             return;
1022         if (!last->isText() && (last->style()->position() == FixedPosition || last->style()->position() == AbsolutePosition)) {
1023             while (o && !o->isRenderBlock()) // Skip relatively positioned inlines and get to the enclosing RenderBlock.
1024                 o = o->container();
1025             if (!o || o->m_posChildNeedsLayout)
1026                 return;
1027             o->m_posChildNeedsLayout = true;
1028             simplifiedNormalFlowLayout = true;
1029             ASSERT(!o->isSetNeedsLayoutForbidden());
1030         } else if (simplifiedNormalFlowLayout) {
1031             if (o->m_needsSimplifiedNormalFlowLayout)
1032                 return;
1033             o->m_needsSimplifiedNormalFlowLayout = true;
1034             ASSERT(!o->isSetNeedsLayoutForbidden());
1035         } else {
1036             if (o->m_normalChildNeedsLayout)
1037                 return;
1038             o->m_normalChildNeedsLayout = true;
1039             ASSERT(!o->isSetNeedsLayoutForbidden());
1040         }
1041
1042         if (o == newRoot)
1043             return;
1044
1045         last = o;
1046         if (scheduleRelayout && objectIsRelayoutBoundary(last))
1047             break;
1048         o = container;
1049     }
1050
1051     if (scheduleRelayout)
1052         last->scheduleRelayout();
1053 }
1054
1055 inline bool RenderObject::preservesNewline() const
1056 {
1057 #if ENABLE(SVG)
1058     if (isSVGInlineText())
1059         return false;
1060 #endif
1061         
1062     return style()->preserveNewline();
1063 }
1064
1065 inline void makeMatrixRenderable(TransformationMatrix& matrix, bool has3DRendering)
1066 {
1067 #if !ENABLE(3D_RENDERING)
1068     UNUSED_PARAM(has3DRendering);
1069     matrix.makeAffine();
1070 #else
1071     if (!has3DRendering)
1072         matrix.makeAffine();
1073 #endif
1074 }
1075
1076 inline int adjustForAbsoluteZoom(int value, RenderObject* renderer)
1077 {
1078     return adjustForAbsoluteZoom(value, renderer->style());
1079 }
1080
1081 inline void adjustFloatQuadForAbsoluteZoom(FloatQuad& quad, RenderObject* renderer)
1082 {
1083     float zoom = renderer->style()->effectiveZoom();
1084     if (zoom != 1)
1085         quad.scale(1 / zoom, 1 / zoom);
1086 }
1087
1088 inline void adjustFloatRectForAbsoluteZoom(FloatRect& rect, RenderObject* renderer)
1089 {
1090     float zoom = renderer->style()->effectiveZoom();
1091     if (zoom != 1)
1092         rect.scale(1 / zoom, 1 / zoom);
1093 }
1094
1095 inline void adjustFloatQuadForPageScale(FloatQuad& quad, float pageScale)
1096 {
1097     if (pageScale != 1)
1098         quad.scale(1 / pageScale, 1 / pageScale);
1099 }
1100
1101 inline void adjustFloatRectForPageScale(FloatRect& rect, float pageScale)
1102 {
1103     if (pageScale != 1)
1104         rect.scale(1 / pageScale, 1 / pageScale);
1105 }
1106
1107 } // namespace WebCore
1108
1109 #ifndef NDEBUG
1110 // Outside the WebCore namespace for ease of invocation from gdb.
1111 void showTree(const WebCore::RenderObject*);
1112 void showLineTree(const WebCore::RenderObject*);
1113 void showRenderTree(const WebCore::RenderObject* object1);
1114 // We don't make object2 an optional parameter so that showRenderTree
1115 // can be called from gdb easily.
1116 void showRenderTree(const WebCore::RenderObject* object1, const WebCore::RenderObject* object2);
1117 #endif
1118
1119 #endif // RenderObject_h