avcodec: Do not lock during open for codecs marked as having threadsafe init
[ffmpeg.git] / doc / RELEASE_NOTES
1 Release Notes
2 =============
3
4 * 11 "One Louder"
5
6 General notes
7 -------------
8
9 With this release we are trying to answer the numerous calls from our users for
10 shorter development cycles. From now on we will aim for approximately two major
11 releases per year.
12
13 Libav 11 is API-, but not ABI-compatible with the previous major release. This
14 means that the code using our libraries needs to be rebuilt, but no source
15 changes should be required. Note however, that a number of old APIs remain
16 deprecated and will be dropped in the near future. All users are strongly
17 encouraged to update their code as soon as possible. The doc/APIchanges file in
18 the Libav source tree and the migration guide on the wiki should help with
19 migration to the new APIs. If those are not sufficient, do not hesitate to
20 contact us on IRC or through the user mailing list.
21
22 One specific API issue in libavformat deserves mentioning here. When using
23 libavcodec for decoding or encoding and libavformat for demuxing or muxing,
24 the standard practice was to use the stream codec context (AVStream.codec) for
25 actual decoding or encoding. There are multiple problems with this pattern
26 (the main one is that the decoder/demuxer or encoder/muxer are not necessarily
27 synchronized and may overwrite each other's state), so it is now strongly
28 discouraged and will likely be deprecated in the future. Users should instead
29 allocate a separate decoding or encoding context and populate it from the
30 demuxing codec context (or the reverse for encoding) with the
31 avcodec_copy_context() function.
32
33 The main highlights of this release include native Opus, VP7, OpenEXR, and On2
34 AVC decoders, HEVC encoding through libx265, new APIs for exporting ReplayGain
35 and display transformation metadata and countless bug fixes. A large effort was
36 also expended on internal cleanups which are not very visible to our users,
37 but should make the codebase cleaner, safer and easier to maintain and extend.
38 One point worth mentioning is refactoring the large monolithic framework for
39 architecture-specific codec optimizations into small blocks, which reduces the
40 size of configurations that selectively enable or disable certain codecs.
41
42 The avserver streaming tool, which has not been maintained for many years and
43 was mostly broken, was removed from the tree. It was decided that it is a
44 significant maintenance burden and that we do our users no service by pretending
45 to support it, while we in fact do not.
46
47 See the Changelog file for a more extensive list of significant changes.
48
49 API changes
50 -----------
51
52 A number of additional APIs have been introduced and some existing functions
53 have been deprecated and are scheduled for removal in the next release.
54 Significant API changes include:
55
56 [libavcodec]
57 +  Added the avcodec_copy_context() function that must from now on be used for
58    freeing codec contexts.
59 +- Added a new VDA hardware acceleration API, since the old one was broken and
60    not fixable in a compatible way. Deprecated the old VDA API.
61
62 [libavformat]
63 +  Added support for exporting stream-global (as opposed to per-packet) side
64    data. This feature is now used by some demuxers to export ReplayGain or
65    display transformation matrix (aka rotation) or stereoscopic 3D mode.
66 +  Added an API for live metadata updates through event flags.
67 +- Changed the way to provide a hint about the desired timebase to muxers.
68    Previously it was done by setting AVStream.codec.time_base. Now callers
69    should set AVStream.time_base.
70
71 [libavresample]
72 + Added an API for working with AVFrames.
73
74 Please see the file doc/APIchanges for details along with similar
75 programmer-centric information.