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
70
71
72
73

//! Command line argument parser using [clap](https://docs.rs/clap/latest/clap/) for CyberGrape

use clap::{Args, Parser, Subcommand};

/// The high-level argument struct for CyberGrape
#[derive(Debug, Parser, Clone)]
#[clap(version, about)]
pub struct GrapeArgs {
    #[command(subcommand, long_about)]
    /// Which task to perform, serialization or binauralization
    pub command: CommandTask,

    /// How often the location of the audio blocks are sampled, in updates per second
    #[arg(short = 'u', long = "update")]
    pub update_rate: usize,
}

/// A selector for wether we want to binauralize a file or generate positional data
#[derive(Debug, Subcommand, Clone)]
pub enum CommandTask {
    /// Encode positional data to a file in the GrapeFile format
    #[command(about)]
    Serial(SerialCommand),

    /// Combine N audio samples into a binauralized WAV file
    #[command(about)]
    Binaural(BinauralCommand),
}

/// The arguments needed to generate positional data
#[derive(Debug, Args, Clone)]
#[command(version, about)]
pub struct SerialCommand {
    /// Filename for serialization output to be written to
    #[arg(short = 'o', long = "out")]
    pub outfile: String,

    /// Number of tags to record spatial data from
    #[arg(short)]
    pub num_tags: usize,
}

/// The arguments needed to binauralize sounds
#[derive(Debug, Args, Clone)]
#[command(version, about)]
pub struct BinauralCommand {
    /// Number of input files to be assigned to audio blocks
    #[arg(short)]
    pub num_files: usize,

    /// Filename for binaural audio data to be written to
    #[arg(short = 'o', long = "out")]
    pub outfile: String,

    /// Sample rate of the audio files, in gHz. Defaults to 44100
    #[arg(short = 's', long = "samp", default_value_t = 44100)]
    pub samp_rate: usize,

    /// List of filenames, which should correspond to the number of input files
    #[arg(short = 'f', long = "files")]
    #[clap(num_args = 1..)]
    pub filenames: Vec<String>,

    /// List of gains, which should correspond to the input files given
    #[arg(short = 'g', long = "gains")]
    #[clap(num_args = 1..)]
    pub gains: Vec<f32>,

    /// List of ranges fields, which should correspond to the input files given
    #[arg(short = 'r', long = "ranges")]
    #[clap(num_args = 1..)]
    pub ranges: Vec<f32>,
}