Struct CommandRecording 

pub struct CommandRecording { /* private fields */ }

A completed draw command with shared shape data, ordered segments and non-shape primitives. Bounds and content metadata are recorded while drawing; the complete fingerprint is computed when a cache first requests it. Use CommandRecorder to build a command and Self::into_recorder to edit it.

Implementations

impl CommandRecording

pub fn into_recorder(self) -> CommandRecorder

Returns owned command data for further recording. Shape data is copied only when a retained reader still shares it.

pub fn from_primitives( primitives: impl IntoIterator<Item = DrawPrimitive>, ) -> Self

pub fn shape_capacity(&self) -> usize

pub fn pod_heap_bytes(&self) -> usize

The heap the POD tables hold, capacity included.

pub fn tables(&self) -> &RecordTables

The published shape columns and their brush, stop and segment tables.

pub fn shape_recorder(&self) -> &Arc<ShapeRecorder>

Shared ownership of the immutable shape recording.

pub fn len_in(&self, segments: &Range<u32>) -> usize

The entries inside segments that draw, content markers left out.

pub fn shapes(&self) -> &ShapeRecords

The shape columns, with complete records available on demand.

pub fn brushes(&self) -> &[BrushRecord]

pub fn stops(&self) -> &[GradientStopRecord]

pub fn others(&self) -> &[DrawPrimitive]

pub fn segments(&self) -> &[RecordSegment]

pub fn all_segments(&self) -> Range<u32>

Every segment, the range a placement without a content split draws.

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

A rect containing every entry’s coverage rect: exact for rects and the other lanes, the disc around the band for a scope-recorded arc.

pub fn summary(&self) -> RecordingSummary

pub fn content_markers(&self) -> u32

pub fn len(&self) -> usize

Entries of every lane, content markers included.

pub fn is_empty(&self) -> bool

pub fn fingerprint(&self) -> u64

A hash over every entry, table and marker in recorded order, so two recordings with equal fingerprints draw the same pixels. Computed the first time it is asked for, so a recording nothing caches never pays for it.

pub fn is_empty_in(&self, segments: &Range<u32>) -> bool

The segments of segments that draw anything.

pub fn segments_in(&self, segments: &Range<u32>) -> Iter<'_, RecordSegment>

pub fn summary_in(&self, segments: &Range<u32>) -> RecordingSummary

The summary of the entries inside segments only.

pub fn content_split(&self, behind: bool) -> Range<u32>

The segments before the last content marker (behind) or after it; with no marker, behind is empty and overlay is everything.

pub fn coverage_rects( &self, segments: Range<u32>, ) -> impl Iterator<Item = Rect> + '_

The coverage rect of every entry inside segments.

pub fn primitives( &self, segments: Range<u32>, ) -> impl Iterator<Item = DrawPrimitive> + '_

The primitives inside segments, materialised in recorded order, content markers left out.

pub fn primitives_with_markers( &self, ) -> impl Iterator<Item = DrawPrimitive> + '_

Every primitive in recorded order, content markers included.

pub fn into_primitives_with_markers(self) -> Vec<DrawPrimitive>

pub fn materialize_shape(&self, index: usize) -> DrawPrimitive

The exact DrawPrimitive the record was made from.

pub fn brush_of(&self, record: &ShapeRecord) -> Brush

The brush of a record: its solid colour, or the gradient rebuilt from the tables exactly as the app gave it.

Trait Implementations

impl Clone for CommandRecording

fn clone(&self) -> CommandRecording

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandRecording

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

Formats the value using the given formatter.

impl Default for CommandRecording

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for CommandRecording

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.