summaryrefslogtreecommitdiff
path: root/include/opus.h
diff options
context:
space:
mode:
authorGregory Maxwell <greg@xiph.org>2012-06-10 21:15:02 -0400
committerGregory Maxwell <greg@xiph.org>2012-06-10 21:15:02 -0400
commit1f65ce89b03a1d9c9bae9fa3ed0109b3bde21a60 (patch)
tree448d315af238fefe3256ab5bff1835e894f549b8 /include/opus.h
parent2967d4e220ffe5805c833252861ad2a9c3f7d113 (diff)
downloadopus-1f65ce89b03a1d9c9bae9fa3ed0109b3bde21a60.tar.gz
Correct documentation in opus_custom.h.
Diffstat (limited to 'include/opus.h')
-rw-r--r--include/opus.h8
1 files changed, 7 insertions, 1 deletions
diff --git a/include/opus.h b/include/opus.h
index f89d0ec7..baf9d738 100644
--- a/include/opus.h
+++ b/include/opus.h
@@ -67,6 +67,7 @@ extern "C" {
* @li @ref opus_decoder
* @li @ref opus_repacketizer
* @li @ref opus_libinfo
+ * @li @ref opus_custom
*/
/** @defgroup opus_encoder Opus Encoder
@@ -243,7 +244,12 @@ OPUS_EXPORT OPUS_WARN_UNUSED_RESULT opus_int32 opus_encode(
* Passing in a duration of less than 10ms (480 samples at 48kHz) will
* prevent the encoder from using the LPC or hybrid modes.
* @param [in] st <tt>OpusEncoder*</tt>: Encoder state
- * @param [in] pcm <tt>float*</tt>: Input signal (interleaved if 2 channels). length is frame_size*channels*sizeof(float)
+ * @param [in] pcm <tt>float*</tt>: Input in float format (interleaved if 2 channels), with a normal range of +/-1.0.
+ * Samples with a range beyond +/-1.0 are supported but will
+ * be clipped by decoders using the integer API and should
+ * only be used if it is known that the far end supports
+ * extended dynamic range.
+ * length is frame_size*channels*sizeof(float)
* @param [in] frame_size <tt>int</tt>: Number of samples per frame of input signal
* @param [out] data <tt>char*</tt>: Output payload (at least max_data_bytes long)
* @param [in] max_data_bytes <tt>opus_int32</tt>: Allocated memory for payload; don't use for controlling bitrate