From e4aa3831b7eda41c51a369f5b98d0a6e76fbbcc7 Mon Sep 17 00:00:00 2001
From: Nathan Caldwell <saintdev@gmail.com>
Date: Thu, 27 Sep 2012 22:41:24 -0600
Subject: [PATCH] avcodec: document the use of AVCodecContext.delay for audio
decoding
Signed-off-by: Diego Biurrun <diego@biurrun.de>
---
libavcodec/avcodec.h | 17 ++++++++++-------
1 file changed, 10 insertions(+), 7 deletions(-)
diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index a7aec4e9498..59fff221944 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -1449,15 +1449,18 @@ typedef struct AVCodecContext {
* encoded input.
*
* Audio:
- * Number of "priming" samples added to the beginning of the stream
- * during encoding. The decoded output will be delayed by this many
- * samples relative to the input to the encoder. Note that this field is
- * purely informational and does not directly affect the pts output by
- * the encoder, which should always be based on the actual presentation
- * time, including any delay.
+ * For encoding, this is the number of "priming" samples added to the
+ * beginning of the stream. The decoded output will be delayed by this
+ * many samples relative to the input to the encoder. Note that this
+ * field is purely informational and does not directly affect the pts
+ * output by the encoder, which should always be based on the actual
+ * presentation time, including any delay.
+ * For decoding, this is the number of samples the decoder needs to
+ * output before the decoder's output is valid. When seeking, you should
+ * start decoding this many samples prior to your desired seek point.
*
* - encoding: Set by libavcodec.
- * - decoding: unused
+ * - decoding: Set by libavcodec.
*/
int delay;
--
GitLab