| OLD | NEW |
| 1 # `Source/core/paint` | 1 # `Source/core/paint` |
| 2 | 2 |
| 3 This directory contains implementation of painters of layout objects. It covers | 3 This directory contains implementation of painters of layout objects. It covers |
| 4 the following document lifecycle states: | 4 the following document lifecycle states: |
| 5 | 5 |
| 6 * PaintInvalidation (`InPaintInvalidation` and `PaintInvalidationClean`) | 6 * PaintInvalidation (`InPaintInvalidation` and `PaintInvalidationClean`) |
| 7 * PrePaint (`InPrePaint` and `PrePaintClean`) | 7 * PrePaint (`InPrePaint` and `PrePaintClean`) |
| 8 * Paint (`InPaint` and `PaintClean`) | 8 * Paint (`InPaint` and `PaintClean`) |
| 9 | 9 |
| 10 ## Glossaries | 10 ## Glossaries |
| (...skipping 191 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 202 TODO(wangxianzhu): add details | 202 TODO(wangxianzhu): add details |
| 203 | 203 |
| 204 ## [`PrePaintTreeWalk`](PrePaintTreeWalk.h) (Slimming paint v2 only) | 204 ## [`PrePaintTreeWalk`](PrePaintTreeWalk.h) (Slimming paint v2 only) |
| 205 | 205 |
| 206 During `InPrePaint` document lifecycle state, this class is called to walk the w
hole | 206 During `InPrePaint` document lifecycle state, this class is called to walk the w
hole |
| 207 layout tree, beginning from the root FrameView, across frame boundaries. We do t
he | 207 layout tree, beginning from the root FrameView, across frame boundaries. We do t
he |
| 208 following during the tree walk: | 208 following during the tree walk: |
| 209 | 209 |
| 210 * Building paint property tree: creates paint property tree nodes for special | 210 * Building paint property tree: creates paint property tree nodes for special |
| 211 things in the layout tree, including but not limit to: overflow clip, transf
orm, | 211 things in the layout tree, including but not limit to: overflow clip, transf
orm, |
| 212 fixed-pos, animation, mask, filter, etc. | 212 fixed-pos, animation, mask, filter, etc. Also sets direct compositing reason
s to be |
| 213 used later for compositing. |
| 213 | 214 |
| 214 * Paint invalidation: Not implemented yet. TODO(wangxianzhu): add details afte
r | 215 * Paint invalidation: Not implemented yet. TODO(wangxianzhu): add details afte
r |
| 215 it's implemented. | 216 it's implemented. |
| 216 | 217 |
| 217 ## Paint result caching | 218 ## Paint result caching |
| 218 | 219 |
| 219 `PaintController` holds the previous painting result as a cache of display items
. | 220 `PaintController` holds the previous painting result as a cache of display items
. |
| 220 If some painter would generate results same as those of the previous painting, | 221 If some painter would generate results same as those of the previous painting, |
| 221 we'll skip the painting and reuse the display items from cache. | 222 we'll skip the painting and reuse the display items from cache. |
| 222 | 223 |
| (...skipping 44 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 267 | 268 |
| 268 When layer structure changes, and we are not invalidate paint of the changed sub
tree, | 269 When layer structure changes, and we are not invalidate paint of the changed sub
tree, |
| 269 we need to manually update the `needsPaintPhaseXXX` flags. For example, if an ob
ject changes | 270 we need to manually update the `needsPaintPhaseXXX` flags. For example, if an ob
ject changes |
| 270 style and creates a self-painting-layer, we copy the flags from its containing s
elf-painting | 271 style and creates a self-painting-layer, we copy the flags from its containing s
elf-painting |
| 271 layer to this layer, assuming that this layer needs all paint phases that its co
ntainer | 272 layer to this layer, assuming that this layer needs all paint phases that its co
ntainer |
| 272 self-painting layer needs. | 273 self-painting layer needs. |
| 273 | 274 |
| 274 We could update the `needsPaintPhaseXXX` flags in a separate tree walk, but that
would regress | 275 We could update the `needsPaintPhaseXXX` flags in a separate tree walk, but that
would regress |
| 275 performance of the first paint. For slimming paint v2, we can update the flags d
uring the | 276 performance of the first paint. For slimming paint v2, we can update the flags d
uring the |
| 276 pre-painting tree walk to simplify the logics. | 277 pre-painting tree walk to simplify the logics. |
| OLD | NEW |