---
libavcodec/avcodec.h | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index b3c6419..d5feb35 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -3266,6 +3266,9 @@ void avcodec_free_frame(AVFrame **frame);
*
* @warning This function is not thread safe!
*
+ * @note Always call this function before using decoding routines (such as
+ * @ref avcodec_decode_video2()).
+ *
* @code
* avcodec_register_all();
* av_dict_set(&opts, "b", "2.5M", 0);
@@ -3595,6 +3598,9 @@ void avcodec_align_dimensions2(AVCodecContext *s, int
*width, int *height,
* larger than the actual read bytes because some optimized bitstream
* readers read 32 or 64 bits at once and could read over the end.
*
+ * @note The AVCodec MUST have been opened with @ref avcodec_open2() before
+ * packets may be fed to the decoder.
+ *
* @param avctx the codec context
* @param[out] frame The AVFrame in which to store decoded audio samples.
* The decoder will allocate a buffer for the decoded frame
by
@@ -3639,6 +3645,9 @@ int avcodec_decode_audio4(AVCodecContext *avctx, AVFrame
*frame,
* between input and output, these need to be fed with avpkt->data=NULL,
* avpkt->size=0 at the end to return the remaining frames.
*
+ * @note The AVCodec MUST have been opened with @ref avcodec_open2() before
+ * packets may be fed to the decoder.
+ *
* @param avctx the codec context
* @param[out] picture The AVFrame in which the decoded video frame will be
stored.
* Use av_frame_alloc() to get an AVFrame. The codec will
@@ -3677,6 +3686,9 @@ int avcodec_decode_video2(AVCodecContext *avctx, AVFrame
*picture,
* and reusing a get_buffer written for video codecs would probably perform
badly
* due to a potentially very different allocation pattern.
*
+ * @note The AVCodec MUST have been opened with @ref avcodec_open2() before
+ * packets may be fed to the decoder.
+ *
* @param avctx the codec context
* @param[out] sub The AVSubtitle in which the decoded subtitle will be
stored, must be
freed with avsubtitle_free if *got_sub_ptr is set.
--
1.9.3 (Apple Git-50)
_______________________________________________
libav-devel mailing list
[email protected]
https://lists.libav.org/mailman/listinfo/libav-devel
