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.