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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

use std::ffi::CString;
use std::sync::Once;

#[allow(dead_code)]
#[allow(non_camel_case_types)]
#[allow(non_upper_case_globals)]
mod bindings;

/// PAT Audio Technician (PAT)
pub struct PAT {}

static INIT: Once = Once::new();
static mut INIT_RESULT: Result<(), PATError> = Err(PATError::UnknownError);

impl PAT {
    /// Creates a new PAT instance and initializes PAT if it has already been initialized.
    ///
    /// # Examples
    /// ```
    /// rustpat::PAT::new().unwrap();
    /// ```
    pub fn new() -> Result<PAT, PATError> {
        unsafe {
            INIT.call_once(|| {
                let result = PATError::from_pat_result(bindings::pat_init());

                match result {
                    Ok(_) => INIT_RESULT = Ok(()),
                    Err(error) => INIT_RESULT = Err(error),
                }
            });

            match INIT_RESULT {
                Ok(_) => Ok(PAT {}),
                Err(error) => Err(error),
            }
        }
    }

    /// Play an audio file.
    ///
    /// The audio file can be a local file or remote file (http:// or https://).
    ///
    /// # Examples
    /// ```
    /// let pat = rustpat::PAT::new().unwrap();
    /// let test_audio = format!("{}/src/libpat/test/test.ogg", env!("CARGO_MANIFEST_DIR"));
    /// pat.play(&test_audio).unwrap();
    /// ```
    pub fn play(&self, pat_audio_path: &str) -> Result<(), PATError> {
        let pat_audio_path = match CString::new(pat_audio_path) {
            Ok(pat_audio_path) => pat_audio_path,
            Err(_) => return Err(PATError::UnknownError),
        };

        let result;

        unsafe {
            result = bindings::pat_play(pat_audio_path.as_ptr());
        }

        PATError::from_pat_result(result)
    }

    /// Skip playback of the current audio file.
    ///
    /// This method does nothing if there is not an audio file playing.
    ///
    /// # Examples
    /// ```
    /// let pat = rustpat::PAT::new().unwrap();
    /// pat.skip().unwrap();
    /// ```
    pub fn skip(&self) -> Result<(), PATError> {
        let result;

        unsafe {
            result = bindings::pat_skip();
        }

        PATError::from_pat_result(result)
    }

    /// Pause audio playback.
    ///
    /// This method does nothing if audio playback is already paused.
    ///
    /// # Examples
    /// ```
    /// let pat = rustpat::PAT::new().unwrap();
    /// pat.pause().unwrap();
    /// ```
    pub fn pause(&self) -> Result<(), PATError> {
        let result;

        unsafe {
            result = bindings::pat_pause();
        }

        PATError::from_pat_result(result)
    }

    /// Resume audio playback.
    ///
    /// This method does nothing if audio playback is already resumed.
    ///
    /// # Examples
    /// ```
    /// let pat = rustpat::PAT::new().unwrap();
    /// pat.resume().unwrap();
    /// ```
    pub fn resume(&self) -> Result<(), PATError> {
        let result;

        unsafe {
            result = bindings::pat_resume();
        }

        PATError::from_pat_result(result)
    }
}

#[derive(Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
pub enum PATError {
    AudioDeviceError,
    DemuxError,
    DecodeError,
    FileOpenError,
    InterruptedError,
    MemoryError,
    ResampleError,
    TerminatedError,
    UnknownError,
}

impl PATError {
    fn from_pat_result(pat_result: bindings::PATError) -> Result<(), PATError> {
        match pat_result {
            bindings::PATError_PAT_SUCCESS => Ok(()),
            bindings::PATError_PAT_AUDIO_DEVICE_ERROR => Err(PATError::AudioDeviceError),
            bindings::PATError_PAT_DEMUX_ERROR => Err(PATError::DemuxError),
            bindings::PATError_PAT_DECODE_ERROR => Err(PATError::DecodeError),
            bindings::PATError_PAT_FILE_OPEN_ERROR => Err(PATError::FileOpenError),
            bindings::PATError_PAT_INTERRUPTED_ERROR => Err(PATError::InterruptedError),
            bindings::PATError_PAT_MEMORY_ERROR => Err(PATError::MemoryError),
            bindings::PATError_PAT_RESAMPLE_ERROR => Err(PATError::ResampleError),
            bindings::PATError_PAT_TERMINATED_ERROR => Err(PATError::TerminatedError),
            _ => Err(PATError::UnknownError),
        }
    }
}