xmrsplayer 0.14.4

Safe, no_std SoundTracker music player — plays MOD/XM/S3M/IT/DW with cycle-accurate SID and OPL/AdLib FM synthesis.
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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

//! Diagnostic inspector for the DAW layer of an imported Module.
//!
//! Loads a `.xm` / `.mod` / `.s3m` / `.it` file via the standard
//! `Module::load` autodetection and prints a structural summary:
//! per-song length, instrument count, track and clip counts,
//! Euclidean tracks detected by `auto_convert_strict_euclidean_tracks`,
//! and the result of `verify_layers_consistent`.
//!
//! Useful when chasing import-time regressions ("which channel does
//! this module skip?", "is the timeline_map covering every order?").
//! Not part of the player runtime — gated behind the `demo` feature.
//!
//! ```text
//! cargo run --release --features=demo --example inspect_mod -- path/to/module.s3m
//! ```

use xmrs::core::daw::track::Track;
use xmrs::core::module::Module;

fn main() {
    let path = std::env::args()
        .nth(1)
        .expect("usage: inspect_mod <path-to-module>");
    let data = std::fs::read(&path).expect("read");
    let m = Module::load(&data).expect("load");

    println!("loaded {} — {:?}", path, m.name);
    println!("  default_tempo = {}", m.default_tempo);
    println!("  default_bpm   = {}", m.default_bpm);
    println!("  channels      = {}", m.get_num_channels());
    println!("  instruments   = {}", m.instrument.len());
    println!("  tracks        = {}", m.tracks.len());
    println!(
        "  Σ track rows  = {}",
        m.tracks
            .iter()
            .map(|t| t.rows().map(|r| r.len()).unwrap_or(0))
            .sum::<usize>()
    );
    println!("  clips         = {}", m.clips.len());
    println!("  timeline      = {} entries", m.timeline_map.entries.len());

    let euclidean = m
        .tracks
        .iter()
        .filter(|t| matches!(t, Track::Euclidean { .. }))
        .count();
    println!("  Euclidean tracks = {}", euclidean);

    let n_songs = m
        .timeline_map
        .entries
        .iter()
        .map(|e| e.song)
        .max()
        .map(|s| s as usize + 1)
        .unwrap_or(0);
    for song in 0..n_songs {
        let len = m.song_length(song);
        if len > 0 {
            println!("  song {}: {} orders", song, len);
        }
    }

    match m.verify_layers_consistent() {
        Ok(()) => println!("  verify        = ok"),
        Err(e) => println!("  verify        = FAILED: {:?}", e),
    }
}