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

   1 Release Notes
   2 =============
   3
   4 * 9 "Plain Nine"
   5
   6 General notes
   7 -------------
   8
   9 From this release onwards, we have decided to drop the leading zero from our
  10 release numbers. There were no plans of ever changing it, so it carried no
  11 information. Thus this release is just a plain 9, the next will be 10 etc.
  12
  13 A new library arrived in Libav during this development cycle -- its name is
  14 libavresample and it handles audio conversion and mixing. All users are
  15 encouraged to use it instead of the old, now deprecated, audio conversion
  16 API in libavcodec.
  17
  18 The libpostproc library now resides in a separate tree. It was fully independent
  19 of the other Libav libraries, not used by any of the tools and saw very little
  20 development. For these reasons we decided that it has no place in Libav. A
  21 standalone Git tree is available at http://git.videolan.org/?p=libpostproc.git
  22 for people wishing to use libpostproc.
  23
  24 The major versions of the libavcodec, libavformat and libavfilter libraries have
  25 been bumped, so they are not API or ABI compatible with the 0.8 release. The
  26 ffmpeg transcoding tool, kept for compatibility in 0.8, has also been dropped.
  27
  28 This release brings a number of significant changes in the libavfilter library.
  29 Firstly, all the API dealing with filter internals is no longer public. The
  30 result is that creating user-side filters will not be supported until
  31 libavfilter is more mature.
  32 Secondly, full audio filtering support is now available along with a set of
  33 basic audio filters. We hope that their number will soon grow significantly.
  34 The avconv transcoding tool has of course been extended to handle audio
  35 filtering as well.
  36 There were a number of other API changes, most importantly the addition of
  37 the buffer sink public API.
  38
  39 In the libavcodec library, one of the most notable changes is added support for
  40 planar audio (i.e. not interleaved). Many decoders and encoders, that previously
  41 did inefficient (de)interleaving internally, now only work with planar audio
  42 formats. Libavresample can be used for optimized conversion between interleaved
  43 and planar formats.
  44
  45 Of big interest to our Windows users, Libav now supports building with the MSVC
  46 compiler. Since MSVC does not support C99 features used extensively by Libav,
  47 this has been accomplished using a converter that turns C99 code to C89. See the
  48 platform-specific documentation for more detailed documentation on building
  49 Libav with MSVC.
  50
  51 As usual, this release also contains support for some new formats, many smaller
  52 new features and countless bug fixes. We can highlight Opus decoding / encoding
  53 through libopus, encoders for Apple ProRes and Ut Video, WMA Lossless and
  54 RealAudio Lossless decoders, fragmented MOV/MP4 and ISMV (Smooth Streaming)
  55 muxers, 24-bit FLAC encoding, a large number of RTMP improvements and support
  56 for cover art in ID3v2, WMA, MP4 and FLAC.
  57
  58 See the Changelog file for a list of significant changes.
  59
  60 Please note that our policy on bug reports has not changed. We still only accept
  61 bug reports against HEAD of the Libav trunk repository. If you are experiencing
  62 issues with any formally released version of Libav, please try a current version
  63 of the development code to check if the issue still exists. If it does, make
  64 your report against the development code following the usual bug reporting
  65 guidelines.
  66
  67
  68 API changes
  69 -----------
  70
  71 A number of additional APIs have been introduced and some existing functions
  72 have been deprecated and are scheduled for removal in the next release.
  73 Significant API changes include:
  74
  75 [libavcodec]:
  76 * New video encoding API, similar to the previously introduced audio  encoding
  77   API, which encodes from an AVFrame to an AVPacket, thus allowing it to
  78   properly output timing information and side data.
  79
  80 * All CODEC_ID_* symbols now carry AV_ prefixes. Non-prefixed codec IDs are
  81   deprecated.
  82
  83 * New codec descriptor API, which allows getting the properties of a given codec
  84   (identified by its ID), without referring to a specific decoder or encoder.
  85
  86 * An AVFrame must now be freed with a dedicated function, avcodec_free_frame().
  87
  88 [libavutil]:
  89 * New audio FIFO API, which simplifies managing/merging/splitting audio buffers.
  90
  91 * new int/float type punning API
  92
  93 [libavfilter]:
  94 * All filter internals were hidden.
  95
  96 * audio filtering.
  97
  98 * new buffer sink API for getting frames out of libavfilter.
  99
 100 Please see the file doc/APIchanges for details along with similar
 101 programmer-centric information.