Struct RingTrackedMidiBuffer 

pub struct RingTrackedMidiBuffer { /* private fields */ }

A fixed-capacity ring buffer of TrackedMidiEvents usable as a TrackedMidiSource, tracking the highest track index seen.

Implementations

impl RingTrackedMidiBuffer

pub fn new(tpq: u32, capacity: usize) -> Result<Self, LiveMidiError>

Creates a tracked buffer at tpq resolution holding up to capacity events.

Fails with LiveMidiError::ZeroCapacity when capacity is zero.

pub fn capacity(&self) -> usize

Returns the buffer’s maximum capacity.

pub fn len(&self) -> usize

Returns the number of buffered events.

pub fn is_empty(&self) -> bool

Returns whether the buffer is empty.

pub fn last_track(&self) -> usize

Returns the track index of the most recently read event.

pub fn dropped_events(&self) -> usize

Returns the running count of events dropped due to overflow.

pub fn clear(&mut self)

Removes all buffered events and resets the track counters.

pub fn snapshot(&self) -> Vec<TrackedMidiEvent>

Returns a copy of the currently buffered tracked events.

pub fn push_tracked_event(&mut self, event: TrackedMidiEvent)

Pushes a tracked event, updating the track count and dropping the oldest event if the buffer is full.

Trait Implementations

impl Clone for RingTrackedMidiBuffer

fn clone(&self) -> RingTrackedMidiBuffer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RingTrackedMidiBuffer

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

Formats the value using the given formatter.

impl MidiSource for RingTrackedMidiBuffer

type Err = Infallible

Error type returned by next.

fn tpq(&self) -> u32

Returns the source resolution in ticks per quarter note.

fn next(&mut self) -> Result<Option<MidiEvent>, Self::Err>

Returns the next event, or None once the stream is exhausted.

impl TrackedMidiSource for RingTrackedMidiBuffer

fn last_track(&self) -> usize

Returns the track index of the most recently yielded event.

fn n_tracks(&self) -> usize

Returns the total number of tracks in the stream.

fn next_tracked(&mut self) -> Result<Option<TrackedMidiEvent>, Self::Err>

Returns the next event together with its track tag.