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

[reimar]

Author: reimar
Date: Sun Jul 11 01:35:15 2010
New Revision: 24177

Log:
Document that and why subtitle decoders do not support direct-rendering.

Modified:
   trunk/libavcodec/avcodec.h

Modified: trunk/libavcodec/avcodec.h
==============================================================================
--- trunk/libavcodec/avcodec.h	Sun Jul 11 01:15:45 2010	(r24176)
+++ trunk/libavcodec/avcodec.h	Sun Jul 11 01:35:15 2010	(r24177)
@@ -3542,6 +3542,10 @@ attribute_deprecated int avcodec_decode_
  * Return a negative value on error, otherwise return the number of bytes used.
  * If no subtitle could be decompressed, got_sub_ptr is zero.
  * Otherwise, the subtitle is stored in *sub.
+ * Note that CODEC_CAP_DR1 is not available for subtitle codecs. This is for
+ * simplicity, because the performance difference is expect to be negligible
+ * and reusing a get_buffer written for video codecs would probably perform badly
+ * due to a potentially very different allocation pattern.
  *
  * @param avctx the codec context
  * @param[out] sub The AVSubtitle in which the decoded subtitle will be stored.