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

   1 Release Notes
   2 =============
   3
   4 * 0.8 "Forbidden Fruit"
   5
   6 General notes
   7 -------------
   8
   9 This release continues the API cleanups that have begun with the
  10 previous release. While it is binary compatible with 0.7, many parts of
  11 the public API were deprecated and will be removed in the git master and
  12 later releases. Please consult the doc/APIchanges file to see
  13 intended replacements for the deprecated APIs.
  14
  15 Furthermore, our work on the 'ffmpeg' command-line tool has resulted in
  16 major revisions to its interface. In order to not break existing scripts
  17 and applications, we have chosen to introduce a new tool called
  18 'avconv', and keep the traditional 'ffmpeg' frontend for end-user's
  19 convenience. Please see the Changelog file for details how 'avconv'
  20 differs from 'ffmpeg'.
  21
  22 Additionally, this release introduces a number of new interesting codecs
  23 such as the Apple Prores, Flash Screen Video 2 and Windows Media Image,
  24 and muxers such as LATM or CELT in Ogg, among many others. Moreover, our
  25 H.264 decoder has been improved to decode 4:2:2 material and our libx264
  26 wrapper now allows to produce 4:2:2 and 4:4:4 video.
  27
  28 See the Changelog file for a list of significant changes.
  29
  30 Please note that our policy on bug reports has not changed. We still only accept
  31 bug reports against HEAD of the Libav trunk repository. If you are experiencing
  32 issues with any formally released version of Libav, please try a current version
  33 of the development code to check if the issue still exists. If it does, make your
  34 report against the development code following the usual bug reporting guidelines.
  35
  36
  37 API changes
  38 -----------
  39
  40 A number of additional APIs have been introduced and some existing
  41 functions have been deprecated and are scheduled for removal in the next
  42 release. Significant API changes include:
  43
  44 * new audio decoding API which decodes from an AVPacket to an AVFrame and
  45 is able to use AVCodecContext.get_buffer() in the similar way as video decoding.
  46
  47 * new audio encoding API which encodes from an AVFrame to an AVPacket, thus
  48 allowing it to properly output timing information and side data.
  49
  50 * rewritten AVOptions API with better built-in support for private options.
  51
  52 * private options support for demuxers [avformat_open_input()], muxers
  53 [avformat_write_header()], encoders and decoders [avcodec_open2()].
  54 As a result, many format- or codec-specific fields and flags in AVFormatContext
  55 and AVCodecContext were deprecated -- notably most of CODEC_FLAG2_* and many
  56 CODEC_FLAG_*.
  57
  58 * new API for custom IO interrupt callbacks.
  59
  60 * #include cleanup in libavutil -- libavutil/avutil.h no longer includes all
  61 the other headers in libavutil, they must be included manually. One specific
  62 result is that libavutil/mathematics.h is no longer included from
  63 libavcodec/avcodec.h, which is a common source of errors.
  64
  65 Please see the file doc/APIchanges for details along with
  66 similar programmer-centric information.
  67
  68
  69
  70 Other notable changes
  71 ---------------------
  72
  73 Libavcodec and libavformat built as shared libraries now hide non-public
  74 symbols. This will break applications using those symbols. Possible solutions
  75 are, in order of preference:
  76 1) Try finding a way of accomplishing the same with public API.
  77 2) If there is no corresponding public API, but you think there should be,
  78 post a request on the user mailing list or IRC channel.
  79 3) Finally if your program needs access to Libav internals for some special
  80 reason then the best solution is to link statically.
  81
  82 Please see the Changelog file for a more detailed list of changes.