Enum PitchRemap 

pub enum PitchRemap {
    Chromatic(i32),
    ScaleDegree {
        scale: Scale,
        steps: i32,
    },
    PitchClass {
        from: PitchClass,
        to: PitchClass,
    },
    DrumKey(BTreeMap<u8, u8>),
    ChordTone {
        scale: Scale,
        degree: usize,
    },
    Tuning(TuningRemap),
    Vector {
        scale: Scale,
        offsets: Vec<i32>,
    },
    Matrix {
        scale: Scale,
        matrix: IntMatrix,
    },
    Callable(CallablePitchMap),
}

A pitch remapping strategy applied note by note across material.

Variants

Chromatic(i32)

Shift every pitch by a fixed number of semitones.

ScaleDegree

Transpose by scale degrees within scale.

Fields

scale: Scale

Scale that defines the diatonic steps.

steps: i32

Number of scale degrees to move.

PitchClass

Replace one pitch class with another, keeping the octave.

Fields

from: PitchClass

Pitch class to match.

to: PitchClass

Pitch class to substitute.

DrumKey(BTreeMap<u8, u8>)

Remap MIDI drum keys via an explicit key-to-key table.

ChordTone

Snap each pitch to the nearest tone of a chord built on scale.

Fields

scale: Scale

Scale the chord is drawn from.

degree: usize

Chord degree within the scale.

Tuning(TuningRemap)

Apply a microtonal tuning offset.

Vector

Offset each pitch by a per-degree vector of semitone offsets.

Fields

scale: Scale

Scale used to find each pitch’s degree.

offsets: Vec<i32>

Per-degree semitone offsets, indexed cyclically.

Matrix

Apply an integer affine IntMatrix over (degree, octave).

Fields

scale: Scale

Scale used to resolve degrees.

matrix: IntMatrix

Transformation matrix.

Callable(CallablePitchMap)

Apply a named CallablePitchMap.

Implementations

impl PitchRemap

pub fn apply(&self, object: &dyn MusicObject) -> Music

Applies the remap and returns just the music, discarding diagnostics.

pub fn apply_report(&self, object: &dyn MusicObject) -> TransformReport

Applies the remap, returning the music together with any diagnostics.

Trait Implementations

impl Clone for PitchRemap

fn clone(&self) -> PitchRemap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PitchRemap

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

Formats the value using the given formatter.

impl Eq for PitchRemap

impl PartialEq for PitchRemap

fn eq(&self, other: &PitchRemap) -> 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 PitchRemap