Struct PitchClassMask 

pub struct PitchClassMask(/* private fields */);

A bitmask over the twelve pitch classes, with bit n set when pitch class n is present.

The low twelve bits represent pitch classes C through B.

Examples

use sim_lib_pitch_core::PitchClass;
use sim_lib_pitch_set::PitchClassMask;

let triad = PitchClassMask::from_pitch_classes(&[PitchClass::C, PitchClass::E, PitchClass::G]);
assert_eq!(triad.count_bits(), 3);

Implementations

impl PitchClassMask

pub fn new(bits: u16) -> Result<Self, PitchSetError>

Builds a pitch-class mask, rejecting any bits outside the low twelve.

pub const fn bits(self) -> u16

Returns the raw low-twelve pitch-class bits.

pub fn from_pitch_classes(pitch_classes: &[PitchClass]) -> Self

Builds a mask from a slice of pitch classes; duplicates collapse to one bit.

pub fn pitch_classes(self) -> Vec<PitchClass>

Returns the set pitch classes in ascending order.

pub fn rotate(self, semitones: i32) -> Self

Returns this mask transposed by semitones, wrapping within the octave.

pub fn invert(self, axis: PitchClass) -> Self

Returns this mask inverted about axis.

pub fn normalize(self) -> Self

Returns the rotation of this mask with the smallest numeric value, a transposition-invariant normal form.

pub fn count_bits(self) -> u32

Returns the number of pitch classes in the set (the population count).

pub fn interval_vector(self) -> IntervalVector

Returns the IntervalVector tallying interval classes among the set’s pitch classes.

Trait Implementations

impl Clone for PitchClassMask

fn clone(&self) -> PitchClassMask

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PitchClassMask

impl Debug for PitchClassMask

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

Formats the value using the given formatter.

impl Default for PitchClassMask

fn default() -> PitchClassMask

Returns the “default value” for a type.

impl Eq for PitchClassMask

impl Hash for PitchClassMask

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PitchClassMask

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PitchClassMask