Struct SeriesHandle 

pub struct SeriesHandle { /* private fields */ }

App-owned, versioned series data. Create once, clone into the spec each frame (a cheap Arc bump), mutate with set / append. The stable id keys the GPU buffer cache for the geometry this series lowers to; revision advances on every mutation so the backend re-uploads only when the data actually changed.

Implementations

impl SeriesHandle

pub fn new(samples: impl Into<Vec<Sample>>) -> Self

A handle owning samples, with a fresh stable id.

pub fn empty() -> Self

An empty handle.

pub fn set(&self, samples: impl Into<Vec<Sample>>)

Replace the samples and advance the revision. The hot path for a virtual app: as the user pans/zooms, resample the source to the visible window and set the result.

pub fn append(&self, more: &[Sample])

Append samples to the tail and advance the revision — for a live series that grows over time. Recomputes bounds over the new tail only.

pub fn id(&self) -> GeometryId

The stable id, constant for the handle’s life. Backends key the GPU buffers for this series’ lowered geometry on it.

pub fn revision(&self) -> u64

The current revision; advances on every mutation.

pub fn bounds(&self) -> SeriesBounds

The cached data-space SeriesBounds.

pub fn len(&self) -> usize

The number of samples currently held.

pub fn is_empty(&self) -> bool

Whether the series currently holds no samples.

pub fn snapshot(&self) -> (Arc<Vec<Sample>>, u64)

A snapshot of the samples (a cheap Arc clone) plus the revision it was taken at — what the lowering and backend read.

Trait Implementations

impl Clone for SeriesHandle

fn clone(&self) -> SeriesHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SeriesHandle

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

Formats the value using the given formatter.