fenix
/
exhale
mirror of https://gitlab.com/ecodis/exhale.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update api

Christian R. Helmrich 2020-01-31 23:20:18 +00:00
parent 16fba7670d
commit 0180f6e54e
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
api.md

@ -25,8 +25,8 @@ create an *ExhaleEncAPI* object and return a pointer to it. The following parame
* *numChannels*: number of channels in the input PCM audio data. Must be between 1 (mono) and 8 (7.1 surround), or 0 to indicate two-channel input which will be encoded channel-independently in dual-mono two-SCE configuration.
* *frameLength*: number of audio samples per channel and encoded frame. Must equal 1024 for now.
* *indepPeriod*: random-access (also called "tune-in") period for broadcasting and streaming purposes, particularly when the audio is accompanied by video. Recommended values are 45 with 25 or 50-Hz video (Europe, Asia) and 50 with 30 or 60-Hz video (North America).
* *varBitRateMode*: the CVBR mode controlling the overall bit-rate. See the [FAQ](https://gitlab.com/ecodis/exhale/-/wikis/faq) for details. Must be between 0 (lowest rate) and 9 (highest rate). Note that mode 0 is **not** intended for content production, use it only for scientific research purposes.
* *useNoiseFilling*: enable (true) or disable (false) the noise substitution functionality. It is recommended to enable this feature.
* *varBitRateMode*: the CVBR mode controlling the overall bit-rate. See the [FAQ](https://gitlab.com/ecodis/exhale/-/wikis/faq) for details. Must be between 0 (lowest rate) and 9 (highest rate). Note that mode 0 is **not** intended for content production, use it only for scientific research.
* *useNoiseFilling*: enable (true) or disable (false) the noise substitution functionality provided by the ISO/IEC 23003-3 standard. It is recommended to enable this feature for best possible audio quality.
* *useEcodisExt*: additional, reserved parameter for future use. Currently ignored, should be set to false.
**Return value**
@ -47,7 +47,7 @@ unsigned ExhaleEncAPI::`initEncoder`(unsigned char* const audioConfigBuffer, uin
**Purpose**
initialize an *ExhaleEncAPI* object for encoding and allocate dynamic object memory. Also checks the validity of the parameters given to `exhaleCreate()` and, upon success, generates AudioSpecificConfig (ASC, including UsacConfig) data for bit-stream headers. The following parameters are available storage of this data:
initialize an *ExhaleEncAPI* object for encoding and allocate dynamic object memory. Also checks the validity of the parameters given to `exhaleCreate()` and, upon success, generates AudioSpecificConfig (ASC, including UsacConfig) data for the bit-stream header. The following parameters are available for storage of this data:
* *audioConfigBuffer*: pointer to an unsigned 8-bit integer buffer to which the ASC data is written. May be `NULL`, in which case no ASC is generated.
* *audioConfigBytes*: pointer to a single unsigned 32-bit integer to which the size of the ASC data (in bytes) is written. Optional, may be `NULL`.
@ -70,7 +70,7 @@ unsigned ExhaleEncAPI::`encodeLookahead`( );
**Purpose**
encode the first (lookahead) frame with an *ExhaleEncAPI* object. Requires 1024**numChannels* new audio samples.
encode the first (lookahead) frame with an *ExhaleEncAPI* object. Requires *frameLength***numChannels* new audio samples in *inputPcmData* (see `exhaleCreate()`).
**Return value**
@ -90,7 +90,7 @@ unsigned ExhaleEncAPI::`encodeFrame`( );
**Purpose**
encode a regular PCM audio frame with an *ExhaleEncAPI* object. Requires 1024**numChannels* new audio samples.
encode a regular PCM audio frame with an *ExhaleEncAPI* object. Requires *frameLength***numChannels* new audio samples in *inputPcmData* (see `exhaleCreate()`).
**Return value**