LayoutBox::mapContentsRectToVisibleRectInBorderBoxSpace()

third_party/WebKit/Source/core/layout/LayoutObject.h

 /*
  * Copyright (C) 2000 Lars Knoll (knoll@kde.org)
  *           (C) 2000 Antti Koivisto (koivisto@kde.org)
  *           (C) 2000 Dirk Mueller (mueller@kde.org)
  *           (C) 2004 Allan Sandfeld Jensen (kde@carewolf.com)
  * Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2012 Apple Inc. All rights reserved.
  * Copyright (C) 2009 Google Inc. All rights reserved.
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
@@ skipping 1123 matching lines @@
 
     // Returns the rect that should have paint invalidated whenever this object changes. The rect is in the view's
     // coordinate space. This method deals with outlines and overflow.
     virtual LayoutRect absoluteClippedOverflowRect() const;
 
     // Returns the rect that should have paint invalidated whenever this object changes. The rect is in the object's
     // local coordinate space. This is for non-SVG objects and LayoutSVGRoot only. SVG objects (except LayoutSVGRoot)
     // should use paintInvalidationRectInLocalSVGCoordinates() and map with SVG transforms instead.
     virtual LayoutRect localOverflowRectForPaintInvalidation() const;
 
-    // Given a rect in the object's coordinate space, compute a rect in the coordinate space of |ancestor|.  If
-    // intermediate containers have clipping or scrolling of any kind, it is applied; but overflow clipping is
-    // *not* applied for |ancestor| itself. The output rect is suitable for purposes such as paint invalidation.
+    // Given a rect in the object's coordinate space (i.e. border box space for LayoutBox), compute a rect in the
+    // physical coordinate space of |ancestor|. If intermediate containers (including ancestor itself) have clipping
+    // or scrolling of any kind, it is applied by the child before the rect is passed to container's
+    // |mapToVisibleRectInAncestorSpace()|. The output rect is suitable for purposes such as paint invalidation.
     //
     // If visibleRectFlags has the EdgeInclusive bit set, clipping operations will use
     // LayoutRect::inclusiveIntersect, and the return value of inclusiveIntersect will be propagated
     // to the return value of this method.  Otherwise, clipping operations will use LayoutRect::intersect,
     // and the return value will be true only if the clipped rect has non-zero area.
     // See the documentation for LayoutRect::inclusiveIntersect for more information.
     virtual bool mapToVisibleRectInAncestorSpace(const LayoutBoxModelObject* ancestor, LayoutRect&, VisibleRectFlags = DefaultVisibleRectFlags) const;
 
     // Return the offset to the column in which the specified point (in flow-thread coordinates)
     // lives. This is used to convert a flow-thread point to a visual point.
@@ skipping 1009 matching lines @@
 void showTree(const blink::LayoutObject*);
 void showLineTree(const blink::LayoutObject*);
 void showLayoutTree(const blink::LayoutObject* object1);
 // We don't make object2 an optional parameter so that showLayoutTree
 // can be called from gdb easily.
 void showLayoutTree(const blink::LayoutObject* object1, const blink::LayoutObject* object2);
 
 #endif
 
 #endif // LayoutObject_h