]> git.sesse.net Git - ffmpeg/blobdiff - doc/APIchanges
lavu: Drop the {minus,plus}1 suffix from AVComponentDescriptor fields
[ffmpeg] / doc / APIchanges
index f392c53d01ebfcb6ae5177b874d24323044843d7..fb9d305106c2a6d5f841ba488cf614a06561ba05 100644 (file)
@@ -2,88 +2,322 @@ 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:
 
-2014-04-xx - xxxxxxx - lavc 55.50.3 - avcodec.h
+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 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
+  Add AV_PIX_FMT_VDA for new-style VDA acceleration.
+
+2014-05-01 - a2941c8 - lavc 55.50.3 - avcodec.h
   Deprecate CODEC_FLAG_MV0. It is replaced by the flag "mv0" in the
   "mpv_flags" private option of the mpegvideo encoders.
 
-2014-04-xx - xxxxxxx - lavc 55.50.2 - avcodec.h
+2014-05-01 - 6484149 - lavc 55.50.2 - avcodec.h
   Deprecate CODEC_FLAG_GMC. It is replaced by the "gmc" private option of the
   libxvid encoder.
 
-2014-04-xx - xxxxxxx - lavc 55.50.1 - avcodec.h
+2014-05-01 - b2c3171 - lavc 55.50.1 - avcodec.h
   Deprecate CODEC_FLAG_NORMALIZE_AQP. It is replaced by the flag "naq" in the
   "mpv_flags" private option of the mpegvideo encoders.
 
-2014-04-xx - xxxxxxx - avcodec.h
+2014-05-01 - 5fcceda - avcodec.h
   Deprecate CODEC_FLAG_INPUT_PRESERVED. Its functionality is replaced by passing
   reference-counted frames to encoders.
 
-2014-04-xx - xxxxxxx - lavc 55.50.0 - dxva2.h
+2014-04-28 - ed4b757 - lavc 55.50.0 - dxva2.h
   Add FF_DXVA2_WORKAROUND_INTEL_CLEARVIDEO for old Intel GPUs.
 
-2014-04-xx - xxxxxxx - lavu 53.13.0 - avutil.h
+2014-04-22 - 502512e - lavu 53.13.0 - avutil.h
   Add av_get_time_base_q().
 
-2014-04-xx - xxxxxxx - lavu 53.12.0 - crc.h
+2014-04-17 - 0983d48 - lavu 53.12.0 - crc.h
   Add AV_CRC_16_ANSI_LE crc variant.
 
-2014-04-xx - xxxxxxx - lavu 53.11.0 - pixfmt.h
+2014-04-07 - 8b17243 - lavu 53.11.0 - pixfmt.h
   Add AV_PIX_FMT_YVYU422 pixel format.
 
-2014-04-xx - xxxxxxx - lavu 53.10.0 - replaygain.h
+2014-04-04 - 8542f9c - lavu 53.10.0 - replaygain.h
   Full scale for peak values is now 100000 (instead of UINT32_MAX) and values
   may overflow.
 
-2014-04-xx - xxxxxxx - lavu 53.09.0 - log.h
+2014-04-03 - 7763118 - lavu 53.09.0 - log.h
   Add AV_LOG(c) macro to have 256 color debug messages.
 
-2014-02-xx - xxxxxxx - lavu 53.08.0 - frame.h
+2014-03-24 - d161ae0 - lavu 53.08.0 - frame.h
   Add av_frame_remove_side_data() for removing a single side data
   instance from a frame.
 
-2014-02-xx - xxxxxxx - lavu 53.07.0 - frame.h, replaygain.h
+2014-03-24 - 5a7e35d - lavu 53.07.0 - frame.h, replaygain.h
   Add AV_FRAME_DATA_REPLAYGAIN for exporting replaygain tags.
   Add a new header replaygain.h with the AVReplayGain struct.
 
-2014-02-xx - xxxxxxx - lavc 55.36.0 - avcodec.h
+2014-03-24 - 5a7e35d - lavc 55.36.0 - avcodec.h
   Add AV_PKT_DATA_REPLAYGAIN for exporting replaygain tags.
 
-2014-02-xx - xxxxxxx - lavf 55.13.0 - avformat.h
+2014-03-24 - 25b3258 - lavf 55.13.0 - avformat.h
   Add AVStream.side_data and AVStream.nb_side_data for exporting stream-global
   side data (e.g. replaygain tags, video rotation)
 
-2014-02-xx - xxxxxxx - lavc 55.35.0 - avcodec.h
+2014-03-24 - 0e2c3ee - lavc 55.35.0 - avcodec.h
   Give the name AVPacketSideData to the previously anonymous struct used for
   AVPacket.side_data.
 
-2014-xx-xx - xxxxxxx - lavu 53.06.0 - pixfmt.h
+2014-03-16 - 1481d24 - lavu 53.06.0 - pixfmt.h
   Add RGBA64 pixel format and variants.
 
-2014-xx-xx - xxxxxxx - lavu 53.05.0 - frame.h
+2014-02-24 - 1155fd0 - lavu 53.05.0 - frame.h
   Add av_frame_copy() for copying the frame data.
 
-2014-02-xx - xxxxxxx - lavr 1.2.0 - avresample.h
+2014-02-22 - 7e86c27 - lavr 1.2.0 - avresample.h
   Add avresample_is_open() for checking whether a resample context is open.
 
-2014-xx-xx - xxxxxxx - lavu 53.04.0  - opt.h
+2014-02-19 - c3ecd96 - lavu 53.04.0  - opt.h
   Add AV_OPT_FLAG_EXPORT and AV_OPT_FLAG_READONLY to mark options meant (only)
   for reading.
 
-2014-xx-xx - xxxxxxx - lavu 53.03.01 - opt.h
+2014-02-19 - 6bb8720 - lavu 53.03.01 - opt.h
   Deprecate unused AV_OPT_FLAG_METADATA.
 
-2014-02-xx - xxxxxxx - lavu 53.3.0 - frame.h
+------------------------------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.
 
@@ -558,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.
@@ -571,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.