azo 0.0.9

Library for interacting with ASIO drivers
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use std::ffi::{CString, c_long};
use std::num::NonZeroI32;
use crate::utils::cstring_from_bytes_until_nul;
use azo_sys as sys;

#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct ChannelCounts {
    pub in_: c_long,
    pub out: c_long
}

#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct Latencies {
    pub in_: c_long,
    pub out: c_long
}

#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct SamplePosition {
    pub position: sys::Samples,
    pub time_stamp: sys::TimeStamp
}

impl From<SamplePosition> for sys::Time {
    fn from(pos: SamplePosition) -> Self {
        Self {
            _reserved: [0; 4],
            time_info: sys::TimeInfo {
                speed          : Default::default(), // not marked valid
                system_time    : pos.time_stamp,
                sample_position: pos.position,
                sample_rate    : Default::default(), // not marked valid
                flags          : sys::TimeInfoFlags::SYSTEM_TIME_VALID
                               | sys::TimeInfoFlags::SAMPLE_POSITION_VALID,
                _reserved      : [0; 12]
            },
            time_code: sys::TimeCode::invalid()
        }
    }
}

#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct ChannelInfoResponse {
    pub is_active  : bool,
	pub group      : sys::ChannelGroupIndex,
	pub sample_type: sys::SampleType,
	pub name       : CString
}

impl From<sys::ChannelInfo> for ChannelInfoResponse {
    fn from(value: sys::ChannelInfo) -> Self {
        Self {
            is_active  : value.is_active.try_into().unwrap_or(false),
            group      : value.channel_group,
            sample_type: value.sample_type,
            name       : cstring_from_bytes_until_nul(&value.name)
        }
    }
}

/// Technically, [`Self::min`] and [`Self::max`] should be guarded by the same [`Option`] as [`Self::granularity`],
/// as the spec states that `min == max` requires `granularity == 0`.
/// Practically however:
/// 1. Even Steinberg's own "built-in" driver violates this requirement, which sets a problematic precedent
/// 2. The spec unfortunately fails to state the inverse, which technically allows `granularity == 0`
///    as an alternative expression of `granularity == max - min`, when `min != max`.
///    (This would translate to "only the minimum and maximum exactly are supported")
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct BufferSize {
    pub min: i32,
    pub max: i32,
    pub preferred: i32,
    pub granularity: Option<Granularity>
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum Granularity {
    /// Supported buffer sizes increase in linear steps (`range.start` + n * `step`)
    Linear { step: NonZeroI32 },
    /// Supported buffer sizes increase in powers of 2 (min * 2^n)
    Exponential
}

impl From<NonZeroI32> for Granularity {
    fn from(step: NonZeroI32) -> Self {
        if step.get() == -1 {
            Self::Exponential
        } else {
            Self::Linear { step }
        }
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct ChannelId {
    pub input: bool,
    pub index: sys::ChannelIndex
}