Expand description
The recording layer: DisplayListBuilder records draw commands into an immutable,
retained DisplayList, computing the record-time oracle as it goes — per-op
device bounds, list bounds, depth-slot counts. The renderer replays lists without
re-deriving any of it — the recorder knows everything, so it says so at record
time rather than making the renderer rediscover it.
DisplayList is a first-class retained object:
immutable, Arc-shared, nestable via DisplayListBuilder::draw_display_list,
with a stable DisplayList::id — hosts keep one list per layer and recompose a
cheap top-level list each frame; the id + bounds invariants are the future hooks for
raster caching and damage rects (deliberately not built yet).
GPU-free and Send + Sync: record on any thread, no Context required.
Structs§
- Backdrop
Backdropdescribes what a backdrop save layer samples from the scene beneath it.- Backdrop
Group BackdropGroupsummarizes regions sharing one backdrop-blur key.- Display
List DisplayListis an immutable recording of drawing commands.- Display
List Builder DisplayListBuilderrecords drawing commands into an immutable display list.- Focal
Circle FocalCircledefines the start circle of a radial gradient.- Glyph
Pos GlyphPosidentifies and positions one glyph within a glyph run.- Gradient
Stop GradientStopassigns a color to one position along a gradient.- Image
Imageis a cheap-to-clone handle to an immutable GPU image.- Image
Inner ImageInnercontains the shared resources and metadata behind anImage.- Mask
Blur MaskBlurapplies a Gaussian blur to a draw’s coverage mask.- Paint
Paintdescribes how a drawing operation produces and composites pixels.- Sampling
Samplingcontrols filtering, mip selection, and behavior outside an image.
Enums§
- Blend
Mode BlendModecontrols how source pixels combine with destination pixels.- Blur
Style BlurStylecontrols where blurred coverage appears relative to a shape.- ClipOp
ClipOpcontrols how a clip shape changes the current clip.- Color
Filter ColorFiltertransforms the pixels produced by a draw or layer.- Filter
Filtercontrols interpolation between neighboring texels.- Image
Filter ImageFiltertransforms a rasterized draw or layer.- Mask
Kind MaskKindcontrols how a mask layer converts pixels into coverage.- Mipmap
Mode MipmapModecontrols how minified images select mip levels.- Op
Opis one recorded display-list command.- Paint
Style PaintStyleselects filled geometry or a stroked outline.- Shader
Shaderdetermines the color painted at each point of a drawing operation.- Spread
Mode SpreadModecontrols a gradient outside its zero-to-one span.- Tile
Mode TileModecontrols samples outside an image’s bounds.
Constants§
- MAX_
GRADIENT_ STOPS MAX_GRADIENT_STOPSis the largest gradient stored directly in uniforms.