Struct Player 

pub struct Player<T: Timer, C: Connection> {
    pub con: C,
    /* private fields */
}

A type that orchestrates playing of MIDI tracks.

Player is a struct with two requirements:

• A Timer for properly timing a sleep.
• A Connection to send the MIDI events when they are ready to play.

So, Player is the glue that binds timing and playback.

This type is more of a convenience struct; it cannot possibly satisfy all use cases.

Implementation Details

In this section, the "track" refers to either a Sheet or a slice of Moments.

This type orchestrates playback of tracks. There are some things that are assumed:

1. Every moment in the given sheet is offset by exactly 1 MIDI tick.
2. The provided Timer is assumed to be aware of #1 above.

The implementation of Player::play is roughly as follows:

1. Initialize a counter that increments by 1 every tick and resets to 0 wwhenever there is a non-empty Moment.
2. Start iterating over the provided track, incrementing the counter every iteration (tick).
3. Whenever the iterated value is a non-empty Moment, check to see if there are any tempo change events.
4. If the event is a tempo change, call Timer::change_tempo, if it’s a MIDI event, call Connection::play.
5. Repeat until the iteration is complete.

Fields

con: C

An active midi connection.

Implementations

impl<T: Timer, C: Connection> Player<T, C>

pub fn new(timer: T, con: C) -> Self

Creates a new Player with the given Timer and Connection.

pub fn set_timer(&mut self, timer: T) -> T

Changes self.timer, returning the old one.

pub fn play(&mut self, sheet: &[Moment]) -> bool

Plays the given Moment slice.

Notes

The tempo change events are handled by self.timer and playing sound by self.con.

Stops playing if Connection::play returns false. Returns true if the track is played through the end, false otherwise.