Struct Duration 

pub struct Duration {
    pub numerator: Numerator,
    pub denominator: Denominator,
    pub dots: Dots,
}

Represents the duration of a musical note.

A duration combines:

• Numerator: The note type (whole, half, quarter, etc.)
• Denominator: The tuplet grouping (2 = normal, 3 = triplet, etc.)
• Dots: Number of dots extending the duration

Examples

// Quarter note
let quarter = Duration::new(
    Numerator::Quarter,
    Denominator::from_value(2).unwrap(),
    Dots::ZERO
);
assert_eq!(quarter.tick_length(), 240);

// Dotted quarter note
let dotted_quarter = Duration::new(
    Numerator::Quarter,
    Denominator::from_value(2).unwrap(),
    Dots::ONE
);
assert_eq!(dotted_quarter.tick_length(), 360);

Fields

numerator: Numerator

The note type (whole, half, quarter, etc.).

denominator: Denominator

The tuplet denominator (2 = normal, 3 = triplet, etc.).

dots: Dots

The number of dots (0-7).

Implementations

impl Duration

pub const TICK_RESOLUTION: i32 = 240i32

Ticks per quarter note (MIDI standard).

pub const MAX_TICK_LENGTH: i32 = 1_920i32

Maximum tick length (whole note * 2).

pub const MIN_DENOMINATOR: u8 = 2u8

Minimum denominator value.

pub const MAX_DENOMINATOR: u8 = 255u8

Maximum denominator value.

pub const MAX_DOT: u8 = 7u8

Maximum number of dots.

pub const MAX_NUMERATOR: u8 = 7u8

Maximum numerator ordinal.

pub fn new( numerator: Numerator, denominator: Denominator, dots: Dots, ) -> Duration

Creates a new duration.

Arguments

• numerator - The note type.
• denominator - The tuplet denominator.
• dots - The number of dots.

pub const fn tick_length(self) -> u32

Calculates the duration in ticks.

Returns

The duration in ticks, accounting for note type, tuplets, and dots.

pub fn with_numerator(self, numerator: Numerator) -> Duration

Creates a new duration with a different numerator.

pub fn with_denominator(self, denominator: Denominator) -> Duration

Creates a new duration with a different denominator.

pub fn with_dots(self, dots: Dots) -> Duration

Creates a new duration with a different number of dots.

pub fn min(self, other: Self) -> Self

Returns the shorter of two durations.

Trait Implementations

impl Clone for Duration

fn clone(&self) -> Duration

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Duration

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

Formats the value using the given formatter.

impl Default for Duration

fn default() -> Duration

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Duration

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for Duration

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 Duration

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Duration

impl Eq for Duration

impl StructuralPartialEq for Duration