Struct TimespanTree 

pub struct TimespanTree<'a> { /* private fields */ }

The timespans of a stream in time, each answer in music21’s order: by where they start, then where they end, then as the stream holds them: music21’s TimespanTree.

Implementations

impl<'a> TimespanTree<'a>

pub fn timespans(&self) -> &[ElementTimespan<'a>]

Every timespan, in order.

pub fn len(&self) -> usize

How many timespans there are.

pub fn is_empty(&self) -> bool

Whether there are none.

pub fn lowest_position(&self) -> Option<FloatType>

Where the earliest timespan starts: music21’s lowestPosition.

pub fn highest_position(&self) -> Option<FloatType>

Where the latest starts: music21’s highestPosition.

pub fn end_time(&self) -> Option<FloatType>

Where the last to end ends: music21’s endTime.

pub fn all_offsets(&self) -> Vec<FloatType>

Each offset a timespan starts at, once, in order: music21’s allOffsets.

pub fn all_time_points(&self) -> Vec<FloatType>

Each offset a timespan starts or ends at, once, in order: music21’s allTimePoints.

pub fn position_after(&self, offset: FloatType) -> Option<FloatType>

The first offset after this one a timespan starts at: music21’s getPositionAfter.

pub fn position_before(&self, offset: FloatType) -> Option<FloatType>

The last offset before this one a timespan starts at: music21’s getPositionBefore.

pub fn starting_at(&self, offset: FloatType) -> Vec<&ElementTimespan<'a>>

The timespans starting at an offset: music21’s elementsStartingAt.

pub fn stopping_at(&self, offset: FloatType) -> Vec<&ElementTimespan<'a>>

The timespans ending at an offset: music21’s elementsStoppingAt.

pub fn overlapping(&self, offset: FloatType) -> Vec<&ElementTimespan<'a>>

The timespans sounding across an offset, started before it and ending after: music21’s elementsOverlappingOffset.

pub fn overlap_time_points(&self, include_stop_points: bool) -> Vec<FloatType>

The offsets a timespan starts at, or with include_stop_points also ends at, where another sounds across: music21’s overlapTimePoints.

pub fn verticality_at(&self, offset: FloatType) -> Verticality<'_, 'a>

What starts, stops and sounds across an offset: music21’s getVerticalityAt.

pub fn verticality_at_or_before( &self, offset: FloatType, ) -> Option<Verticality<'_, 'a>>

The verticality at an offset where something starts there, or the one before: music21’s getVerticalityAtOrBefore.

pub fn verticalities(&self) -> Vec<Verticality<'_, 'a>>

The verticality at each offset a timespan starts at, in order: music21’s iterateVerticalities.

pub fn maximum_overlap(&self) -> Option<usize>

The most timespans starting at or sounding across any one offset a timespan starts at, nothing for an empty tree: music21’s maximumOverlap.

pub fn source(&self) -> &'a Stream

The stream the tree was read from: music21’s source.

pub fn split_at(&mut self, offsets: &[FloatType])

Cuts every timespan sounding across one of these offsets in two there: music21’s splitAt. The pieces come after what already starts and ends where each does.

pub fn verticalities_nwise( &self, n: usize, reverse: bool, pad_end: bool, ) -> Result<Vec<Vec<Verticality<'_, 'a>>>>

Runs of n verticalities, each starting one after the last, in order or reversed: music21’s iterateVerticalitiesNwise. Where there are fewer than n, or with pad_end at the end, a run is filled out with an empty verticality at the tree’s end.

Errors

A run of no verticalities.

pub fn consonance_bounded_verticalities( &self, ) -> Result<Vec<Vec<Verticality<'_, 'a>>>>

Each run of verticalities from one whose chord is consonant to the next that is, with at least one between: music21’s iterateConsonanceBoundedVerticalities.

Errors

A verticality whose pitches make no chord.

pub fn next_in_same_part( &self, timespan: &ElementTimespan<'a>, ) -> Option<&ElementTimespan<'a>>

The next timespan after this one, starting at a later offset, in the same part: music21’s findNextPitchedTimespanInSameStreamByClass.

pub fn previous_in_same_part( &self, timespan: &ElementTimespan<'a>, ) -> Option<&ElementTimespan<'a>>

The timespan before this one, starting at an earlier offset, in the same part: music21’s findPreviousPitchedTimespanInSameStreamByClass.

Trait Implementations

impl<'a> Clone for TimespanTree<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for TimespanTree<'a>

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

Formats the value using the given formatter.