Struct PercussionChord 

pub struct PercussionChord { /* private fields */ }

Several strokes at once, as a hi-hat over a bass drum: music21’s percussion.PercussionChord.

It is not a harmony and answers none of a chord’s harmonic questions; its members stay in the order given.

use music21_rs::percussion::{PercussionChord, PercussionNote, Unpitched};
use music21_rs::Note;

let chord = PercussionChord::new(vec![
    Unpitched::from_display_name("E3")?.into(),
    Note::from_name("G4")?.into(),
])?;
assert_eq!(chord.len(), 2);
assert!(chord.is_unpitched(0) && !chord.is_unpitched(1));
assert_eq!(chord.pitches().len(), 1);

Implementations

impl PercussionChord

pub fn new(members: Vec<PercussionNote>) -> Result<Self>

A chord of these members, in this order.

pub fn len(&self) -> usize

How many members it has.

pub fn is_empty(&self) -> bool

Whether it has no members.

pub fn is_unpitched(&self, index: usize) -> bool

Whether the member at this place has no pitch.

pub fn members(&self) -> Vec<PercussionNote>

The members, in order.

pub fn pitches(&self) -> Vec<Pitch>

The pitches of the members that have one: music21’s pitches.

pub fn duration(&self) -> Option<&Duration>

How long it lasts, where that has been said.

pub fn with_duration(self, duration: Duration) -> Self

The same chord lasting this long.

pub fn written(&self) -> &Chord

Everything written about the chord as a whole – its length, stem, beams, expressions – and about each member, as a chord of notes standing where the members are displayed. It is a carrier of notation: its harmony means nothing.

pub fn written_mut(&mut self) -> &mut Chord

What is written about the chord, for editing. Adding or removing notes here is not supported: build a new chord instead.

Trait Implementations

impl Clone for PercussionChord

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 PercussionChord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PercussionChord

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 From<PercussionChord> for StreamElement

fn from(value: PercussionChord) -> Self

Converts to this type from the input type.

impl Serialize for PercussionChord

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.