OLD | NEW |
1 # Platform paint code | 1 # Platform paint code |
2 | 2 |
3 This directory contains the implementation of display lists and display | 3 This directory contains the implementation of display lists and display |
4 list-based painting, except for code which requires knowledge of `core/` | 4 list-based painting, except for code which requires knowledge of `core/` |
5 concepts, such as DOM elements and layout objects. | 5 concepts, such as DOM elements and layout objects. |
6 | 6 |
7 This code is owned by the [paint team][paint-team-site]. | 7 This code is owned by the [paint team][paint-team-site]. |
8 | 8 |
9 Slimming Paint v2 is currently being implemented. Unlike Slimming Paint v1, SPv2 | 9 Slimming Paint v2 is currently being implemented. Unlike Slimming Paint v1, SPv2 |
10 represents its paint artifact not as a flat display list, but as a list of | 10 represents its paint artifact not as a flat display list, but as a list of |
(...skipping 142 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
153 (see [DisplayItemCacheSkipper](DisplayItemCacheSkipper.h)). | 153 (see [DisplayItemCacheSkipper](DisplayItemCacheSkipper.h)). |
154 *** | 154 *** |
155 | 155 |
156 Generally, clients of this code should use stack-allocated recorder classes to | 156 Generally, clients of this code should use stack-allocated recorder classes to |
157 emit display items to a `PaintController` (using `GraphicsContext`). | 157 emit display items to a `PaintController` (using `GraphicsContext`). |
158 | 158 |
159 ### Standalone display items | 159 ### Standalone display items |
160 | 160 |
161 #### [DrawingDisplayItem](DrawingDisplayItem.h) | 161 #### [DrawingDisplayItem](DrawingDisplayItem.h) |
162 | 162 |
163 Holds an `SkPicture` which contains the Skia commands required to draw some atom | 163 Holds a `PaintRecord` which contains the paint operations required to draw some |
164 of content. | 164 atom of content. |
165 | 165 |
166 #### [ForeignLayerDisplayItem](ForeignLayerDisplayItem.h) | 166 #### [ForeignLayerDisplayItem](ForeignLayerDisplayItem.h) |
167 | 167 |
168 Draws an atom of content, but using a `cc::Layer` produced by some agent outside | 168 Draws an atom of content, but using a `cc::Layer` produced by some agent outside |
169 of the normal Blink paint system (for example, a plugin). Since they always map | 169 of the normal Blink paint system (for example, a plugin). Since they always map |
170 to a `cc::Layer`, they are always the only display item in their paint chunk, | 170 to a `cc::Layer`, they are always the only display item in their paint chunk, |
171 and are ineligible for squashing with other layers. | 171 and are ineligible for squashing with other layers. |
172 | 172 |
173 ### Paired begin/end display items | 173 ### Paired begin/end display items |
174 | 174 |
(...skipping 94 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
269 visual and transformed rects of display items in the coordinate space of ancesto
r | 269 visual and transformed rects of display items in the coordinate space of ancesto
r |
270 [`PropertyTreeState`](PropertyTreeState.h)s. | 270 [`PropertyTreeState`](PropertyTreeState.h)s. |
271 | 271 |
272 The transformed rect of a display item in an ancestor `PropertyTreeState` is | 272 The transformed rect of a display item in an ancestor `PropertyTreeState` is |
273 that rect, multiplied by the transforms between the display item's | 273 that rect, multiplied by the transforms between the display item's |
274 `PropertyTreeState` and the ancestors, then flattened into 2D. | 274 `PropertyTreeState` and the ancestors, then flattened into 2D. |
275 | 275 |
276 The visual rect of a display item in an ancestor `PropertyTreeState` is the | 276 The visual rect of a display item in an ancestor `PropertyTreeState` is the |
277 intersection of all of the intermediate clips (transformed in to the ancestor | 277 intersection of all of the intermediate clips (transformed in to the ancestor |
278 state), with the display item's transformed rect. | 278 state), with the display item's transformed rect. |
OLD | NEW |