audiofp 0.4.0

Pure-Rust audio fingerprinting: Wang, Panako, Haitsma–Kalker with streaming, in-memory matching, ONNX neural/watermark, no_std + alloc, Pod hash types.
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

//! Audio file I/O helpers.
//!
//! Available only when at least one per-codec feature is enabled
//! (`std-wav`, `std-mp3`, `std-flac`, `std-ogg`, `std-aac`, `std-mp4`,
//! `std-aiff`, `std-mkv`, `std-adpcm`, `std-alac`), or `all-codecs` for
//! every codec at once. Each sub-feature pulls the matching Symphonia
//! decoder; the bare `std` feature alone enables no codecs and produces a
//! compile error if you try to use this module. Wraps Symphonia's probe →
//! format-reader → decoder pipeline behind simple,
//! allocation-conservative helpers:
//!
//! - [`decode_to_mono`] — decode a file at its native sample rate.
//! - [`decode_to_mono_at`] — decode and resample to a target rate in one
//!   step, using `audiofp`'s built-in [`SincResampler`].
//! - [`decode_to_mono_limited`] / [`decode_to_mono_at_limited`] — same as
//!   above with on-disk and/or decoded-PCM caps for untrusted uploads.
//!
//! Both helpers return mono `f32` PCM in `[-1.0, 1.0]` (multi-channel
//! files are downmixed by averaging channels per frame), ready to feed
//! into any [`Fingerprinter`].
//!
//! Supported formats are whatever Symphonia provides with the codec
//! features enabled in `audiofp`'s `Cargo.toml`: MP3, FLAC, WAV,
//! OGG-Vorbis, AAC-in-MP4, raw PCM, plus AIFF / Matroska / ADPCM / ALAC
//! behind their respective extra features.
//!
//! [`Fingerprinter`]: crate::Fingerprinter
//! [`SincResampler`]: crate::dsp::resample::SincResampler

pub mod decoder;

pub use decoder::{
    DecodeLimits, decode_to_mono, decode_to_mono_at, decode_to_mono_at_limited,
    decode_to_mono_limited,
};