Struct ScoreReduction 

pub struct ScoreReduction { /* private fields */ }

A score with its marked notes drawn out into parts of their own: music21’s ScoreReduction.

Each group the marks name has a part, made from the first part’s template, with the marked notes in the voices the marks name. The parts stand above the chord reduction’s parts, if one is given, and the score’s, whose marks are taken out of their lyrics.

Implementations

impl ScoreReduction

pub fn new() -> Self

A reduction of nothing yet.

pub fn score(&self) -> Option<&Stream>

The score reduced.

pub fn set_score(&mut self, score: Stream)

Sets the score reduced. A stream holding no parts is taken as the one part of a score.

pub fn chord_reduction(&self) -> Option<&Stream>

A score of chords whose marked notes go in the reduction too, and whose parts are written below it: music21’s chordReduction.

pub fn set_chord_reduction(&mut self, chords: Stream)

Sets the chord reduction. A stream holding no parts is taken as the one part of a score.

pub fn reduce(&self) -> Result<Stream>

The reduction: music21’s reduce.

The marked notes are gathered, the chord reduction’s first and then the score’s, part by part and measure by measure, each lyric of a note once. Each group named has a part: the first part’s template without its voices, its id and an instrument’s part name the group. Where only one group is named, or none, every note goes in its part. A measure given a note loses its rests for a voice for each voice named, and each note is added into the voice its mark names, or the first, as Stream::insert_into_note_or_chord adds it, with its text above in the measure. Each voice given notes has its gaps filled with rests; voices left empty go, and one left alone is flattened into its measure; and every rest of the part is hidden.

Errors

Nothing to reduce; a lyric with no text, or one marking a note ReductiveNote cannot write; a mark in a measure the first part has not got; or two notes added where music21 refuses them.

Trait Implementations

impl Clone for ScoreReduction

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScoreReduction

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

Formats the value using the given formatter.

impl Default for ScoreReduction

fn default() -> Self

Returns the “default value” for a type.