Struct ThirdStackSignature 

pub struct ThirdStackSignature {
    pub root: PitchClass,
    pub steps: Vec<ThirdStep>,
    pub guard: bool,
}

A chord described as a root pitch class plus an ordered stack of third ThirdSteps.

This tertian encoding captures triads, sevenths, and extended chords as a sequence of stacked thirds, with run-length limits that reject implausible stacks.

Fields

root: PitchClass

The pitch class at the bottom of the stack.

steps: Vec<ThirdStep>

The ordered thirds stacked above the root.

guard: bool

A guard bit reserved by the bit encoding to mark the end of the step run.

Implementations

impl ThirdStackSignature

pub fn validate(&self) -> Result<(), PitchSetError>

Validates the step run, rejecting four consecutive minor thirds or three consecutive major thirds.

pub fn encode(&self) -> Result<u32, PitchSetError>

Encodes this signature into a compact u32, validating it first.

pub fn decode(encoded: u32) -> Result<Self, PitchSetError>

Decodes a u32 produced by ThirdStackSignature::encode back into a validated signature.

pub fn family_tag(&self) -> char

Returns a single-character family tag classifying the stack by its count of major thirds.

pub fn to_mask(&self) -> PitchClassMask

Realizes the stacked thirds into the PitchClassMask of the chord’s pitch classes.

Trait Implementations

impl Clone for ThirdStackSignature

fn clone(&self) -> ThirdStackSignature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThirdStackSignature

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

Formats the value using the given formatter.

impl Eq for ThirdStackSignature

impl Hash for ThirdStackSignature

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 ThirdStackSignature

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