Use float for scroll offset.

third_party/WebKit/Source/core/layout/README.md

Index: third_party/WebKit/Source/core/layout/README.md
diff --git a/third_party/WebKit/Source/core/layout/README.md b/third_party/WebKit/Source/core/layout/README.md
index 258a06d70ddd72d6598f8d012294b1ad005da364..852e9909162718b684461592e30d0df7f3c9e11e 100644
--- a/third_party/WebKit/Source/core/layout/README.md
+++ b/third_party/WebKit/Source/core/layout/README.md
@@ -11,50 +11,49 @@ following document lifecycle states:
 Note that a new Blink layout system is under development. See the
 [LayoutNG design document](https://docs.google.com/document/d/1uxbDh4uONFQOiGuiumlJBLGgO4KDWB8ZEkp7Rd47fw4/preview).
 
-## Overflow rects and scroll offsets
+## Overflow and scrolling
 
-PaintLayerScrollableArea uses a "scroll origin" to conceptually represent the distance between
-the top-left corner of the box'es content rect and the top-left corner of its overflow rect
-when the box is scrolled to the logical beginning of its content (e.g. all the way to the left for
-LTR, all the way to the right for RTL).  For left-to-right and top-to-bottom flows, the scroll
-origin is zero, i.e., the top/left of the overflow rect is at the same position as the top/left of
-the box'es content rect when scrolled to the beginning of flow.  For right-to-left and bottom-to-top
-flows, the overflow rect extends to the top/left of the client rect.
+When a LayoutBox has scrollable overflow, it is associated with a PaintLayerScrollableArea.
+PaintLayerScrollableArea uses a "scroll origin" to represent the location of the top/left
+corner of the content rect (the visible part of the content) in the coordinate system
+defined by the top/left corner of the overflow rect, when the box is scrolled all the way
+to the beginning of its content.
 
-The default calculation for scroll origin is the distance between the top-left corner of the content
-rect and the top-left corner of the overflow rect.  To illustrate, here is a box with left overflow and
-no vertical scrollbar:
+For content which flows left-to-right and top-to-bottom, the scroll origin will be (0, 0),
+i.e., the top/left of the content rect is coincident with the top/left of the overflow rect
+when the box is scrolled all the way to the beginning of content.
 
-                                 content
-                                   rect
-                               |<-------->|
-                        scroll
-                        origin
-                    |<-------->|
-                     _____________________
-                    |          |          |
-                    |          |          |
-                    |          |          |
-    direction:rtl   |          |   box    |
-                    |          |          |
-                    |          |          |
-                    |__________|__________|
+For content which flows right-to-left (including direction:ltr, writing-mode:vertical-rl,
+and flex-direction:row-reverse), the x-coordinate of the scroll origin will be positive;
+and for content which flows bottom-to-top (e.g., flex-direction:column-reverse and
+vertical writing-mode with direction:ltr), the y-coordinate of the scroll origin will be
+positive.
 
-                          overflow rect
-                    |<--------------------->|
+In all cases, the term 'scrollOffset' (or just 'offset') is used to represent the distance
+of the scrolling viewport from its location when scrolled to the beginning of content, and
+it uses type ScrollOffset. The term 'scrollPosition' (or just 'position') represents a
+point in the coordinate space defined by the overflow rect, and it uses type FloatPoint.
+
+For illustrations of these concepts, see these files:
+
+doc/ltr-tb-scroll.png
+doc/rtl-bt-scroll.png
+doc/rtl-tb-scroll.png
 
+Unfortunately, the geometric abstraction of origin, offset, and position breaks down slighlty

[skobes, 2016/10/06 20:06:53]

"slightly"

[szager1, 2016/10/06 21:07:03]

Done.

+when computing the scroll origin if the box has a scrollbar for the orthogonal direction
+(e.g., a vertical scrollbar in a direction:rtl block): the size of the scrollbar must be added
+to the scroll origin calculation. Here are two examples -- note that it doesn't matter whether
+the vertical scrollbar is placed on the right or left of the box (the vertical scrollbar is the
+`|/|` part):
 
-However, if the box has a scrollbar for the orthogonal direction (e.g., a vertical scrollbar
-in a direction:rtl block), the size of the scrollbar must be added to the scroll origin calculation.
-Here are two examples -- note that it doesn't matter whether the vertical scrollbar is placed on
-the right or left of the box (the vertical scrollbar is the `|/|` part):
 
                                    content
                                      rect
                                  |<-------->|
                         scroll
                         origin
-                    |<---------->|
+                    |----------->|
                      _______________________
                     |          |/|          |
                     |          |/|          |
@@ -63,29 +62,28 @@ the right or left of the box (the vertical scrollbar is the `|/|` part):
                     |          |/|          |
                     |          |/|          |
                     |__________|/|__________|
+    
+                          overflow rect
+                    |<--------------------->|
 
+                                 content
+                                   rect
+                               |<-------->|
+                        scroll
+                        origin
+                    |----------->|
+                     _______________________

[skobes, 2016/10/06 20:06:53]

I still can't wrap my head around this picture.

Why does the overflow rect overlap the right-side scrollbar?  If this is the
start-of-flow position the right edge of the content area should be visible,
with the scrollbar extruding to the right.  Then the content rect would be
aligned with the scroll origin just like it is in the left-side scrollbar
diagram.

[szager1, 2016/10/06 21:07:03]

The overflow rect is determined independently of whether the container has a
vertical scrollbar.  So, its dimensions are the same whether or not there's a
vertical scrollbar.  This is why we need
LayoutBox::originAdjustmentForScrollbars.

The downside is that the mental model breaks down: the overflow rect extends to
the 15 pixels underneath the vertical scrollbar.  The upside is that scrollbar
existence (especially overflow:auto scrollbar is existence) is volatile, but we
avoid ever mucking with the location of the overflow rect once it has been
established during layout.

+                    |          |          |/|
+                    |          |          |/|
+                    |          |          |/|
+    writing-mode:   |          |    box   |/|
+      vertical-rl   |          |          |/|
+                    |          |          |/|
+                    |__________|__________|/|
+    
                           overflow rect
                     |<--------------------->|
 
-                                     content
-                                       rect
-                                   |<-------->|
-                          scroll
-                          origin
-                      |<---------->|
-                         _______________________
-                        |          |          |/|
-                        |          |          |/|
-                        |          |          |/|
-    writing-mode:       |          |          |/|
-      vertical-rl       |          |          |/|
-                        |          |          |/|
-                        |          |          |/|
-                        |          |          |/|
-                        |__________|__________|/|
-
-                              overflow rect
-                        |<--------------------->|
 
 ## Coordinate Spaces