Browse code

Clarify (re)get_buffer() and CODEC_CAP_DR1 relation.

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

Michael Niedermayer authored on 2009/06/08 04:30:54
Showing 1 changed files
... ...
@@ -1331,6 +1331,9 @@ typedef struct AVCodecContext {
1331 1331
      * If pic.reference is set then the frame will be read later by libavcodec.
1332 1332
      * avcodec_align_dimensions() should be used to find the required width and
1333 1333
      * height, as they normally need to be rounded up to the next multiple of 16.
1334
+     * if CODEC_CAP_DR1 is not set then get_buffer() must call
1335
+     * avcodec_default_get_buffer() instead of providing buffers allocated by
1336
+     * some other means.
1334 1337
      * - encoding: unused
1335 1338
      * - decoding: Set by libavcodec., user can override.
1336 1339
      */
... ...
@@ -1959,6 +1962,9 @@ typedef struct AVCodecContext {
1959 1959
      * libavcodec will pass previous buffer in pic, function should return
1960 1960
      * same buffer or new buffer with old frame "painted" into it.
1961 1961
      * If pic.data[0] == NULL must behave like get_buffer().
1962
+     * if CODEC_CAP_DR1 is not set then reget_buffer() must call
1963
+     * avcodec_default_reget_buffer() instead of providing buffers allocated by
1964
+     * some other means.
1962 1965
      * - encoding: unused
1963 1966
      * - decoding: Set by libavcodec., user can override
1964 1967
      */