X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=doc%2FAPIchanges;h=c46f4d5304a6859418147f7f0833441f2a3b7959;hb=bd96c54fe4819b3ca9a975e2083d67f4443c559b;hp=67f2ac360f8f2e5dedcb3457eed3bf8b710ed8ce;hpb=448a9aaa78119e0ac059ed08fa17613df63c780b;p=ffmpeg diff --git a/doc/APIchanges b/doc/APIchanges index 67f2ac360f8..c46f4d5304a 100644 --- a/doc/APIchanges +++ b/doc/APIchanges @@ -2,32 +2,193 @@ Never assume the API of libav* to be stable unless at least 1 month has passed since the last major version increase or the API was added. The last version increases were: -libavcodec: 2017-10-21 -libavdevice: 2017-10-21 -libavfilter: 2017-10-21 -libavformat: 2017-10-21 -libavresample: 2017-10-21 -libpostproc: 2017-10-21 -libswresample: 2017-10-21 -libswscale: 2017-10-21 -libavutil: 2017-10-21 +libavcodec: 2021-04-27 +libavdevice: 2021-04-27 +libavfilter: 2021-04-27 +libavformat: 2021-04-27 +libpostproc: 2021-04-27 +libswresample: 2021-04-27 +libswscale: 2021-04-27 +libavutil: 2021-04-27 API changes, most recent first: -2020-07-xx - xxxxxxxxxx - lavc 58.96.100 - packet.h +2021-04-27 - cb3ac722f4 - lavc 59.0.100 - avcodec.h + Constified AVCodecParserContext.parser. + +2021-04-27 - 8b3e6ce5f4 - lavd 59.0.100 - avdevice.h + The av_*_device_next API functions now accept and return + pointers to const AVInputFormat resp. AVOutputFormat. + +2021-04-27 - d7e0d428fa - lavd 59.0.100 - avdevice.h + avdevice_list_input_sources and avdevice_list_output_sinks now accept + pointers to const AVInputFormat resp. const AVOutputFormat. + +2021-04-27 - 46dac8cf3d - lavf 59.0.100 - avformat.h + av_find_best_stream now uses a const AVCodec ** parameter + for the returned decoder. + +2021-04-27 - 626535f6a1 - lavc 59.0.100 - codec.h + avcodec_find_encoder_by_name(), avcodec_find_encoder(), + avcodec_find_decoder_by_name() and avcodec_find_decoder() + now return a pointer to const AVCodec. + +2021-04-27 - 14fa0a4efb - lavf 59.0.100 - avformat.h + Constified AVFormatContext.*_codec. + +2021-04-27 - 56450a0ee4 - lavf 59.0.100 - avformat.h + Constified the pointers to AVInputFormats and AVOutputFormats + in AVFormatContext, avformat_alloc_output_context2(), + av_find_input_format(), av_probe_input_format(), + av_probe_input_format2(), av_probe_input_format3(), + av_probe_input_buffer2(), av_probe_input_buffer(), + avformat_open_input(), av_guess_format() and av_guess_codec(). + Furthermore, constified the AVProbeData in av_probe_input_format(), + av_probe_input_format2() and av_probe_input_format3(). + +2021-04-19 - 18af1ea8d1 - lavu 56.74.100 - tx.h + Add AV_TX_FULL_IMDCT and AV_TX_UNALIGNED. + +2021-04-17 - f1bf465aa0 - lavu 56.73.100 - frame.h detection_bbox.h + Add AV_FRAME_DATA_DETECTION_BBOXES + +2021-04-06 - 557953a397 - lavf 58.78.100 - avformat.h + Add avformat_index_get_entries_count(), avformat_index_get_entry(), + and avformat_index_get_entry_from_timestamp(). + +2021-03-21 - a77beea6c8 - lavu 56.72.100 - frame.h + Deprecated av_get_colorspace_name(). + Use av_color_space_name() instead. + +-------- 8< --------- FFmpeg 4.4 was cut here -------- 8< --------- + +2021-03-19 - e8c0bca6bd - lavu 56.69.100 - adler32.h + Added a typedef for the type of the Adler-32 checksums + used by av_adler32_update(). It will be changed to uint32_t + at the next major bump. + The type of the parameter for the length of the input buffer + will also be changed to size_t at the next major bump. + +2021-03-19 - e318438f2f - lavf 58.75.100 - avformat.h + AVChapter.id will be changed from int to int64_t + on the next major version bump. + +2021-03-17 - f7db77bd87 - lavc 58.133.100 - codec.h + Deprecated av_init_packet(). Once removed, sizeof(AVPacket) will + no longer be a part of the public ABI. + Deprecated AVPacketList. + +2021-03-16 - 7d09579190 - lavc 58.132.100 - codec.h + Add AV_CODEC_CAP_OTHER_THREADS as a new name for + AV_CODEC_CAP_AUTO_THREADS. AV_CODEC_CAP_AUTO_THREADS + is now deprecated. + +2021-03-12 - 6e7e3a3820 - lavc 58.131.100 - avcodec.h codec.h + Add a get_encode_buffer callback to AVCodecContext, similar to + get_buffer2 but for encoders. + Add avcodec_default_get_encode_buffer(). + Add AV_GET_ENCODE_BUFFER_FLAG_REF. + Encoders may now be flagged as AV_CODEC_CAP_DR1 capable. + +2021-03-10 - 42e68fe015 - lavf 58.72.100 - avformat.h + Change AVBufferRef related AVStream function and struct size + parameter and fields type to size_t at next major bump. + +2021-03-10 - d79e0fe65c - lavc 58.130.100 - packet.h + Change AVBufferRef related AVPacket function and struct size + parameter and fields type to size_t at next major bump. + +2021-03-10 - 14040a1d91 - lavu 56.68.100 - buffer.h frame.h + Change AVBufferRef and relevant AVFrame function and struct size + parameter and fields type to size_t at next major bump. + +2021-03-04 - a0eec776b6 - lavc 58.128.101 - avcodec.h + Enable err_recognition to be set for encoders. + +2021-03-03 - 2ff40b98ec - lavf 58.70.100 - avformat.h + Deprecate AVFMT_FLAG_PRIV_OPT. It will do nothing + as soon as av_demuxer_open() is removed. + +2021-02-27 - dd9227e48f - lavc 58.126.100 - avcodec.h + Deprecated avcodec_get_frame_class(). + +2021-02-21 - 5ca40d6d94 - lavu 56.66.100 - tx.h + Add enum AVTXFlags and AVTXFlags.AV_TX_INPLACE + +2021-02-14 - 4f49ca7bbc - lavd 58.12.100 - avdevice.h + Deprecated avdevice_capabilities_create() and + avdevice_capabilities_free(). + +2021-02-10 - 1bda9bb68a - lavu 56.65.100 - common.h + Add FFABS64U() + +2021-01-26 - 5dd9567080 - lavu 56.64.100 - common.h + Add FFABSU() + +2021-01-25 - 56709ca8aa - lavc 58.119.100 - avcodec.h + Deprecate AVCodecContext.debug_mv, FF_DEBUG_VIS_MV_P_FOR, FF_DEBUG_VIS_MV_B_FOR, + FF_DEBUG_VIS_MV_B_BACK + +2021-01-11 - ebdd33086a - lavc 58.116.100 - avcodec.h + Add FF_PROFILE_VVC_MAIN_10 and FF_PROFILE_VVC_MAIN_10_444. + +2020-01-01 - baecaa16c1 - lavu 56.63.100 - video_enc_params.h + Add AV_VIDEO_ENC_PARAMS_MPEG2 + +2020-12-03 - eca12f4d5a - lavu 56.62.100 - timecode.h + Add av_timecode_init_from_components. + +2020-11-27 - a83098ab03 - lavc 58.114.100 - avcodec.h + Deprecate AVCodecContext.thread_safe_callbacks. Starting with + LIBAVCODEC_VERSION_MAJOR=60, user callbacks must always be + thread-safe when frame threading is used. + +2020-11-25 - d243dd540a - lavc 58.113.100 - avcodec.h + Adds a new flag AV_CODEC_EXPORT_DATA_FILM_GRAIN for export_side_data. + +2020-11-25 - 4f9ee87253 - lavu 56.61.100 - film_grain_params.h + Adds a new API for extracting codec film grain parameters as side data. + Adds a new AVFrameSideDataType entry AV_FRAME_DATA_FILM_GRAIN_PARAMS for it. + +2020-10-28 - f95d9510ff - lavf 58.64.100 - avformat.h + Add AVSTREAM_EVENT_FLAG_NEW_PACKETS. + +2020-09-28 - 68918d3b7f - lavu 56.60.100 - buffer.h + Add a av_buffer_replace() convenience function. + +2020-09-13 - 837b6eb90e - lavu 56.59.100 - timecode.h + Add av_timecode_make_smpte_tc_string2. + +2020-08-21 - 06f2651204 - lavu 56.58.100 - avstring.h + Deprecate av_d2str(). Use av_asprintf() instead. + +2020-08-04 - 34de0abbe7 - lavu 56.58.100 - channel_layout.h + Add AV_CH_LAYOUT_22POINT2 together with its newly required pieces: + AV_CH_TOP_SIDE_LEFT, AV_CH_TOP_SIDE_RIGHT, AV_CH_BOTTOM_FRONT_CENTER, + AV_CH_BOTTOM_FRONT_LEFT, AV_CH_BOTTOM_FRONT_RIGHT. + +2020-07-23 - 84655b7101 - lavu 56.57.100 - cpu.h + Add AV_CPU_FLAG_MMI and AV_CPU_FLAG_MSA. + +2020-07-22 - 3a8e927176 - lavu 56.56.100 - imgutils.h + Add av_image_fill_plane_sizes(). + +2020-07-15 - 448a9aaa78 - lavc 58.96.100 - packet.h Add AV_PKT_DATA_S12M_TIMECODE. 2020-06-12 - b09fb030c1 - lavu 56.55.100 - pixdesc.h Add AV_PIX_FMT_X2RGB10. -2020-06-xx - xxxxxxxxxx - lavu 56.54.100 - frame.h +2020-06-11 - bc8ab084fb - lavu 56.54.100 - frame.h Add AV_FRAME_DATA_SEI_UNREGISTERED. -2020-06-xx - xxxxxxxxxx - lavu 56.53.100 - log.h opt.h +2020-06-10 - 1b4a98b029 - lavu 56.53.100 - log.h opt.h Add av_opt_child_class_iterate() and AVClass.child_class_iterate(). Deprecate av_opt_child_class_next() and AVClass.child_class_next(). +-------- 8< --------- FFmpeg 4.3 was cut here -------- 8< --------- + 2020-06-05 - ec39c2276a - lavu 56.50.100 - buffer.h Passing NULL as alloc argument to av_buffer_pool_init2() is now allowed.