Struct WeightedHexatonicBlues 

pub struct WeightedHexatonicBlues { /* private fields */ }

music21’s WeightedHexatonicBlues, with the randomness made explicit.

use music21_rs::{BluesForm, Pitch, WeightedHexatonicBlues};

let blues = WeightedHexatonicBlues::new(Pitch::from_name("C4")?);

let names: Vec<String> = blues.pitches(BluesForm::Hexatonic)?
    .iter().map(|p| p.name()).collect();
assert_eq!(names, ["C", "E-", "F", "F#", "G", "B-", "C"]);

let names: Vec<String> = blues.pitches(BluesForm::Pentatonic)?
    .iter().map(|p| p.name()).collect();
assert_eq!(names, ["C", "E-", "F", "G", "B-", "C"]);

Implementations

impl WeightedHexatonicBlues

pub fn new(tonic: Pitch) -> Self

Builds the scale on a tonic.

pub fn tonic(&self) -> &Pitch

Returns the tonic pitch.

pub fn pitches(&self, form: BluesForm) -> Result<Vec<Pitch>>

Returns the pitches of one form, from the tonic through its octave.

pub fn scale(&self, form: BluesForm) -> Result<StepScale>

Returns one form as a StepScale, for degree and interval access.

pub fn form_for_seed(seed: u64) -> BluesForm

Picks a form from seed, the way music21 picks one at random.

Deterministic for a given seed, so a caller who wants music21’s behaviour can supply entropy and a caller who wants a reproducible result can supply a constant. The two forms are equally likely.

pub fn sample(&self, seed: u64) -> Result<Vec<Pitch>>

Returns the pitches of the form form_for_seed picks.

Trait Implementations

impl Clone for WeightedHexatonicBlues

fn clone(&self) -> WeightedHexatonicBlues

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WeightedHexatonicBlues

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

Formats the value using the given formatter.

impl PartialEq for WeightedHexatonicBlues

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