Struct DisplayList 

pub struct DisplayList { /* private fields */ }

A recorded list of rendering commands that can be replayed onto a pixmap.

The display list captures rendering operations so they can be executed later, potentially multiple times or at different scales. This is useful for caching page rendering results, implementing tiled rendering, and print preview.

Implementations

impl DisplayList

pub fn new(width: u32, height: u32) -> Self

Create a new empty display list with the given target dimensions.

pub fn push(&mut self, cmd: DisplayCommand)

Record a command.

pub fn len(&self) -> usize

Number of recorded commands.

pub fn is_empty(&self) -> bool

Returns true if no commands have been recorded.

pub fn commands(&self) -> &[DisplayCommand]

Get all commands.

pub fn replay(&self, pixmap: &mut Pixmap)

Replay all commands onto a pixmap using the identity transform.

pub fn replay_with_transform( &self, pixmap: &mut Pixmap, extra_transform: Transform, )

Replay all commands onto a pixmap with an extra transform applied to every drawing operation. This is useful for rendering at different scales or offsets without re-recording the display list.

pub fn bounds(&self) -> Option<Rect>

Compute the axis-aligned bounding box that encloses all paths in the display list. Returns None if no paths have been recorded.

pub fn optimize(&mut self)

Remove redundant command sequences that have no visual effect.

Currently optimizes:

• Consecutive Save / Restore pairs with nothing between them.
• Consecutive BeginGroup / EndGroup pairs with nothing between them.

pub fn width(&self) -> u32

Width of the target surface in pixels.

pub fn height(&self) -> u32

Height of the target surface in pixels.

pub fn render_tile( &self, tile_left: f32, tile_top: f32, tile_width: u32, tile_height: u32, ) -> Option<Pixmap>

Render a rectangular tile of the display list.

The tile is specified by its top-left corner (tile_left, tile_top) in the display list’s coordinate system, and its dimensions in pixels. The display list is replayed with a translation so that the tile region maps to (0, 0) on the output pixmap.

Returns None if the pixmap cannot be created (e.g. zero dimensions).

pub fn render_tiled(&self, tile_size: u32, background: Color) -> Option<Pixmap>

Render the display list as a grid of tiles and composite them into a single output pixmap. This can reduce peak memory usage compared to rendering the full page at once when combined with command culling.

Returns None if the output pixmap cannot be created.

Trait Implementations

impl Clone for DisplayList

fn clone(&self) -> DisplayList

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DisplayList

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.