symphonium 0.10.0

An unofficial easy-to-use wrapper around Symphonia for loading audio files
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

use std::error::Error;
use std::fmt;

#[derive(Debug)]
pub enum LoadError {
    FileNotFound(std::io::Error),
    UnkownFormat(symphonia::core::errors::Error),
    NoAudioTrackFound,
    TrackIndexOutOfBounds {
        index: usize,
        num_tracks: usize,
    },
    NoAudioChannelsFound,
    NoAudioCodecFound,
    UnkownSampleType,
    UnkownChannelFormat(usize),
    FileTooLarge(usize),
    CouldNotCreateDecoder(symphonia::core::errors::Error),
    ErrorWhileDecoding(symphonia::core::errors::Error),
    #[cfg(feature = "resampler")]
    InvalidResampler {
        needed_channels: usize,
        got_channels: usize,
    },
    #[cfg(feature = "resampler")]
    ErrorWhileResampling(fixed_resample::rubato::ResampleError),
}

impl Error for LoadError {}

impl fmt::Display for LoadError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        use LoadError::*;

        match self {
            FileNotFound(e) => write!(f, "File not found: {}", e),
            UnkownFormat(e) => write!(f, "Format not supported: {}", e),
            NoAudioTrackFound => write!(f, "No default audio track found"),
            TrackIndexOutOfBounds { index, num_tracks } => write!(
                f,
                "The track index {index} is out of bounds for media with {num_tracks} tracks"
            ),
            NoAudioChannelsFound => write!(f, "No audio channels found"),
            NoAudioCodecFound => write!(f, "No audio codec found"),
            UnkownSampleType => write!(f, "Unknown sample format"),
            UnkownChannelFormat(num_channels) => {
                write!(f, "Unkown channel format: {} channels found", num_channels)
            }
            FileTooLarge(max_bytes) => {
                write!(f, "File is too large: maximum is {} bytes", max_bytes)
            }
            CouldNotCreateDecoder(e) => write!(f, "Failed to create decoder: {}", e),
            ErrorWhileDecoding(e) => write!(f, "Error while decoding: {}", e),
            #[cfg(feature = "resampler")]
            InvalidResampler {
                got_channels,
                needed_channels,
            } => {
                write!(
                    f,
                    "Invalid custom resampler: Expected {} channels, got {} channels",
                    needed_channels, got_channels
                )
            }
            #[cfg(feature = "resampler")]
            ErrorWhileResampling(e) => write!(f, "Error while resampling: {}", e),
        }
    }
}

impl From<std::io::Error> for LoadError {
    fn from(e: std::io::Error) -> Self {
        Self::FileNotFound(e)
    }
}

#[cfg(feature = "resampler")]
impl From<fixed_resample::rubato::ResampleError> for LoadError {
    fn from(e: fixed_resample::rubato::ResampleError) -> Self {
        Self::ErrorWhileResampling(e)
    }
}