xmrsplayer 0.13.2

XMrsPlayer is a safe no-std soundtracker music player
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! Player-side gate for humanisation of [`Track::Euclidean`] pulses.
//!
//! The Track owns the *shape* (`humanize_probability` and
//! `humanize_advance_max_ticks` on [`Track::Euclidean`]); the player
//! owns the *execution* — whether and how to draw randomness for
//! each pulse.
//!
//! Default is [`HumanizeMode::Disabled`](crate::humanize::HumanizeMode::Disabled):
//! the player ignores the humanisation parameters and stays strictly
//! cycle-exact.
//!
//! [`Track::Euclidean`]: xmrs::core::daw::track::Track::Euclidean

/// Player-side humanisation policy.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum HumanizeMode {
    /// The player ignores `Track::Euclidean` humanisation parameters.
    /// Output is strictly deterministic and cycle-exact — default
    /// for tests and offline rendering oracles.
    #[default]
    Disabled,
    /// Fresh entropy per playback: every render of the same module
    /// sounds slightly different. The exact seed source is
    /// unspecified (the player picks one); not reproducible.
    Live,
    /// Apply humanisation with a caller-supplied seed. Same seed →
    /// same rendered output.
    Deterministic(u32),
}