session

use superb::primitives::session::TrackKind;
use superb::primitives::transport::{LoopRange, TempoChange};
use superb::primitives::{BeatPosition, Result, SampleRate, TimePosition, TimeSignature};
use superb::session::Root;
use superb::{clip, marker, session, track};

fn main() -> Result<()> {
    let rate = SampleRate::HZ_48K;
    let folder = Root::default().folder("My Show");            // ~/superb/My Show/
    let mut session = session::create(&folder, rate, 256)?;

    let vox = track::add(&mut session, "vox", TrackKind::Audio)?;
    let vocal = session::import_audio(&mut session, "/music/vocal.wav")?;   // audio/vocal.wav
    clip::add(&mut session, vox, vocal.key, TimePosition::ZERO)?;

    session::set_tempo(&mut session, 100.0)?;
    session::tempo_change(&mut session, BeatPosition::new(16.0), Some(TempoChange::Step(120.0)))?;   // faster from bar 5
    session::tempo_change(&mut session, BeatPosition::new(32.0), Some(TempoChange::Ramp(120.0)))?;   // from bar 9, gliding
    session::tempo_change(&mut session, BeatPosition::new(48.0), Some(TempoChange::Step(90.0)))?;    // down to 90 at bar 13
    session::meter_change(&mut session, 9, Some(TimeSignature::new(6, 8)?))?;     // 6/8 from bar 9
    let range = LoopRange::new(TimePosition::ZERO, TimePosition::from_seconds(8.0, rate))?;
    session::set_loop(&mut session, Some(range))?;

    marker::add(&mut session, "verse", TimePosition::from_seconds(8.0, rate))?;
    session::undo(&mut session)?;                                // the marker is gone
    session::redo(&mut session)?;                                // and back

    let layout = session::layout(&session);
    session::state_file(&mut session, Some(layout.state()))?;   // keep mute, solo, arm, the playhead
    session::save(&mut session)?;

    let again = session::open(&folder, 256)?;
    println!("{}: {} tracks", again.memory.name(), again.memory.track_count());
    Ok(())
}

~/superb/                 Root::default(); Root::new(path) for anywhere else
  My Show/              Root::folder("My Show"): what create and open take
    memory.json         the edits
    state.json          the state, once state_file names it
    audio/              what clips play: imports and recordings, 32-bit float WAV
    bounces/            export::bounce
    stems/<name>/       export::stems, with manifest.json