Struct TempoMap 

pub struct TempoMap { /* private fields */ }

Ordered list of TempoSegments describing how MIDI tempo changes over a timeline.

A valid map starts with a segment at tick 0 and has strictly increasing segment ticks, so every tick maps to exactly one tempo. The map drives the tick <-> Instant conversions for MIDI clocks.

Examples

use sim_lib_stream_clock::TempoMap;

let map = TempoMap::single(500_000)?;
assert_eq!(map.segments().len(), 1);
assert_eq!(map.segments()[0].start_tick, 0);

Implementations

impl TempoMap

pub fn new(segments: Vec<TempoSegment>) -> Result<Self>

Builds a tempo map from segments.

Returns an error when segments is empty, when the first segment does not start at tick 0, or when the segment ticks are not strictly increasing.

pub fn single(us_per_quarter: u32) -> Result<Self>

Builds a single-segment map holding a constant tempo from tick 0.

Returns an error when us_per_quarter is zero.

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

Returns the map’s segments in tick order.

Trait Implementations

impl Clone for TempoMap

fn clone(&self) -> TempoMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TempoMap

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

Formats the value using the given formatter.

impl Eq for TempoMap

impl PartialEq for TempoMap

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TempoMap