Struct TabChord 

pub struct TabChord {

    pub version: Version,
    pub chord: String,
    pub numeral: String,
    pub relativeroot: Option<String>,
    pub form: Option<String>,
    pub figbass: Option<String>,
    pub changes: Option<String>,
    pub phraseend: Option<String>,
    pub pedal: Option<String>,
    pub local_key: String,
    pub global_key: String,
    pub beat: FloatType,
    pub measure: i32,
    pub timesig: String,
    pub volta: Option<String>,
    pub length: Option<FloatType>,
    pub extra: Vec<(String, String)>,
}

One row of a DCML table, read: music21’s TabChord and TabChordV2.

The columns of the two standards differ in their names and in what they carry, and a row of either is read into this one type – what the lab’s version 1 calls measure and beat its version 2 calls mn and mn_onset, and counts the onset in whole notes rather than in beats. Every column the standard does not name is kept beside the row, as music21 keeps its extra.

Fields

version: Version

Which standard the row was read in.

chord: String

The label the annotator wrote: the lab’s chord.

numeral: String

The degree alone.

relativeroot: Option<String>

The degree the chord is read in, written after a slash.

form: Option<String>

o, +, % or M: how the chord is built over the degree.

figbass: Option<String>

The figured bass under it.

changes: Option<String>

The tones it adds or leaves out.

phraseend: Option<String>

Whether a phrase ends here.

pedal: Option<String>

The note held under it.

local_key: String

The key in force, as a degree of the global key or as a key.

global_key: String

The key the piece is in.

beat: FloatType

The beat of the measure the chord falls on, counted from one.

measure: i32

The measure it falls in.

timesig: String

The meter in force, as a ratio.

volta: Option<String>

Which time through a repeat the row belongs to, where the lab’s version 2 says.

length: Option<FloatType>

How long the chord sounds, where the lab’s version 1 says.

extra: Vec<(String, String)>

Every other column of the row, by name.

Implementations

impl TabChord

pub fn from_row( header: &[String], row: &[String], version: Version, ) -> Result<Self>

A row read against a table’s own header: music21’s populateFromRow, which reads the columns its standard names and keeps the rest beside them.

pub fn key(&self) -> Result<Key>

The key the chord is read in: the local key as a key of its own, where the table wrote it as a degree of the global key.

Errors

A local key that names no major or minor triad of the global one.

pub fn element(&self) -> Result<StreamElement>

The chord the row stands for: a numeral in the key in force, or the chord of no harmony the lab writes @none.

The sixth and the seventh of a minor key are read flat, as music21 reads a table’s.

Errors

A label or a key the crate cannot read.

Trait Implementations

impl Clone for TabChord

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TabChord

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

Formats the value using the given formatter.

impl Default for TabChord

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TabChord

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 TabChord

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TabChord

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 TabChord