[FFmpeg-cvslog] r21364 - trunk/libavcodec/avcodec.h

[michael]

Author: michael
Date: Thu Jan 21 14:49:47 2010
New Revision: 21364

Log:
Clarify CODEC_CAP_SUBFRAMES.

Modified:
   trunk/libavcodec/avcodec.h

Modified: trunk/libavcodec/avcodec.h
==============================================================================
--- trunk/libavcodec/avcodec.h	Thu Jan 21 13:59:22 2010	(r21363)
+++ trunk/libavcodec/avcodec.h	Thu Jan 21 14:49:47 2010	(r21364)
@@ -619,6 +619,14 @@ typedef struct RcOverride{
 #define CODEC_CAP_HWACCEL_VDPAU    0x0080
 /**
  * Codec can output multiple frames per AVPacket
+ * Normally demuxers return one frame at a time, demuxers which do not do
+ * are connected to a parser to split what they return into proper frames.
+ * This flag is reserved to the very rare category of codecs which have a
+ * bitstream that cannot be split into frames without timeconsuming
+ * operations like full decoding. Demuxers carring such bitstreams thus
+ * may return multiple frames in a packet. This has many disadvantages like
+ * prohibiting stream copy in many cases thus it should only be considered
+ * as a last resort.
  */
 #define CODEC_CAP_SUBFRAMES        0x0100