azo 0.0.8

Re-implementation of ASIO (Audio Stream Input/Output)
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

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
}

#[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
}