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),
    Map(PitchMap),
}

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.

Map(PitchMap)

Apply a first-class partial pitch map.

Implementations

impl PitchRemap

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

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

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

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

pub fn as_pitch_map(&self) -> Option<PitchMap>

Returns this remap as a composable pitch map when it is static and expressible in the integer pitch-map domain.

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PitchRemap