simple_decoder 0.1.2

The ULTIMATE lightest audio decoding in Rust: Symphonia + Rubato under the hood.
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

# Simple Decoder


Rust-крейт для **МАКСИМАЛЬНО** лёгкого декодирования и обработки аудио.

## Quick Start


Всё, что нужно для счастья:

```rust
use simple_decoder::SimpleDecoder;
use simple_decoder::decoders::AudioDecoder;

fn main() {
    let data = std::fs::read("melody.mp3").expect("Не удалось прочитать файл");
    let decoder = SimpleDecoder::new();
    
    // Декодируем, ресемплим в 48кГц и переводим в моно одной цепочкой
    let track = decoder.decode(&data).unwrap()
        .resample(48000).unwrap()
        .rechannel(1);
        
    println!("Готово: {} сэмплов", track.pcm.len());
}
```

## Основные сущности


  * **`SimpleDecoder`** — универсальный комбайн. Находится в корне, сам определяет формат файла.
  * **`.decode(&[u8])`** — основной метод, возвращает структуру `AudioTrack`.
  * **`AudioTrack`** — контейнер с сырыми данными (`f32`) и методами трансформации.

-----

## Архитектура проекта


Библиотека построена на базе `symphonia` (декодинг) и `rubato` (ресемплинг).

  * `SimpleDecoderError` — перечисление всех возможных бед.
  * `SimpleDecoder` — точка входа.
  * `audio`:
      * `AudioTrack` — структура с PCM-данными.
      * `AudioFormat` — перечисление форматов (MP3, WAV, FLAC и т.д.).
  * `decoders` (специализированные декодеры):
      * `aac` : `AACDecoder`
      * `flac` : `FLACDecoder`
      * `mp3` : `MP3Decoder`
      * `oggopus` : `OGGOpusDecoder`
      * `oggvorbis` : `OGGVorbisDecoder`
      * `simple` : `SimpleDecoder`
      * `wav` : `WAVDecoder`

-----

## Powerful Transformations


После декодирования доступен **Chain API** для подготовки аудио к воспроизведению:

```rust
let track = decoder.decode(&data)?
    .resample(48000)?  // Высококачественный FFT ресемплинг
    .rechannel(2);     // Изменение количества каналов
```

### Методы `AudioTrack`


| Метод | Описание |
| :--- | :--- |
| `.resample(target_rate)` | Изменяет частоту дискретизации. Использует Sinc-интерполяцию (FFT). |
| `.rechannel(target_channels)` | Изменяет кол-во каналов. Считает среднее при Downmix (Stereo -\> Mono). |
| `.pcm` | Прямой доступ к `Vec<f32>` (Interleaved PCM). |
| `.format` | Возвращает исходный формат файла (`AudioFormat`). |
| `.channels` | Текущее количество каналов (`u16`). |
| `.sample_rate` | Текущая частота дискретизации (`u64`). |

-----

## Лицензия


Максимально просто — [MIT](./LICENSE).