]> git.sesse.net Git - ffmpeg/blobdiff - doc/APIchanges
lavu: Drop the {minus,plus}1 suffix from AVComponentDescriptor fields
[ffmpeg] / doc / APIchanges
index 49b15d460549222892c68fb674ad8f907b186e0d..fb9d305106c2a6d5f841ba488cf614a06561ba05 100644 (file)
@@ -2,23 +2,242 @@ Never assume the API of libav* to be stable unless at least 1 month has passed
 since the last major version increase.
 
 The last version increases were:
-libavcodec:    2013-03-xx
-libavdevice:   2013-03-xx
-libavfilter:   2013-12-xx
-libavformat:   2013-03-xx
-libavresample: 2012-10-05
-libswscale:    2011-06-20
-libavutil:     2013-12-xx
+libavcodec:    2015-08-28
+libavdevice:   2015-08-28
+libavfilter:   2015-08-28
+libavformat:   2015-08-28
+libavresample: 2015-08-28
+libswscale:    2015-08-28
+libavutil:     2015-08-28
 
 
 API changes, most recent first:
 
+2015-xx-xx - lavu 55.0.0
+  xxxxxxx - Change type of AVPixFmtDescriptor.flags from uint8_t to uint64_t.
+  xxxxxxx - Change type of AVComponentDescriptor fields from uint16_t to int
+            and drop bit packing.
+  xxxxxxx - Add step, offset, and depth to AVComponentDescriptor to replace
+            the deprecated step_minus1, offset_plus1, and depth_minus1.
+
+2015-xx-xx - lavu 54.17.0
+  xxxxxxx -  Add av_blowfish_alloc().
+  xxxxxxx -  Add av_rc4_alloc().
+  xxxxxxx -  Add av_xtea_alloc().
+  xxxxxxx -  Add av_des_alloc().
+
+2015-07-29 - 7e38340 - lavu 54.16.0 - hmac.h
+  Add AV_HMAC_SHA224 and AV_HMAC_SHA256.
+
+2015-xx-xx - lavc 56.35.0 - avcodec.h
+  xxxxxxxxx - Rename CODEC_FLAG* defines to AV_CODEC_FLAG*.
+  xxxxxxxxx - Rename CODEC_CAP_* defines to AV_CODEC_CAP_*.
+  xxxxxxxxx - Rename FF_INPUT_BUFFER_PADDING_SIZE and FF_MIN_BUFFER_SIZE
+              to AV_INPUT_BUFFER_PADDING_SIZE and AV_INPUT_BUFFER_MIN_SIZE.
+
+2015-xx-xx - xxxxxxx - lavc 56.33.0 - avcodec.h
+  Add AV_PKT_DATA_QUALITY_FACTOR to export the quality value of an AVPacket.
+
+2015-xx-xx - xxxxxxx - lavu 56.15.0
+  Add av_version_info().
+
+2015-xx-xx - xxxxxxx - lavfi 5.1.0 - version.h
+             xxxxxxx - lavd 55.2.0 - version.h
+  Add library identification symbols, LIBAVFILTER_IDENT and LIBAVDEVICE_IDENT.
+
+2015-xx-xx - xxxxxxx - lavf 56.20.0 - avio.h
+  Add avio_put_str16be.
+
+2015-xx-xx - xxxxxxx - lavu 54.14.0 - cpu.h
+  Add AV_CPU_FLAG_AVXSLOW.
+
+2015-xx-xx - xxxxxxx - lavc 56.23.0
+  Add av_vda_default_init2.
+
+2015-xx-xx - xxxxxxx - lavu 54.12.0
+  Add AV_LOG_TRACE for extremely verbose debugging.
+
+2015-xx-xx - xxxxxxx - lavu 54.11.0
+  Add av_small_strptime().
+
+2015-xx-xx - xxxxxxx - lavc 56.22.0
+  Add FF_PROFILE_DTS_EXPRESS.
+
+2015-xx-xx - xxxxxxx - lavu 54.10.0
+  Add AV_PIX_FMT_MMAL for MMAL hardware acceleration.
+
+2015-xx-xx - xxxxxxx - lavc 56.13
+  Add width, height, coded_width, coded_height and format to
+  AVCodecParserContext.
+
+2015-xx-xx - xxxxxxx - lavu 54.9.0
+  Add AV_PIX_FMT_QSV for QSV hardware acceleration.
+
+2015-01-27 - 728685f - lavc 56.12.0, lavu 54.8.0 - avcodec.h, frame.h
+  Add AV_PKT_DATA_AUDIO_SERVICE_TYPE and AV_FRAME_DATA_AUDIO_SERVICE_TYPE for
+  storing the audio service type as side data.
+
+2015-01-14 - e2ad0b6 - lavu 54.6.0 - imgutils.h
+  Add utility functions for image manipulation: av_image_get_buffer_size()
+  av_image_fill_arrays() and av_image_copy_to_buffer().
+
+2014-12-25 - c220a60 - lavc 56.10.0 - vdpau.h
+  Add av_vdpau_get_surface_parameters().
+
+2014-12-25 - 6c99c92 - lavc 56.9.0 - avcodec.h
+  Add AV_HWACCEL_FLAG_ALLOW_HIGH_DEPTH flag to av_vdpau_bind_context().
+
+2014-12-25 - 57b6704 - lavc 56.8.0 - avcodec.h
+  Add AVCodecContext.sw_pix_fmt.
+
+2014-11-07 - 1384df6 - lavf 56.06.3 - avformat.h
+  Add AVFormatContext.avoid_negative_ts.
+
+2014-11-06 - 5e80fb7 - lavc 56.6.0 - vorbis_parser.h
+  Add a public API for parsing vorbis packets.
+
+2014-10-24 - 1bd0bdc - lavu 54.5.0 - time.h
+  Add av_gettime_relative().
+
+2014-10-15 - 7ea1b34 - lavc 56.5.0 - avcodec.h
+  Replace AVCodecContext.time_base used for decoding
+  with AVCodecContext.framerate.
+
+2014-10-15 - d565fef1- lavc 56.4.0 - avcodec.h
+  Add AV_HWACCEL_FLAG_IGNORE_LEVEL flag to av_vdpau_bind_context().
+
+2014-10-13 - 2df0c32 - lavc 56.03.0 - avcodec.h
+  Add AVCodecContext.initial_padding. Deprecate the use of AVCodecContext.delay
+  for audio encoding.
+
+2014-10-08 - 5a419b2 - lavu 54.04.0 - pixdesc.h
+  Add API to return the name of frame and context color properties.
+
+2014-10-06 - e3e158e - lavc 56.2.0 - vdpau.h
+  Add av_vdpau_bind_context(). This function should now be used for creating
+  (or resetting) a AVVDPAUContext instead of av_vdpau_alloc_context().
+
+2014-08-25 - b263f8f - lavf 56.03.0 - avformat.h
+  Add AVFormatContext.max_ts_probe.
+
+------------------------------8<-------------------------------------
+                   11 branch was cut here
+----------------------------->8--------------------------------------
+
+2014-08-28 - 9301486 - lavc 56.1.0 - avcodec.h
+  Add AV_PKT_DATA_STEREO3D to export container-level stereo3d information.
+
+2014-08-13 - 8ddc326 - lavu 54.03.0 - mem.h
+  Add av_strndup().
+
+2014-08-13 - a8c104a - lavu 54.02.0 - opt.h
+  Add av_opt_get_dict_val/set_dict_val with AV_OPT_TYPE_DICT to support
+  dictionary types being set as options.
+
+2014-08-13 - afbd4b8 - lavf 56.01.0 - avformat.h
+  Add AVFormatContext.event_flags and AVStream.event_flags for signaling to
+  the user when events happen in the file/stream.
+
+2014-08-10 - fb1ddcd - lavr 2.1.0 - avresample.h
+  Add avresample_convert_frame() and avresample_config().
+
+2014-08-10 - fb1ddcd - lavu 54.1.0 - error.h
+  Add AVERROR_INPUT_CHANGED and AVERROR_OUTPUT_CHANGED.
+
+2014-08-08 - d35b94f - lavc 55.57.4 - avcodec.h
+  Deprecate FF_IDCT_XVIDMMX define and xvidmmx idct option.
+  Replaced by FF_IDCT_XVID and xvid respectively.
+
+2014-08-07 - bb78903 - lsws 2.1.3 - swscale.h
+  sws_getCachedContext is not going to be removed in the future.
+
+2014-08-07 - ad1ee5f - lavc 55.57.3 - avcodec.h
+  reordered_opaque is not going to be removed in the future.
+
+2014-08-04 - e9abafc - lavu 53.22.0 - pixfmt.h
+  Add AV_PIX_FMT_YA16 pixel format for 16 bit packed gray with alpha.
+
+2014-08-04 - e96c3b8 - lavu 53.21.1 - avstring.h
+  Rename AV_PIX_FMT_Y400A to AV_PIX_FMT_YA8 to better identify the format.
+  An alias pixel format and color space name are provided for compatibility.
+
+2014-08-04 - d2962e9 - lavu 53.21.0 - pixdesc.h
+  Support name aliases for pixel formats.
+
+2014-08-03 - 1ef9e83 - lavc 55.57.2 - avcodec.h
+2014-08-03 - 1ef9e83 - lavu 53.20.0 - frame.h
+  Deprecate AVCodecContext.dtg_active_format and use side-data instead.
+
+2014-08-03 - 9f17685 - lavc 55.57.1 - avcodec.h
+  Deprecate unused FF_IDCT_IPP define and ipp avcodec option.
+  Deprecate unused FF_DEBUG_PTS define and pts avcodec option.
+  Deprecate unused FF_CODER_TYPE_DEFLATE define and deflate avcodec option.
+  Deprecate unused FF_DCT_INT define and int avcodec option.
+  Deprecate unused avcodec option scenechange_factor.
+
+2014-07-29 - 69e7336 - lavu 53.19.0 - avstring.h
+  Make name matching function from lavf public as av_match_name().
+
+2014-07-28 - c5fca01 - lavc 55.57.0 - avcodec.h
+  Add AV_CODEC_PROP_REORDER to mark codecs supporting frame reordering.
+
+2014-07-09 - a54f03b - lavu 53.18.0 - display.h
+  Add av_display_matrix_flip() to flip the transformation matrix.
+
+2014-07-09 - f6ee61f - lavc 55.56.0 - dv_profile.h
+  Add a public API for DV profile handling.
+
+2014-06-20 - 9e500ef - lavu 53.17.0 - imgutils.h
+  Add av_image_check_sar().
+
+2014-06-20 - 874390e - lavc 55.55.0 - avcodec.h
+  Add av_packet_rescale_ts() to simplify timestamp conversion.
+
+2014-06-18 - 194be1f - lavf 55.20.0 - avformat.h
+  The proper way for providing a hint about the desired timebase to the muxers
+  is now setting AVStream.time_base, instead of AVStream.codec.time_base as was
+  done previously. The old method is now deprecated.
+
+2014-06-01 - 0957b27 - lavc 55.54.0 - avcodec.h
+  Add AVCodecContext.side_data_only_packets to allow encoders to output packets
+  with only side data. This option may become mandatory in the future, so all
+  users are recommended to update their code and enable this option.
+
+2014-06-01 - 8c02adc - lavu 53.16.0 - frame.h, pixfmt.h
+  Move all color-related enums (AVColorPrimaries, AVColorSpace, AVColorRange,
+  AVColorTransferCharacteristic, and AVChromaLocation) inside lavu.
+  Add AVFrame fields for them on the next lavu major bump.
+
+2014-05-28 - b2d4565 - lavr 1.3.0 - avresample.h
+  Add avresample_max_output_samples
+
+2014-05-28 - 6d21259 - lavf 55.19.0 - avformat.h
+  Add strict_std_compliance and related AVOptions to support experimental
+  muxing.
+
+2014-05-20 - c23c96b - lavf 55.18.0 - avformat.h
+  Add av_stream_get_side_data() to access stream-level side data
+  in the same way as av_packet_get_side_data().
+
+2014-05-19 - bddd8cb - lavu 53.15.0 - frame.h, display.h
+  Add AV_FRAME_DATA_DISPLAYMATRIX for exporting frame-level
+  spatial rendering on video frames for proper display.
+
+2014-05-19 - bddd8cb - lavc 55.53.0 - avcodec.h
+  Add AV_PKT_DATA_DISPLAYMATRIX for exporting packet-level
+  spatial rendering on video frames for proper display.
+
+2014-05-19 - a312f71 - lavf 55.17.1 - avformat.h
+  Deprecate AVStream.pts and the AVFrac struct, which was its only use case.
+  Those fields were poorly defined and not meant to be public, so there is
+  no replacement for them.
+
 2014-05-18 - fd05602 - lavc 55.52.0 - avcodec.h
   Add avcodec_free_context(). From now on it should be used for freeing
   AVCodecContext.
 
 2014-05-15 - 0c1959b - lavf 55.17.0 - avformat.h
-  Add AVMFT_FLAG_BITEXACT flag. Muxers now use it instead of checking
+  Add AVFMT_FLAG_BITEXACT flag. Muxers now use it instead of checking
   CODEC_FLAG_BITEXACT on the first stream.
 
 2014-05-11 - 66e6c8a - lavu 53.14.0 - pixfmt.h
@@ -94,6 +313,10 @@ API changes, most recent first:
 2014-02-19 - 6bb8720 - lavu 53.03.01 - opt.h
   Deprecate unused AV_OPT_FLAG_METADATA.
 
+------------------------------8<-------------------------------------
+                   10 branch was cut here
+----------------------------->8--------------------------------------
+
 2014-02-15 - c98f316 - lavu 53.3.0 - frame.h
   Add AV_FRAME_DATA_DOWNMIX_INFO value to the AVFrameSideDataType enum and
   downmix_info.h API, which identify downmix-related metadata.
@@ -569,6 +792,9 @@ lavd 54.0.0, lavfi 3.5.0
   Add avformat_close_input().
   Deprecate av_close_input_file() and av_close_input_stream().
 
+2011-12-09 - b2890f5 - lavu 51.20.0 - audioconvert.h
+  Expand the channel layout list.
+
 2011-12-02 - 0eea212 - lavc 53.25.0
   Add nb_samples and extended_data fields to AVFrame.
   Deprecate AVCODEC_MAX_AUDIO_FRAME_SIZE.
@@ -582,6 +808,10 @@ lavd 54.0.0, lavfi 3.5.0
   Change AVCodecContext.error[4] to [8] at next major bump.
   Add AV_NUM_DATA_POINTERS to simplify the bump transition.
 
+2011-11-24 - lavu 51.19.0
+  bd97b2e - add planar RGB pixel formats
+  6b0768e - add PIX_FMT_PLANAR and PIX_FMT_RGB pixel descriptions
+
 2011-11-23 - bbb46f3 - lavu 51.18.0
   Add av_samples_get_buffer_size(), av_samples_fill_arrays(), and
   av_samples_alloc(), to samplefmt.h.