Struct Spanner 

pub struct Spanner { /* private fields */ }

A mark joining several notes: music21’s Spanner.

Implementations

impl Spanner

pub fn new(kind: SpannerKind, spanned: Vec<usize>) -> Self

A spanner of a kind joining the elements at these positions.

pub fn with_unplaced(kind: SpannerKind, spanned: Vec<Option<usize>>) -> Self

A spanner of a kind joining elements some of which stand nowhere: a score read from a file may leave a spanner holding a note no stream holds. It still counts that note among its own, so the ends and the length are those of the whole list.

pub fn glissando(spanned: Vec<usize>) -> Self

A glissando over the elements at these positions, drawn as a wavy line and played chromatically, as music21’s starts out.

pub fn glissando_details(&self) -> Option<&Glissando>

How a glissando is played and what is written along it.

pub fn set_glissando_details(&mut self, glissando: Option<Glissando>)

Says how a glissando is played and what is written along it.

pub fn tremolo(marks: u8, spanned: Vec<usize>) -> Result<Self>

A tremolo alternating between the elements at these positions, with so many strokes through the stems.

Errors

More than eight strokes, as music21’s TremoloException.

pub fn number_of_marks(&self) -> Option<u8>

How many strokes a tremolo between notes is written with: music21’s numberOfMarks.

pub fn set_number_of_marks(&mut self, marks: Option<u8>) -> Result<()>

Says how many strokes a tremolo between notes is written with.

Errors

More than eight, as music21’s TremoloException.

pub fn offset(&self) -> FloatType

Where the spanner itself stands in the stream holding it: nought for one a score is read with. A pedal mark drawn as a sign and a line says where its line resumes by it.

pub fn set_offset(&mut self, offset: FloatType)

Says where the spanner itself stands in the stream holding it.

pub fn arpeggio_mark(arpeggio: ArpeggioType, spanned: Vec<usize>) -> Self

One arpeggio across the chords at these positions.

pub fn arpeggio(&self) -> ArpeggioType

Which way an arpeggio across several chords is spread.

pub fn set_arpeggio(&mut self, arpeggio: ArpeggioType)

Says which way an arpeggio across several chords is spread.

pub fn line(spanned: Vec<usize>) -> Self

A line over the elements at these positions, solid with a tick down at each end, as music21’s starts out.

pub fn ends(&self) -> LineEnds

How a line’s ends are drawn.

pub fn set_ends(&mut self, ends: LineEnds)

Says how a line’s ends are drawn.

pub fn pedal_mark(pedal: Pedal, spanned: Vec<usize>) -> Self

A pedal held under the elements at these positions.

pub fn pedal(&self) -> Option<Pedal>

Which pedal a pedal mark holds and how it is drawn.

pub fn set_pedal(&mut self, pedal: Option<Pedal>)

Says which pedal a pedal mark holds and how it is drawn.

pub fn ottava(shift: OctaveShift, spanned: Vec<usize>) -> Self

An octave line over the elements at these positions, drawn above them as music21’s starts out.

pub fn shift(&self) -> Option<OctaveShift>

How far and which way an octave line moves its notes.

pub fn set_shift(&mut self, shift: Option<OctaveShift>)

Says how far and which way an octave line moves its notes.

pub fn slur(spanned: Vec<usize>) -> Self

A slur over the elements at these positions.

pub fn wedge(kind: SpannerKind, spanned: Vec<usize>) -> Self

A hairpin over the elements at these positions, drawn below them and opening fifteen tenths wide, as music21’s starts out.

pub fn spread(&self) -> Option<FloatType>

How wide a hairpin opens, in tenths of a staff space: music21’s spread.

pub fn set_spread(&mut self, spread: Option<FloatType>)

Says how wide a hairpin opens.

pub fn kind(&self) -> SpannerKind

Which kind of spanner this is.

pub fn spanned(&self) -> &[Option<usize>]

The positions of the elements it joins, first to last, nothing for one that stands in no stream.

pub fn len(&self) -> usize

How many elements it joins, those standing nowhere included.

pub fn is_empty(&self) -> bool

Whether it joins nothing at all.

pub fn is_first(&self, position: usize) -> bool

Whether the element at a position is the first it joins: music21’s isFirst.

pub fn is_last(&self, position: usize) -> bool

Whether the element at a position is the last it joins: music21’s isLast.

pub fn placement(&self) -> Option<Placement>

Which side of the notes it is drawn on, where the score says.

pub fn set_placement(&mut self, placement: Option<Placement>)

Says which side of the notes it is drawn on.

pub fn line_type(&self) -> Option<&str>

How its line is drawn where that is not solid, dashed or dotted: music21’s style.lineType.

pub fn set_line_type(&mut self, line_type: Option<String>)

Says how its line is drawn.

Trait Implementations

impl Clone for Spanner

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 Spanner

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Spanner

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 Eq for Spanner

impl PartialEq for Spanner

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Spanner

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 Spanner