summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGregory Maxwell <greg@xiph.org>2012-09-19 09:43:52 -0400
committerGregory Maxwell <greg@xiph.org>2012-09-19 09:43:52 -0400
commitcc71cded7690c1fb0912c8e54919cf3462f521d6 (patch)
treea6ea3af6a35ac8d63233ce8bf492aed80b5ac016
parentc40d5004dd7211d836ac89862f29342668a4d88f (diff)
downloadopus-cc71cded7690c1fb0912c8e54919cf3462f521d6.tar.gz
Replace 'maximum frame size' with 'maximum packet duration' in the docs.
This could be confusing/misleading.
-rw-r--r--include/opus.h7
-rw-r--r--include/opus_multistream.h8
2 files changed, 8 insertions, 7 deletions
diff --git a/include/opus.h b/include/opus.h
index c242fec0..df1571af 100644
--- a/include/opus.h
+++ b/include/opus.h
@@ -447,7 +447,7 @@ OPUS_EXPORT int opus_decoder_init(
* @param [out] pcm <tt>opus_int16*</tt>: Output signal (interleaved if 2 channels). length
* is frame_size*channels*sizeof(opus_int16)
* @param [in] frame_size Number of samples per channel of available space in \a pcm.
- * If this is less than the maximum frame size (120 ms), this function will
+ * If this is less than the maximum packet duration (120ms; 5760 for 48kHz), this function will
* not be capable of decoding some packets.
* @param [in] decode_fec <tt>int</tt>: Flag (0 or 1) to request that any in-band forward error correction data be
* decoded. If no such data is available, the frame is decoded as if it were lost.
@@ -468,8 +468,9 @@ OPUS_EXPORT OPUS_WARN_UNUSED_RESULT int opus_decode(
* @param [in] len <tt>opus_int32</tt>: Number of bytes in payload
* @param [out] pcm <tt>float*</tt>: Output signal (interleaved if 2 channels). length
* is frame_size*channels*sizeof(float)
- * @param [in] frame_size Number of samples per channel of available space in *pcm,
- * if less than the maximum frame size (120ms) some frames can not be decoded
+ * @param [in] frame_size Number of samples per channel of available space in \a pcm.
+ * If this is less than the maximum packet duration (120ms; 5760 for 48kHz), this function will
+ * not be capable of decoding some packets.
* @param [in] decode_fec <tt>int</tt>: Flag (0 or 1) to request that any in-band forward error correction data be
* decoded. If no such data is available the frame is decoded as if it were lost.
* @returns Number of decoded samples or @ref opus_errorcodes
diff --git a/include/opus_multistream.h b/include/opus_multistream.h
index f476efa6..9ae1711e 100644
--- a/include/opus_multistream.h
+++ b/include/opus_multistream.h
@@ -535,8 +535,8 @@ OPUS_EXPORT int opus_multistream_decoder_init(
* samples.
* @param frame_size <tt>int</tt>: The number of samples per channel of
* available space in \a pcm.
- * If this is less than the maximum frame size
- * (120 ms), this function will not be capable
+ * If this is less than the maximum packet duration
+ * (120 ms; 5760 for 48kHz), this function will not be capable
* of decoding some packets.
* @param decode_fec <tt>int</tt>: Flag (0 or 1) to request that any in-band
* forward error correction data be decoded.
@@ -568,8 +568,8 @@ OPUS_EXPORT OPUS_WARN_UNUSED_RESULT int opus_multistream_decode(
* samples.
* @param frame_size <tt>int</tt>: The number of samples per channel of
* available space in \a pcm.
- * If this is less than the maximum frame size
- * (120 ms), this function will not be capable
+ * If this is less than the maximum packet duration
+ * (120 ms; 5760 for 48kHz), this function will not be capable
* of decoding some packets.
* @param decode_fec <tt>int</tt>: Flag (0 or 1) to request that any in-band
* forward error correction data be decoded.