X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=doc%2FAPIchanges;h=cfab8c6d68bccd6fddffdb38234972ddde74e703;hb=5d8bea3bb2357bb304f8f771a4107039037c5549;hp=48b925bd5401087ff65a85d5159ccf1129e829fe;hpb=1155fd02ae7bac215acab316e847c6bb25f74fc3;p=ffmpeg diff --git a/doc/APIchanges b/doc/APIchanges index 48b925bd540..cfab8c6d68b 100644 --- a/doc/APIchanges +++ b/doc/APIchanges @@ -2,31 +2,314 @@ 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: 2014-08-09 +libavdevice: 2014-08-09 +libavfilter: 2014-08-09 +libavformat: 2014-08-09 +libavresample: 2014-08-09 +libswscale: 2014-08-09 +libavutil: 2014-08-09 API changes, most recent first: -2014-xx-xx - xxxxxxx - lavu 53.05.0 - frame.h +2015-xx-xx - lavu 54.17.0 + xxxxxxx - Add av_blowfish_alloc(). + xxxxxxx - Add av_rc4_alloc(). + xxxxxxx - Add av_xtea_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-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-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-05-01 - 5fcceda - avcodec.h + Deprecate CODEC_FLAG_INPUT_PRESERVED. Its functionality is replaced by passing + reference-counted frames to encoders. + +2014-04-28 - ed4b757 - lavc 55.50.0 - dxva2.h + Add FF_DXVA2_WORKAROUND_INTEL_CLEARVIDEO for old Intel GPUs. + +2014-04-22 - 502512e - lavu 53.13.0 - avutil.h + Add av_get_time_base_q(). + +2014-04-17 - 0983d48 - lavu 53.12.0 - crc.h + Add AV_CRC_16_ANSI_LE crc variant. + +2014-04-07 - 8b17243 - lavu 53.11.0 - pixfmt.h + Add AV_PIX_FMT_YVYU422 pixel format. + +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-03 - 7763118 - lavu 53.09.0 - log.h + Add AV_LOG(c) macro to have 256 color debug messages. + +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-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-03-24 - 5a7e35d - lavc 55.36.0 - avcodec.h + Add AV_PKT_DATA_REPLAYGAIN for exporting replaygain tags. + +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-03-24 - 0e2c3ee - lavc 55.35.0 - avcodec.h + Give the name AVPacketSideData to the previously anonymous struct used for + AVPacket.side_data. + +2014-03-16 - 1481d24 - lavu 53.06.0 - pixfmt.h + Add RGBA64 pixel format and variants. + +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. @@ -78,7 +361,7 @@ API changes, most recent first: Add ITU-R BT.2020 and other not yet included values to color primaries, transfer characteristics and colorspaces. -2013-10-31 - 28096e0 - lavu 52.17.0 - avframe.h +2013-10-31 - 28096e0 - lavu 52.17.0 - frame.h Add AVFrame.flags and AV_FRAME_FLAG_CORRUPT. 2013-09-28 - 0767bfd - lavfi 3.11.0 - avfilter.h @@ -501,6 +784,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. @@ -514,6 +800,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.