# HG changeset patch
# User reimar
# Date 1278804915 0
# Node ID 917a70cf7681d904622000386455f90e38a039d8
# Parent  8b28e74de2c0e454db8a6ea281376b20d8601274
Document that and why subtitle decoders do not support direct-rendering.

diff -r 8b28e74de2c0 -r 917a70cf7681 avcodec.h
--- a/avcodec.h	Sat Jul 10 22:12:30 2010 +0000
+++ b/avcodec.h	Sat Jul 10 23:35:15 2010 +0000
@@ -3542,6 +3542,10 @@
  * 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.