Skip to main content

glint_audio_sys/
lib.rs

1//! Raw FFI bindings to the glint audio codec suite: MP3, AAC-LC, Opus,
2//! Ogg-Vorbis, FLAC, WAV and resampling. Mirrors `include/glint/glint.h`.
3//!
4//! This is the unsafe layer; see the `glint-audio` crate for the safe wrapper.
5#![allow(non_camel_case_types)]
6
7use std::os::raw::c_int;
8
9pub type glint_t = *mut std::ffi::c_void;
10
11#[repr(C)]
12pub struct glint_config {
13    pub sample_rate: c_int,
14    pub num_channels: c_int,
15    pub mode: c_int,
16    pub bitrate: c_int,
17    pub path: c_int,
18    pub simd: c_int,
19    // Missing from the original binding — the C struct has had these since
20    // the quality/VBR features landed; omitting them made glint_create read
21    // uninitialized memory. Keep in sync with include/glint/glint.h.
22    pub quality: c_int,
23    pub vbr: c_int,
24    pub vbr_quality: c_int,
25}
26
27#[repr(C)]
28pub struct glint_aac_config {
29    pub sample_rate: c_int,
30    pub num_channels: c_int,
31    pub bitrate: c_int,
32    pub quality: c_int,
33    pub vbr: c_int,         // 0 = CBR, 1 = constant-quality VBR
34    pub vbr_quality: c_int, // 0 (best) .. 9 (smallest), when vbr = 1
35    pub reserved: [c_int; 4], // must be zero
36}
37
38extern "C" {
39    pub fn glint_check_config(sample_rate: c_int, bitrate: c_int) -> c_int;
40    pub fn glint_create(cfg: *const glint_config) -> glint_t;
41    pub fn glint_samples_per_frame(enc: glint_t) -> c_int;
42    pub fn glint_encode(
43        enc: glint_t,
44        channel_data: *const *const i16,
45        out_size: *mut c_int,
46    ) -> *const u8;
47    pub fn glint_encode_float(
48        enc: glint_t,
49        channel_data: *const *const f32,
50        out_size: *mut c_int,
51    ) -> *const u8;
52    pub fn glint_encode_int32(
53        enc: glint_t,
54        channel_data: *const *const i32,
55        out_size: *mut c_int,
56    ) -> *const u8;
57    pub fn glint_flush(enc: glint_t, out_size: *mut c_int) -> *const u8;
58    pub fn glint_destroy(enc: glint_t);
59
60    // AAC-LC encoder (since 0.8)
61    pub fn glint_version() -> c_int;
62    pub fn glint_aac_create(cfg: *const glint_aac_config) -> glint_t;
63    pub fn glint_aac_samples_per_frame(enc: glint_t) -> c_int;
64    pub fn glint_aac_encode(
65        enc: glint_t,
66        channel_data: *const *const i16,
67        out_size: *mut c_int,
68    ) -> *const u8;
69    pub fn glint_aac_encode_float(
70        enc: glint_t,
71        channel_data: *const *const f32,
72        out_size: *mut c_int,
73    ) -> *const u8;
74    pub fn glint_aac_flush(enc: glint_t, out_size: *mut c_int) -> *const u8;
75    pub fn glint_aac_destroy(enc: glint_t);
76
77    // Opus codec (CELT encoder + full decoder)
78    pub fn glint_opus_enc_create(channels: c_int, bitrate_bps: c_int, vbr: c_int) -> glint_t;
79    pub fn glint_opus_encode(
80        enc: glint_t,
81        pcm: *const f32,
82        frame_size: c_int,
83        out: *mut u8,
84        max_bytes: c_int,
85    ) -> c_int;
86    pub fn glint_opus_enc_final_range(enc: glint_t) -> u32;
87    pub fn glint_opus_enc_destroy(enc: glint_t);
88
89    pub fn glint_opus_dec_create(channels: c_int, sample_rate: c_int) -> glint_t;
90    pub fn glint_opus_decode(
91        dec: glint_t,
92        packet: *const u8,
93        len: c_int,
94        pcm: *mut f32,
95        max_samples: c_int,
96    ) -> c_int;
97    pub fn glint_opus_decode_fec(
98        dec: glint_t,
99        packet: *const u8,
100        len: c_int,
101        pcm: *mut f32,
102        frame_size: c_int,
103    ) -> c_int;
104    pub fn glint_opus_dec_final_range(dec: glint_t) -> u32;
105    pub fn glint_opus_dec_destroy(dec: glint_t);
106
107    pub fn glint_opus_ms_dec_create(
108        channels: c_int,
109        streams: c_int,
110        coupled: c_int,
111        mapping: *const u8,
112        sample_rate: c_int,
113    ) -> glint_t;
114    pub fn glint_opus_ms_decode(
115        dec: glint_t,
116        packet: *const u8,
117        len: c_int,
118        pcm: *mut f32,
119        max_samples: c_int,
120    ) -> c_int;
121    pub fn glint_opus_ms_dec_destroy(dec: glint_t);
122
123    // MP3 + AAC decoders
124    pub fn glint_mp3_frame_info(data: *const u8, len: c_int, info: *mut GlintDecFrameInfo) -> c_int;
125    pub fn glint_aac_frame_info(data: *const u8, len: c_int, info: *mut GlintDecFrameInfo) -> c_int;
126    pub fn glint_mp3_dec_create() -> glint_t;
127    pub fn glint_mp3_decode(dec: glint_t, data: *const u8, len: c_int, pcm: *mut f32, info: *mut GlintDecFrameInfo) -> c_int;
128    pub fn glint_mp3_dec_destroy(dec: glint_t);
129    pub fn glint_aac_dec_create() -> glint_t;
130    pub fn glint_aac_decode(dec: glint_t, data: *const u8, len: c_int, pcm: *mut f32, info: *mut GlintDecFrameInfo) -> c_int;
131    pub fn glint_aac_dec_destroy(dec: glint_t);
132
133    pub fn glint_resample(
134        input: *const f32,
135        in_frames: c_int,
136        channels: c_int,
137        sr_in: c_int,
138        sr_out: c_int,
139        out_frames: *mut c_int,
140    ) -> *mut f32;
141    pub fn glint_free(p: *mut core::ffi::c_void);
142    // Ogg-Vorbis I decoder (whole-buffer). glint_decode_audio also decodes
143    // Vorbis transparently via the C auto-detect.
144    pub fn glint_vorbis_decode(
145        ogg: *const u8,
146        len: c_int,
147        out_sr: *mut c_int,
148        out_ch: *mut c_int,
149        out_frames: *mut c_int,
150    ) -> *mut f32;
151    // Native FLAC decoder (whole-buffer). glint_decode_audio also decodes
152    // FLAC transparently via the C auto-detect.
153    pub fn glint_flac_decode(
154        flac: *const u8,
155        len: c_int,
156        out_sr: *mut c_int,
157        out_ch: *mut c_int,
158        out_frames: *mut c_int,
159    ) -> *mut f32;
160    pub fn glint_decode_audio(
161        data: *const u8,
162        len: c_int,
163        out_sr: *mut c_int,
164        out_ch: *mut c_int,
165        out_frames: *mut c_int,
166    ) -> *mut f32;
167    pub fn glint_opus_encode_file(
168        pcm: *const f32,
169        frames: c_int,
170        channels: c_int,
171        bitrate_bps: c_int,
172        vbr: c_int,
173        out_size: *mut c_int,
174    ) -> *mut u8;
175    pub fn glint_wav_read(
176        data: *const u8,
177        len: c_int,
178        out_sr: *mut c_int,
179        out_ch: *mut c_int,
180        out_frames: *mut c_int,
181    ) -> *mut f32;
182    pub fn glint_wav_write(
183        pcm: *const f32,
184        frames: c_int,
185        channels: c_int,
186        sample_rate: c_int,
187        bits: c_int,
188        is_float: c_int,
189        out_size: *mut c_int,
190    ) -> *mut u8;
191    pub fn glint_encode_audio(
192        pcm: *const f32,
193        frames: c_int,
194        channels: c_int,
195        sample_rate: c_int,
196        format: c_int,
197        bitrate_kbps: c_int,
198        vbr_quality: c_int,
199        quality: c_int,
200        out_size: *mut c_int,
201    ) -> *mut u8;
202    pub fn glint_decode_audio_ex(
203        data: *const u8,
204        len: c_int,
205        out_rate: c_int,
206        want_int16: c_int,
207        out_sr: *mut c_int,
208        out_ch: *mut c_int,
209        out_frames: *mut c_int,
210    ) -> *mut core::ffi::c_void;
211    pub fn glint_flac_decode_ex(
212        data: *const u8,
213        len: c_int,
214        out_rate: c_int,
215        want_int16: c_int,
216        out_sr: *mut c_int,
217        out_ch: *mut c_int,
218        out_frames: *mut c_int,
219    ) -> *mut core::ffi::c_void;
220}
221
222#[repr(C)]
223#[derive(Default, Clone, Copy)]
224pub struct GlintDecFrameInfo {
225    pub sample_rate: c_int,
226    pub channels: c_int,
227    pub samples: c_int,
228    pub frame_bytes: c_int,
229}