Struct Scale 

pub struct Scale {
    pub root: Pitch,
    pub kind: ScaleKind,
}

Fields

root: Pitch

kind: ScaleKind

Implementations

impl Scale

pub fn new(root: Pitch, kind: ScaleKind) -> Self

pub fn from_key(key: &KeySignature) -> Self

Build a scale from a key signature (uses major or natural minor based on mode).

pub fn pitches(&self) -> Vec<Pitch>

All pitches of this scale in ascending order (root octave preserved).

pub fn contains(&self, pitch: &Pitch) -> bool

True if pitch is a member of this scale (octave-independent, by pitch class).

pub fn degree(&self, pitch: &Pitch) -> Option<usize>

Scale degree of pitch (1-based), or None if not in the scale.

pub fn transpose(&self, semitones: i8) -> Scale

Transpose this scale by semitones.

pub fn best_fit(pitches: &[Pitch]) -> Option<Scale>

Find the scale that best fits the given pitches (octave-independent).

Tries all 12 roots × all non-Chromatic ScaleKinds and picks the one with the most pitches covered, breaking ties by preferring scales with more degrees (7-note > 6-note > 5-note) then by ScaleKind declaration order (Major first). Returns None if pitches is empty.

Trait Implementations

impl Clone for Scale

fn clone(&self) -> Scale

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scale

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Scale

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Scale

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Scale

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Scale