@@ -27,11 +27,11 @@ namespace flutter {
27
27
// /
28
28
// / The rasterizer owns the instance of the currently active on-screen render
29
29
// / surface. On this surface, it renders the contents of layer trees submitted
30
- // / to it by the engine (which lives on the UI task runner).
30
+ // / to it by the `Engine` (which lives on the UI task runner).
31
31
// /
32
32
// / The primary components owned by the rasterizer are the compositor context
33
- // / and the on-screen render surface. The compositor context all the GPU state
34
- // / necessary to render frames to the render surface.
33
+ // / and the on-screen render surface. The compositor context has all the GPU
34
+ // / state necessary to render frames to the render surface.
35
35
// /
36
36
class Rasterizer final : public SnapshotDelegate {
37
37
public:
@@ -188,6 +188,8 @@ class Rasterizer final : public SnapshotDelegate {
188
188
// / updated in an otherwise static layer tree. To support this use
189
189
// / case, the rasterizer holds onto the last rendered layer tree.
190
190
// /
191
+ // / @bug https://github.com/flutter/flutter/issues/33939
192
+ // /
191
193
// / @return A pointer to the last layer or `nullptr` if this rasterizer
192
194
// / has never rendered a frame.
193
195
// /
@@ -239,7 +241,11 @@ class Rasterizer final : public SnapshotDelegate {
239
241
// / the frame yet! On the other hand, the pipeline must own the
240
242
// / layer tree it renders because it keeps a reference to the last
241
243
// / layer tree around till a new frame is rendered. So a simple
242
- // / reference wont work either.
244
+ // / reference wont work either. The `Rasterizer::DoDraw` method
245
+ // / actually performs the GPU operations within the layer tree
246
+ // / pipeline.
247
+ // /
248
+ // / @see `Rasterizer::DoDraw`
243
249
// /
244
250
// / @param[in] pipeline The layer tree pipeline to take the next layer tree
245
251
// / to render from.
@@ -375,8 +381,10 @@ class Rasterizer final : public SnapshotDelegate {
375
381
// / again with new limits after surface re-acquisition.
376
382
// /
377
383
// / @attention This cache does not describe the entirety of GPU resources
378
- // / that may be cached. The raster cache also holds very large GPU
379
- // / resources.
384
+ // / that may be cached. The `RasterCache` also holds very large
385
+ // / GPU resources.
386
+ // /
387
+ // / @see `RasterCache`
380
388
// /
381
389
// / @param[in] max_bytes The maximum byte size of resource that may be
382
390
// / cached for GPU rendering.
0 commit comments