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<'de> Deserialize<'de> for WeightedHexatonicBlues

Available on crate feature serde only.

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for WeightedHexatonicBlues

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for WeightedHexatonicBlues

Available on crate feature serde only.

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 WeightedHexatonicBlues