From: Michael Niedermayer <michaelni@gmx.at>
Date: Thu, 21 Jan 2010 13:49:47 +0000 (+0000)
Subject: Clarify CODEC_CAP_SUBFRAMES.
X-Git-Tag: v0.6~1749
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=e9e949cf74391a00751ddec83197bb019b203bd2;p=platform%2Fupstream%2Flibav.git

Clarify CODEC_CAP_SUBFRAMES.

Originally committed as revision 21364 to svn://svn.ffmpeg.org/ffmpeg/trunk
---

diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index ace4863..aa59097 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -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