mirror/miniaudio
1
0
Fork 0
mirror of https://github.com/mackron/miniaudio.git synced 2026-04-23 00:34:03 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add a clarifying comment about decoders being decoupled from devices.

Browse Source
This commit is contained in:
David Reid
2020-11-28 21:59:57 +10:00
parent d706a7549b
commit 71a21b5e71
1 changed files with 5 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
miniaudio.h
+5 -4
View File
@@ -410,7 +410,8 @@ All formats are native-endian.
4. Decoding 4. Decoding
=========== ===========
The `ma_decoder` API is used for reading audio files. The following formats are supported: The `ma_decoder` API is used for reading audio files. Decoders are completely decoupled from devices and can be used independently. The following formats are
supported:
+---------+------------------+----------+ +---------+------------------+----------+
| Format | Decoding Backend | Built-In | | Format | Decoding Backend | Built-In |
@@ -463,14 +464,14 @@ with `ma_decoder_init()`. Here is an example for loading a decoder from a file:
ma_decoder_uninit(&decoder); ma_decoder_uninit(&decoder);
``` ```
When initializing a decoder, you can optionally pass in a pointer to a ma_decoder_config object (the NULL argument in the example above) which allows you to When initializing a decoder, you can optionally pass in a pointer to a `ma_decoder_config` object (the `NULL` argument in the example above) which allows you
configure the output format, channel count, sample rate and channel map: to configure the output format, channel count, sample rate and channel map:
```c ```c
ma_decoder_config config = ma_decoder_config_init(ma_format_f32, 2, 48000); ma_decoder_config config = ma_decoder_config_init(ma_format_f32, 2, 48000);
``` ```
When passing in NULL for decoder config in `ma_decoder_init*()`, the output format will be the same as that defined by the decoding backend. When passing in `NULL` for decoder config in `ma_decoder_init*()`, the output format will be the same as that defined by the decoding backend.
Data is read from the decoder as PCM frames. This will return the number of PCM frames actually read. If the return value is less than the requested number of Data is read from the decoder as PCM frames. This will return the number of PCM frames actually read. If the return value is less than the requested number of
PCM frames it means you've reached the end: PCM frames it means you've reached the end: