Browse code

Add the bumps and APIchanges entries for reference counted buffers changes.

Anton Khirnov authored on 2013/02/17 18:31:25
Showing 6 changed files
... ...
@@ -4,6 +4,7 @@ releases are sorted from youngest to oldest.
4 4
 version 10:
5 5
 - av_strnstr
6 6
 - support ID3v2 tags in ASF files
7
+- reference-counting for AVFrame and AVPacket data
7 8
 
8 9
 
9 10
 version 9:
... ...
@@ -2,10 +2,10 @@ Never assume the API of libav* to be stable unless at least 1 month has passed
2 2
 since the last major version increase.
3 3
 
4 4
 The last version increases were:
5
-libavcodec:    2012-01-27
6
-libavdevice:   2011-04-18
5
+libavcodec:    2013-03-xx
6
+libavdevice:   2013-03-xx
7 7
 libavfilter:   2012-06-22
8
-libavformat:   2012-01-27
8
+libavformat:   2013-03-xx
9 9
 libavresample: 2012-10-05
10 10
 libswscale:    2011-06-20
11 11
 libavutil:     2012-10-22
... ...
@@ -13,6 +13,40 @@ libavutil:     2012-10-22
13 13
 
14 14
 API changes, most recent first:
15 15
 
16
+2013-03-xx - Reference counted buffers - lavu 52.8.0, lavc 55.0.0, lavf 55.0.0,
17
+lavd 54.0.0, lavfi 3.5.0
18
+  xxxxxxx, xxxxxxx - add a new API for reference counted buffers and buffer
19
+                     pools (new header libavutil/buffer.h).
20
+  xxxxxxx - add AVPacket.buf to allow reference counting for the AVPacket data.
21
+            Add av_packet_from_data() function for constructing packets from
22
+            av_malloc()ed data.
23
+  xxxxxxx - move AVFrame from lavc to lavu (new header libavutil/frame.h), add
24
+            AVFrame.buf/extended_buf to allow reference counting for the AVFrame
25
+            data. Add new API for working with reference-counted AVFrames.
26
+  xxxxxxx - add the refcounted_frames field to AVCodecContext to make audio and
27
+            video decoders return reference-counted frames. Add get_buffer2()
28
+            callback to AVCodecContext which allocates reference-counted frames.
29
+            Add avcodec_default_get_buffer2() as the default get_buffer2()
30
+            implementation.
31
+            Deprecate AVCodecContext.get_buffer() / release_buffer() /
32
+            reget_buffer(), avcodec_default_get_buffer(),
33
+            avcodec_default_reget_buffer(), avcodec_default_release_buffer().
34
+            Remove avcodec_default_free_buffers(), which should not have ever
35
+            been called from outside of lavc.
36
+            Deprecate the following AVFrame fields:
37
+                * base -- is now stored in AVBufferRef
38
+                * reference, type, buffer_hints -- are unnecessary in the new API
39
+                * hwaccel_picture_private, owner, thread_opaque -- should not
40
+                  have been acessed from outside of lavc
41
+                * qscale_table, qstride, qscale_type, mbskip_table, motion_val,
42
+                  mb_type, dct_coeff, ref_index -- mpegvideo-specific tables,
43
+                  which are not exported anymore.
44
+  xxxxxxx - switch libavfilter to use AVFrame instead of AVFilterBufferRef. Add
45
+            av_buffersrc_add_frame(), deprecate av_buffersrc_buffer().
46
+            Add av_buffersink_get_frame() and av_buffersink_get_samples(),
47
+            deprecate av_buffersink_read() and av_buffersink_read_samples().
48
+            Deprecate AVFilterBufferRef and all functions for working with it.
49
+
16 50
 2013-xx-xx - xxxxxxx - lavu 52.8.0 - avstring.h
17 51
   Add av_isdigit, av_isgraph, av_isspace, av_isxdigit.
18 52
 
... ...
@@ -26,9 +26,9 @@
26 26
  * Libavcodec version macros.
27 27
  */
28 28
 
29
-#define LIBAVCODEC_VERSION_MAJOR 54
30
-#define LIBAVCODEC_VERSION_MINOR 41
31
-#define LIBAVCODEC_VERSION_MICRO  1
29
+#define LIBAVCODEC_VERSION_MAJOR 55
30
+#define LIBAVCODEC_VERSION_MINOR  0
31
+#define LIBAVCODEC_VERSION_MICRO  0
32 32
 
33 33
 #define LIBAVCODEC_VERSION_INT  AV_VERSION_INT(LIBAVCODEC_VERSION_MAJOR, \
34 34
                                                LIBAVCODEC_VERSION_MINOR, \
... ...
@@ -27,8 +27,8 @@
27 27
 
28 28
 #include "libavutil/avutil.h"
29 29
 
30
-#define LIBAVDEVICE_VERSION_MAJOR 53
31
-#define LIBAVDEVICE_VERSION_MINOR  2
30
+#define LIBAVDEVICE_VERSION_MAJOR 54
31
+#define LIBAVDEVICE_VERSION_MINOR  0
32 32
 #define LIBAVDEVICE_VERSION_MICRO  0
33 33
 
34 34
 #define LIBAVDEVICE_VERSION_INT AV_VERSION_INT(LIBAVDEVICE_VERSION_MAJOR, \
... ...
@@ -29,7 +29,7 @@
29 29
 #include "libavutil/avutil.h"
30 30
 
31 31
 #define LIBAVFILTER_VERSION_MAJOR  3
32
-#define LIBAVFILTER_VERSION_MINOR  4
32
+#define LIBAVFILTER_VERSION_MINOR  5
33 33
 #define LIBAVFILTER_VERSION_MICRO  0
34 34
 
35 35
 #define LIBAVFILTER_VERSION_INT AV_VERSION_INT(LIBAVFILTER_VERSION_MAJOR, \
... ...
@@ -29,9 +29,9 @@
29 29
 
30 30
 #include "libavutil/avutil.h"
31 31
 
32
-#define LIBAVFORMAT_VERSION_MAJOR 54
33
-#define LIBAVFORMAT_VERSION_MINOR 21
34
-#define LIBAVFORMAT_VERSION_MICRO  3
32
+#define LIBAVFORMAT_VERSION_MAJOR 55
33
+#define LIBAVFORMAT_VERSION_MINOR  0
34
+#define LIBAVFORMAT_VERSION_MICRO  0
35 35
 
36 36
 #define LIBAVFORMAT_VERSION_INT AV_VERSION_INT(LIBAVFORMAT_VERSION_MAJOR, \
37 37
                                                LIBAVFORMAT_VERSION_MINOR, \