audio-device 0.1.0-alpha.6

A library for interacting with audio devices
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
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

use crate::alsa::{Access, Result};
use crate::libc as c;
use alsa_sys as alsa;
use std::mem;
use std::ptr;

/// Access mask used in combination with hardware parameters.
///
/// # Examples
///
/// ```rust
/// use audio_device::alsa;
///
/// # fn main() -> anyhow::Result<()> {
/// let mut mask = alsa::AccessMask::new()?;
/// assert!(!mask.test(alsa::Access::MmapInterleaved));
/// assert!(mask.is_empty());
///
/// mask.set(alsa::Access::MmapInterleaved);
/// assert!(!mask.is_empty());
/// assert!(mask.test(alsa::Access::MmapInterleaved));
///
/// mask.reset(alsa::Access::MmapInterleaved);
/// assert!(!mask.test(alsa::Access::MmapInterleaved));
/// assert!(mask.is_empty());
/// # Ok(()) }
/// ```
pub struct AccessMask {
    pub(super) handle: ptr::NonNull<alsa::snd_pcm_access_mask_t>,
}

impl AccessMask {
    /// Construct a new empty access mask.
    ///
    /// # Examples
    ///
    /// ```rust
    /// use audio_device::alsa;
    ///
    /// # fn main() -> anyhow::Result<()> {
    /// let mut mask = alsa::AccessMask::new()?;
    /// assert!(!mask.test(alsa::Access::MmapInterleaved));
    /// # Ok(()) }
    /// ```
    pub fn new() -> Result<Self> {
        unsafe {
            let mut mask = Self::allocate()?;
            alsa::snd_pcm_access_mask_none(mask.handle.as_mut());
            Ok(mask)
        }
    }

    /// Allocate a new access mask. The state of it will be uninitialized.
    pub(super) unsafe fn allocate() -> Result<Self> {
        let mut handle = mem::MaybeUninit::uninit();
        errno!(alsa::snd_pcm_access_mask_malloc(handle.as_mut_ptr()))?;
        let handle = ptr::NonNull::new_unchecked(handle.assume_init());
        Ok(Self { handle })
    }

    /// Test if mask is empty.
    ///
    /// See [AccessMask] documentation.
    pub fn is_empty(&self) -> bool {
        unsafe { alsa::snd_pcm_access_mask_empty(self.handle.as_ptr()) == 1 }
    }

    /// Set all bits.
    ///
    /// See [AccessMask] documentation.
    pub fn any(&mut self) {
        unsafe {
            alsa::snd_pcm_access_mask_any(self.handle.as_mut());
        }
    }

    /// Reset all bits.
    ///
    /// See [AccessMask] documentation.
    pub fn none(&mut self) {
        unsafe {
            alsa::snd_pcm_access_mask_none(self.handle.as_mut());
        }
    }

    /// Make an access type present.
    ///
    /// See [AccessMask] documentation.
    pub fn set(&mut self, access: Access) {
        unsafe {
            alsa::snd_pcm_access_mask_set(self.handle.as_mut(), access as c::c_uint);
        }
    }

    /// Make an access type missing.
    ///
    /// See [AccessMask] documentation.
    pub fn reset(&mut self, access: Access) {
        unsafe {
            alsa::snd_pcm_access_mask_reset(self.handle.as_mut(), access as c::c_uint);
        }
    }

    /// Test the presence of an access type.
    ///
    /// See [AccessMask] documentation.
    pub fn test(&mut self, access: Access) -> bool {
        unsafe { alsa::snd_pcm_access_mask_test(self.handle.as_mut(), access as c::c_uint) == 1 }
    }

    /// Copy one mask to another.
    pub fn copy(&mut self, other: &Self) {
        unsafe {
            alsa::snd_pcm_access_mask_copy(self.handle.as_mut(), other.handle.as_ptr());
        }
    }
}

impl Drop for AccessMask {
    fn drop(&mut self) {
        unsafe {
            let _ = alsa::snd_pcm_access_mask_free(self.handle.as_mut());
        }
    }
}