Commit 5f4b1b1c authored by Anton Khirnov's avatar Anton Khirnov

lavc doxy: document that avcodec_flush_buffers() invalidates decoded frames

parent 2725f2d4
...@@ -3388,8 +3388,8 @@ void avcodec_align_dimensions2(AVCodecContext *s, int *width, int *height, ...@@ -3388,8 +3388,8 @@ void avcodec_align_dimensions2(AVCodecContext *s, int *width, int *height,
* to the frame if av_frame_is_writable() returns 1. * to the frame if av_frame_is_writable() returns 1.
* When AVCodecContext.refcounted_frames is set to 0, the returned * When AVCodecContext.refcounted_frames is set to 0, the returned
* reference belongs to the decoder and is valid only until the * reference belongs to the decoder and is valid only until the
* next call to this function or until closing the decoder. * next call to this function or until closing or flushing the
* The caller may not write to it. * decoder. The caller may not write to it.
* @param[out] got_frame_ptr Zero if no frame could be decoded, otherwise it is * @param[out] got_frame_ptr Zero if no frame could be decoded, otherwise it is
* non-zero. * non-zero.
* @param[in] avpkt The input AVPacket containing the input buffer. * @param[in] avpkt The input AVPacket containing the input buffer.
...@@ -3437,8 +3437,8 @@ int avcodec_decode_audio4(AVCodecContext *avctx, AVFrame *frame, ...@@ -3437,8 +3437,8 @@ int avcodec_decode_audio4(AVCodecContext *avctx, AVFrame *frame,
* to the frame if av_frame_is_writable() returns 1. * to the frame if av_frame_is_writable() returns 1.
* When AVCodecContext.refcounted_frames is set to 0, the returned * When AVCodecContext.refcounted_frames is set to 0, the returned
* reference belongs to the decoder and is valid only until the * reference belongs to the decoder and is valid only until the
* next call to this function or until closing the decoder. The * next call to this function or until closing or flushing the
* caller may not write to it. * decoder. The caller may not write to it.
* *
* @param[in] avpkt The input AVpacket containing the input buffer. * @param[in] avpkt The input AVpacket containing the input buffer.
* You can create such packet with av_init_packet() and by then setting * You can create such packet with av_init_packet() and by then setting
...@@ -4060,7 +4060,13 @@ int avcodec_fill_audio_frame(AVFrame *frame, int nb_channels, ...@@ -4060,7 +4060,13 @@ int avcodec_fill_audio_frame(AVFrame *frame, int nb_channels,
int buf_size, int align); int buf_size, int align);
/** /**
* Flush buffers, should be called when seeking or when switching to a different stream. * Reset the internal decoder state / flush internal buffers. Should be called
* e.g. when seeking or when switching to a different stream.
*
* @note when refcounted frames are not used (i.e. avctx->refcounted_frames is 0),
* this invalidates the frames previously returned from the decoder. When
* refcounted frames are used, the decoder just releases any references it might
* keep internally, but the caller's reference remains valid.
*/ */
void avcodec_flush_buffers(AVCodecContext *avctx); void avcodec_flush_buffers(AVCodecContext *avctx);
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment