git.sesse.net Git - ffmpeg/blob - doc/RELEASE_NOTES

   1 Release Notes
   2 =============
   3
   4 * 10 "Eks"
   5
   6 General notes
   7 -------------
   8
   9 One of the main features of this release is the addition of reference-counted
  10 data buffers to Libav and their use in various structures. Specifically, the
  11 data buffers used by AVPacket and AVFrame can now be reference counted, which
  12 should allow to significantly simplify many use cases. In addition,
  13 reference-counted AVFrames can now be used in libavfilter, avoiding the need
  14 for a separate libavfilter-specific frame structure. Frames can now be passed
  15 straight from the decoders into filters or from filters to encoders.
  16
  17 These additions made it necessary to bump the major versions of libavcodec,
  18 libavformat, libavdevice, libavfilter, and libavutil, which was accompanied by
  19 dropping some old deprecated APIs. These libraries are thus not ABI- or API-
  20 compatible with the previous release. All the other libraries (libavresample
  21 and libswscale) should be both ABI- and API-compatible.
  22
  23 Another major point is the inclusion of the HEVC (AKA H.265, the successor of
  24 H.264) decoder in the main codebase. It was started in 2012 as a Libav Google
  25 Summer of Code project by Guillaume Martres and subsequently completed with
  26 the assistance of the OpenHEVC project and several Libav developers.
  27
  28 As usual, this release also contains support for other new formats, many smaller
  29 new features and countless bug fixes. We can highlight a native VP9 decoder,
  30 with encoding provided through libvpx, native decoders for WebP, JPEG 2000, and
  31 AIC, as well as improved WavPack support with encoding through libwavpack,
  32 support for more AAC flavors (LD - low delay, ELD - enhanced low delay), slice
  33 multithreading in libavfilter, or muxing chapters in ASF. Furthermore a few new
  34 filters have been introduced, namely compand, to change audio dynamics, framepack,
  35 to create stereoscopic videos, asetpts, to set audio pts, and interlace, to convert
  36 progressive video to interlaced. Finally there is more fine-grained detection of
  37 host and target libc, which should allow better portability to various cross
  38 compilation scenarios.
  39
  40 See the Changelog file for a fuller list of significant changes.
  41
  42 Please note that our policy on bug reports has not changed. We still only accept
  43 bug reports against HEAD of the Libav trunk repository. If you are experiencing
  44 issues with any formally released version of Libav, please try a current version
  45 of the development code to check if the issue still exists. If it does, make
  46 your report against the development code following the usual bug reporting
  47 guidelines.
  48
  49
  50 API changes
  51 -----------
  52
  53 A number of additional APIs have been introduced and some existing functions
  54 have been deprecated and are scheduled for removal in the next release.
  55 Significant API changes include:
  56
  57 [libavutil]
  58 + added the reference-counted buffers API (buffers.h)
  59 + moved the AVFrame struct to libavutil and added a new API for working with
  60   reference-counted AVFrames (frame.h)
  61
  62 [libavcodec]
  63 + added an API for working with reference-counted AVPackets (av_packet_*)
  64 +- converted VDPAU to the hwaccel framework; the old way of using VDPAU is no
  65    longer supported
  66 - old audio encoding and decoding APIs removed
  67 - old video encoding API removed
  68 - deprecated enum CodecID removed (enum AVCodecID should be used instead)
  69 - deprecated audio resampling API removed (libavresample should be used
  70   instead)
  71
  72 [libavfilter]
  73 +- replaced AVFilterBufferRef with AVFrame; AVFilterBufferRef and everything
  74    related to it still exists, but is deprecated
  75 + converted all filters to use the AVOptions system for configuration, it is
  76   now possible to query the supported options, their values and set them
  77   directly with av_opt_*
  78 + added a slice multithreading framework
  79 +- merged avfiltergraph.h to avfilter.h, using AVFilterGraph is now explicitly
  80    mandatory (it was implicitly required even before); added new API for
  81    allocating and initializing filters
  82
  83 Please see the file doc/APIchanges for details along with similar
  84 programmer-centric information.