Clarify what av_read_frame() returns.
authorMichael Niedermayer <michaelni@gmx.at>
Tue, 14 Sep 2010 22:20:46 +0000 (22:20 +0000)
committerMichael Niedermayer <michaelni@gmx.at>
Tue, 14 Sep 2010 22:20:46 +0000 (22:20 +0000)
Originally committed as revision 25123 to svn://svn.ffmpeg.org/ffmpeg/trunk

libavformat/avformat.h

index ed9dfb3..0520530 100644 (file)
@@ -1088,6 +1088,11 @@ int av_read_packet(AVFormatContext *s, AVPacket *pkt);
 
 /**
  * Return the next frame of a stream.
 
 /**
  * Return the next frame of a stream.
+ * This function returns what is stored in the file, and does not validate
+ * that what is there are valid frames for the decoder. It will split what is
+ * stored in the file into frames and return one for each call. It will not
+ * omit invalid data between valid frames so as to give the decoder the maximum
+ * information possible for decoding.
  *
  * The returned packet is valid
  * until the next av_read_frame() or until av_close_input_file() and
  *
  * The returned packet is valid
  * until the next av_read_frame() or until av_close_input_file() and