Merge commit '5b4797a21db900b7d509660b7a4d49829089b004'
[ffmpeg.git] / doc / APIchanges
index 54164ef..d43f459 100644 (file)
@@ -4,7 +4,7 @@ since the last major version increase or the API was added.
 The last version increases were:
 libavcodec:    2013-03-xx
 libavdevice:   2013-03-xx
-libavfilter:   2012-06-22
+libavfilter:   2013-12-xx
 libavformat:   2013-03-xx
 libavresample: 2012-10-05
 libpostproc:   2011-04-18
@@ -15,6 +15,101 @@ libavutil:     2012-10-22
 
 API changes, most recent first:
 
+2013-12-xx - xxxxxxx - lavu 53.2.0 - frame.h
+  Add AV_FRAME_DATA_MATRIXENCODING value to the AVFrameSideDataType enum, which
+  identifies AVMatrixEncoding data.
+
+2013-12-xx - xxxxxxx - lavu 53.1.0 - channel_layout.h
+  Add values for various Dolby flags to the AVMatrixEncoding enum.
+
+2014-01-04 - xxxxxxx - lavu 52.60.100 - mathematics.h
+  Add av_add_stable() function.
+
+2013-12-22 - xxxxxxx - lavu 52.59.100 - avstring.h
+  Add av_strnlen() function.
+
+2013-12-xx - xxxxxxx - lavu 52.57.100 - opencl.h
+  Add av_opencl_benchmark() function.
+
+2013-11-xx - xxxxxxx - lavu 52.56.100 - ffversion.h
+  Moves version.h to libavutil/ffversion.h.
+  Install ffversion.h and make it public.
+
+2013-12-xx - xxxxxxx - lavc 55.28.1 - avcodec.h
+  av_frame_alloc(), av_frame_unref() and av_frame_free() now can and should be
+  used instead of avcodec_alloc_frame(), avcodec_get_frame_defaults() and
+  avcodec_free_frame() respectively. The latter three functions are deprecated.
+
+2013-11-xx - xxxxxxx- - lavu 52.20.0 - frame.h
+  Add AV_FRAME_DATA_STEREO3D value to the AVFrameSideDataType enum and
+  stereo3d.h API, that identify codec-independent stereo3d information.
+
+2013-11-xx - xxxxxxx- - lavu 52.19.0 - frame.h
+  Add AV_FRAME_DATA_A53_CC value to the AVFrameSideDataType enum, which
+  identifies ATSC A53 Part 4 Closed Captions data.
+
+2013-11-XX - xxxxxxx - lavu 52.54.100 - avstring.h
+  Add av_utf8_decode() function.
+
+2013-11-22 - fb7d70c - lavc 55.44.100 - avcodec.h
+  Add HEVC profiles
+
+2013-11-xx - xxxxxxx - lavc 55.44.100 - avcodec.h
+  Add av_packet_{un,}pack_dictionary()
+  Add AV_PKT_METADATA_UPDATE side data type, used to transmit key/value
+  strings between a stream and the application.
+
+2013-11-xx - xxxxxxx - lavu 52.18.0 - mem.h
+  Move av_fast_malloc() and av_fast_realloc() for libavcodec to libavutil.
+
+2013-10-xx - xxxxxxx - lavc 55.27.0 - avcodec.h
+  Deprecate AVCodecContext.error_rate, it is replaced by the 'error_rate'
+  private option of the mpegvideo encoder family.
+
+2013-11-xx - xxxxxxx - lavc 55.26.0 - vdpau.h
+  Add av_vdpau_get_profile().
+  Add av_vdpau_alloc_context(). This function must from now on be
+  used for allocating AVVDPAUContext.
+
+2013-11-xx - xxxxxxx - lavc 55.41.100 / 55.25.0 - avcodec.h
+                       lavu 52.51.100 - frame.h
+  Add ITU-R BT.2020 and other not yet included values to color primaries,
+  transfer characteristics and colorspaces.
+
+2013-11-04 - xxxxxxx - lavu 52.50.100 - avutil.h
+  Add av_fopen_utf8()
+
+2013-08-xx - xxxxxxx - lavu 52.17.0 - avframe.h
+  Add AVFrame.flags and AV_FRAME_FLAG_CORRUPT.
+
+2013-10-27 - xxxxxxx - lavc 55.39.100 - avcodec.h
+  Add CODEC_CAP_DELAY support to avcodec_decode_subtitle2.
+
+2013-10-27 - xxxxxxx - lavu 52.48.100 - parseutils.h
+  Add av_get_known_color_name().
+
+2013-10-17 - xxxxxxx - lavu 52.47.100 - opt.h
+  Add AV_OPT_TYPE_CHANNEL_LAYOUT and channel layout option handlers
+  av_opt_get_channel_layout() and av_opt_set_channel_layout().
+
+2013-10-xx - xxxxxxx -libswscale 2.5.101 - options.c
+  Change default scaler to bicubic
+
+2013-10-03 - xxxxxxx - lavc 55.34.100 - avcodec.h
+  Add av_codec_get_max_lowres()
+
+2013-10-02 - xxxxxxx - lavf 55.19.100 - avformat.h
+  Add audio/video/subtitle AVCodec fields to AVFormatContext to force specific
+  decoders
+
+2013-08-xx - xxxxxxx - lavfi 3.11.0 - avfilter.h
+  Add AVFilterGraph.execute and AVFilterGraph.opaque for custom slice threading
+  implementations.
+
+2013-09-21 - xxxxxxx - lavu 52.16.0 - pixfmt.h
+  Add interleaved 4:2:2 8/10-bit formats AV_PIX_FMT_NV16 and
+  AV_PIX_FMT_NV20.
+
 2013-09-16 - c74c3fb / 3feb3d6 - lavu 52.44.100 / 52.15.0 - mem.h
   Add av_reallocp.
 
@@ -27,7 +122,7 @@ API changes, most recent first:
 2013-08-29 - e31db62 - lavf 55.15.100 - avformat.h
   Add av_format_get_probe_score().
 
-2013-08-xx - xxxxxxx - lsws 2.5.100 -
+2013-08-15 - 1e0e193 - lsws 2.5.100 -
   Add a sws_dither AVOption, allowing to set the dither algorithm used
 
 2013-08-xx - xxxxxxx - lavc 55.27.100 - vdpau.h
@@ -55,21 +150,21 @@ API changes, most recent first:
 2013-08-02 - 82fdfe8 / a8b1927 - lavc 55.20.100 / 55.11.0 - avcodec.h
   Add output_picture_number to AVCodecParserContext.
 
-2013-07-XX - xxxxxxx - XXXXXXXXXXXXXX - avcodec.h
+2013-07-23 - abc8110 - lavc 55.19.100 - avcodec.h
   Add avcodec_chroma_pos_to_enum()
   Add avcodec_enum_to_chroma_pos()
 
-2013-07-03 - xxxxxxx - lavfi 3.78.100 - avfilter.h
+2013-07-03 - 838bd73 - lavfi 3.78.100 - avfilter.h
   Deprecate avfilter_graph_parse() in favor of the equivalent
   avfilter_graph_parse_ptr().
 
 2013-06-24 - af5f9c0 / 95d5246 - lavc 55.17.100 / 55.10.0 - avcodec.h
   Add MPEG-2 AAC profiles
 
-2013-06-xx - xxxxxxx - lavf 55.10.100 - avformat.h
+2013-06-25 - af5f9c0 / 95d5246 - lavf 55.10.100 - avformat.h
   Add AV_DISPOSITION_* flags to indicate text track kind.
 
-2013-06-xx - xxxxxxx - lavu 52.36.100
+2013-06-15 - 99b8cd0 - lavu 52.36.100
   Add AVRIPEMD:
    av_ripemd_alloc()
    av_ripemd_init()
@@ -99,42 +194,42 @@ API changes, most recent first:
 2013-05-24 - 0c25c39 / b493847 - lavc 55.7.0 / 55.12.100 - avcodec.h
   Add picture_structure to AVCodecParserContext.
 
-2013-05-17 - xxxxxxx - lavu 52.33.100 - opt.h
+2013-05-17 - 3a751ea - lavu 52.33.100 - opt.h
   Add AV_OPT_TYPE_COLOR value to AVOptionType enum.
 
-2013-05-13 - xxxxxxx - lavu 52.31.100 - mem.h
+2013-05-13 - e398416 - lavu 52.31.100 - mem.h
   Add av_dynarray2_add().
 
-2013-05-12 - xxxxxxx - lavfi 3.65.100
+2013-05-12 - 1776177 - lavfi 3.65.100
   Add AVFILTER_FLAG_SUPPORT_TIMELINE* filter flags.
 
-2013-04-19 - xxxxxxx - lavc 55.4.100
+2013-04-19 - 380cfce - lavc 55.4.100
   Add AV_CODEC_PROP_TEXT_SUB property for text based subtitles codec.
 
-2013-04-18 - xxxxxxx - lavf 55.3.100
+2013-04-18 - 7c1a002 - lavf 55.3.100
   The matroska demuxer can now output proper verbatim ASS packets. It will
   become the default starting lavf 56.0.100.
 
-2013-04-10 - xxxxxxx - lavu 25.26.100 - avutil.h,opt.h
+2013-04-10 - af0d270 - lavu 25.26.100 - avutil.h,opt.h
   Add av_int_list_length()
   and av_opt_set_int_list().
 
-2013-03-30 - xxxxxxx - lavu 52.24.100 - samplefmt.h
+2013-03-30 - 5c73645 - lavu 52.24.100 - samplefmt.h
   Add av_samples_alloc_array_and_samples().
 
-2013-03-29 - xxxxxxx - lavf 55.1.100 - avformat.h
+2013-03-29 - ef7b6b4 - lavf 55.1.100 - avformat.h
   Add av_guess_frame_rate()
 
-2013-03-20 - xxxxxxx - lavu 52.22.100 - opt.h
+2013-03-20 - 8d928a9 - lavu 52.22.100 - opt.h
   Add AV_OPT_TYPE_DURATION value to AVOptionType enum.
 
-2013-03-17 - xxxxxx - lavu 52.20.100 - opt.h
+2013-03-17 - 7aa9af5 - lavu 52.20.100 - opt.h
   Add AV_OPT_TYPE_VIDEO_RATE value to AVOptionType enum.
 
-2013-03-07 - xxxxxx - lavu 52.18.100 - avstring.h,bprint.h
+2013-03-07 - 9767ec6 - lavu 52.18.100 - avstring.h,bprint.h
   Add av_escape() and av_bprint_escape() API.
 
-2013-02-24 - xxxxxx - lavfi 3.41.100 - buffersink.h
+2013-02-24 - b59cd08 - lavfi 3.41.100 - buffersink.h
   Add sample_rates field to AVABufferSinkParams.
 
 2013-01-17 - a1a707f - lavf 54.61.100
@@ -147,7 +242,7 @@ API changes, most recent first:
   Add AVFilterLink.channels, avfilter_link_get_channels()
   and avfilter_ref_get_channels().
 
-2012-12-15 - 2ada584d - lavc 54.80.100 - avcodec.h
+2012-12-15 - 96d815fc - lavc 54.80.100 - avcodec.h
   Add pkt_size field to AVFrame.
 
 2012-11-25 - c70ec631 - lavu 52.9.100 - opt.h
@@ -434,7 +529,7 @@ lavd 54.4.100 / 54.0.0, lavfi 3.5.0
 2012-07-29 - 7c26761 / 681ed00 - lavf 54.22.100 / 54.13.0 - avformat.h
   Add AVFMT_FLAG_NOBUFFER for low latency use cases.
 
-2012-07-10 - 5fade8a - lavu 51.37.0
+2012-07-10 - fbe0245 / f3e5e6f - lavu 51.65.100 / 51.37.0
   Add av_malloc_array() and av_mallocz_array()
 
 2012-06-22 - e847f41 / d3d3a32 - lavu 51.61.100 / 51.34.0