git.sesse.net Git - ffmpeg/blob - doc/APIchanges

   1 Never assume the API of libav* to be stable unless at least 1 month has passed
   2 since the last major version increase.
   3
   4 The last version increases were:
   5 libavcodec:  2011-04-18
   6 libavdevice: 2011-04-18
   7 libavfilter: 2011-04-18
   8 libavformat: 2011-04-18
   9 libpostproc: 2011-04-18
  10 libswscale:  2011-06-20
  11 libavutil:   2011-04-18
  12
  13
  14 API changes, most recent first:
  15
  16 2011-08-02 - 9d39cbf - lavc 53.7.1
  17   Add AV_PKT_FLAG_CORRUPT AVPacket flag.
  18
  19 2011-07-16 - xxxxxx - lavfi 2.27.0
  20   Add audio packing negotiation fields and helper functions.
  21
  22   In particular, add AVFilterPacking enum, planar, in_packings and
  23   out_packings fields to AVFilterLink, and the functions:
  24   avfilter_set_common_packing_formats()
  25   avfilter_all_packing_formats()
  26
  27 2011-07-10 - a67c061 - lavf 53.3.0
  28   Add avformat_find_stream_info(), deprecate av_find_stream_info().
  29
  30 2011-07-10 - 0b950fe - lavc 53.6.0
  31   Add avcodec_open2(), deprecate avcodec_open().
  32
  33 2011-07-01 - b442ca6 - lavf 53.5.0 - avformat.h
  34   Add function av_get_output_timestamp().
  35
  36 2011-06-28 - 5129336 - lavu 51.11.0 - avutil.h
  37   Define the AV_PICTURE_TYPE_NONE value in AVPictureType enum.
  38
  39 2011-06-19 - xxxxxxx - lavfi 2.23.0 - avfilter.h
  40   Add layout negotiation fields and helper functions.
  41
  42   In particular, add in_chlayouts and out_chlayouts to AVFilterLink,
  43   and the functions:
  44   avfilter_set_common_sample_formats()
  45   avfilter_set_common_channel_layouts()
  46   avfilter_all_channel_layouts()
  47
  48 2011-06-19 - xxxxxxx - lavfi 2.22.0 - AVFilterFormats
  49   Change type of AVFilterFormats.formats from int * to int64_t *,
  50   and update formats handling API accordingly.
  51
  52   avfilter_make_format_list() still takes a int32_t array and converts
  53   it to int64_t. A new function, avfilter_make_format64_list(), that
  54   takes int64_t arrays has been added.
  55
  56 2011-06-19 - xxxxxxx - lavfi 2.21.0 - vsink_buffer.h
  57   Add video sink buffer and vsink_buffer.h public header.
  58
  59 2011-06-12 - xxxxxxx - lavfi 2.18.0 - avcodec.h
  60   Add avfilter_get_video_buffer_ref_from_frame() function in
  61   libavfilter/avcodec.h.
  62
  63 2011-06-12 - xxxxxxx - lavfi 2.17.0 - avfiltergraph.h
  64   Add avfilter_inout_alloc() and avfilter_inout_free() functions.
  65
  66 2011-06-12 - xxxxxxx - lavfi 2.16.0 - avfilter_graph_parse()
  67   Change avfilter_graph_parse() signature.
  68
  69 2011-06-23 - 67e9ae1 - lavu 51.8.0 - attributes.h
  70   Add av_printf_format().
  71
  72 2011-06-16 - 05e84c9, 25de595 - lavf 53.2.0 - avformat.h
  73   Add avformat_open_input and avformat_write_header().
  74   Deprecate av_open_input_stream, av_open_input_file,
  75   AVFormatParameters and av_write_header.
  76
  77 2011-06-16 - 7e83e1c, dc59ec5 - lavu 51.7.0 - opt.h
  78   Add av_opt_set_dict() and av_opt_find().
  79   Deprecate av_find_opt().
  80   Add AV_DICT_APPEND flag.
  81
  82 2011-06-10 - cb7c11c - lavu 51.6.0 - opt.h
  83   Add av_opt_flag_is_set().
  84
  85 2011-06-10 - c381960 - lavfi 2.15.0 - avfilter_get_audio_buffer_ref_from_arrays
  86   Add avfilter_get_audio_buffer_ref_from_arrays() to avfilter.h.
  87
  88 2011-06-09 - d9f80ea - lavu 51.8.0 - AVMetadata
  89   Move AVMetadata from lavf to lavu and rename it to
  90   AVDictionary -- new installed header dict.h.
  91   All av_metadata_* functions renamed to av_dict_*.
  92
  93 2011-06-07 - a6703fa - lavu 51.8.0 - av_get_bytes_per_sample()
  94   Add av_get_bytes_per_sample() in libavutil/samplefmt.h.
  95   Deprecate av_get_bits_per_sample_fmt().
  96
  97 2011-06-xx - b39b062 - lavu 51.8.0 - opt.h
  98   Add av_opt_free convenience function.
  99
 100 2011-06-06 - 95a0242 - lavfi 2.14.0 - AVFilterBufferRefAudioProps
 101   Remove AVFilterBufferRefAudioProps.size, and use nb_samples in
 102   avfilter_get_audio_buffer() and avfilter_default_get_audio_buffer() in
 103   place of size.
 104
 105 2011-06-06 - 0bc2cca - lavu 51.6.0 - av_samples_alloc()
 106   Switch nb_channels and nb_samples parameters order in
 107   av_samples_alloc().
 108
 109 2011-06-06 - e1c7414 - lavu 51.5.0 - av_samples_*
 110   Change the data layout created by av_samples_fill_arrays() and
 111   av_samples_alloc().
 112
 113 2011-06-06 - 27bcf55 - lavfi 2.13.0 - vsrc_buffer.h
 114   Make av_vsrc_buffer_add_video_buffer_ref() accepts an additional
 115   flags parameter in input.
 116
 117 2011-06-03 - e977ca2 - lavfi 2.12.0 - avfilter_link_free()
 118   Add avfilter_link_free() function.
 119
 120 2011-06-02 - 5ad38d9 - lavu 51.4.0 - av_force_cpu_flags()
 121   Add av_cpu_flags() in libavutil/cpu.h.
 122
 123 2011-05-28 - e71f260 - lavu 51.3.0 - pixdesc.h
 124   Add av_get_pix_fmt_name() in libavutil/pixdesc.h, and deprecate
 125   avcodec_get_pix_fmt_name() in libavcodec/avcodec.h in its favor.
 126
 127 2011-05-25 - 30315a8 - lavf 53.3.0 - avformat.h
 128   Add fps_probe_size to AVFormatContext.
 129
 130 2011-05-22 - 5ecdfd0 - lavf 53.2.0 - avformat.h
 131   Introduce avformat_alloc_output_context2() and deprecate
 132   avformat_alloc_output_context().
 133
 134 2011-05-22 - 83db719 - lavfi 2.10.0 - vsrc_buffer.h
 135   Make libavfilter/vsrc_buffer.h public.
 136
 137 2011-05-19 - c000a9f - lavfi 2.8.0 - avcodec.h
 138   Add av_vsrc_buffer_add_frame() to libavfilter/avcodec.h.
 139
 140 2011-05-14 - 9fdf772 - lavfi 2.6.0 - avcodec.h
 141   Add avfilter_get_video_buffer_ref_from_frame() to libavfilter/avcodec.h.
 142
 143 2011-05-18 - 64150ff - lavc 53.7.0 - AVCodecContext.request_sample_fmt
 144   Add request_sample_fmt field to AVCodecContext.
 145
 146 2011-05-10 - 188dea1 - lavc 53.6.0 - avcodec.h
 147   Deprecate AVLPCType and the following fields in
 148   AVCodecContext: lpc_coeff_precision, prediction_order_method,
 149   min_partition_order, max_partition_order, lpc_type, lpc_passes.
 150   Corresponding FLAC encoder options should be used instead.
 151
 152 2011-05-07 - 9fdf772 - lavfi 2.5.0 - avcodec.h
 153   Add libavfilter/avcodec.h header and avfilter_copy_frame_props()
 154   function.
 155
 156 2011-05-07 - 18ded93 - lavc 53.5.0 - AVFrame
 157   Add format field to AVFrame.
 158
 159 2011-05-07 - 22333a6 - lavc 53.4.0 - AVFrame
 160   Add width and height fields to AVFrame.
 161
 162 2011-05-01 - 35fe66a - lavfi 2.4.0 - avfilter.h
 163   Rename AVFilterBufferRefVideoProps.pixel_aspect to
 164   sample_aspect_ratio.
 165
 166 2011-05-01 - 77e9dee - lavc 53.3.0 - AVFrame
 167   Add a sample_aspect_ratio field to AVFrame.
 168
 169 2011-05-01 - 1ba5727 - lavc 53.2.0 - AVFrame
 170   Add a pkt_pos field to AVFrame.
 171
 172 2011-04-29 - 35ceaa7 - lavu 51.2.0 - mem.h
 173   Add av_dynarray_add function for adding
 174   an element to a dynamic array.
 175
 176 2011-04-26 - bebe72f - lavu 51.1.0 - avutil.h
 177   Add AVPictureType enum and av_get_picture_type_char(), deprecate
 178   FF_*_TYPE defines and av_get_pict_type_char() defined in
 179   libavcodec/avcodec.h.
 180
 181 2011-04-26 - 10d3940 - lavfi 2.3.0 - avfilter.h
 182   Add pict_type and key_frame fields to AVFilterBufferRefVideo.
 183
 184 2011-04-26 - 7a11c82 - lavfi 2.2.0 - vsrc_buffer
 185   Add sample_aspect_ratio fields to vsrc_buffer arguments
 186
 187 2011-04-21 - 94f7451 - lavc 53.1.0 - avcodec.h
 188   Add CODEC_CAP_SLICE_THREADS for codecs supporting sliced threading.
 189
 190 2011-04-15 - lavc 52.120.0 - avcodec.h
 191   AVPacket structure got additional members for passing side information:
 192     4de339e introduce side information for AVPacket
 193     2d8591c make containers pass palette change in AVPacket
 194
 195 2011-04-12 - lavf 52.107.0 - avio.h
 196   Avio cleanup, part II - deprecate the entire URLContext API:
 197     175389c add avio_check as a replacement for url_exist
 198     ff1ec0c add avio_pause and avio_seek_time as replacements
 199             for _av_url_read_fseek/fpause
 200     cdc6a87 deprecate av_protocol_next(), avio_enum_protocols
 201             should be used instead.
 202     80c6e23 rename url_set_interrupt_cb->avio_set_interrupt_cb.
 203     f87b1b3 rename open flags: URL_* -> AVIO_*
 204     f8270bb add avio_enum_protocols.
 205     5593f03 deprecate URLProtocol.
 206     c486dad deprecate URLContext.
 207     026e175 deprecate the typedef for URLInterruptCB
 208     8e76a19 deprecate av_register_protocol2.
 209     b840484 deprecate URL_PROTOCOL_FLAG_NESTED_SCHEME
 210     1305d93 deprecate av_url_read_seek
 211     fa104e1 deprecate av_url_read_pause
 212     727c7aa deprecate url_get_filename().
 213     5958df3 deprecate url_max_packet_size().
 214     1869ea0 deprecate url_get_file_handle().
 215     32a97d4 deprecate url_filesize().
 216     e52a914 deprecate url_close().
 217     58a48c6 deprecate url_seek().
 218     925e908 deprecate url_write().
 219     dce3756 deprecate url_read_complete().
 220     bc371ac deprecate url_read().
 221     0589da0 deprecate url_open().
 222     62eaaea deprecate url_connect.
 223     5652bb9 deprecate url_alloc.
 224     333e894 deprecate url_open_protocol
 225     e230705 deprecate url_poll and URLPollEntry
 226
 227 2011-04-08 - lavf 52.106.0 - avformat.h
 228   Minor avformat.h cleanup:
 229     a9bf9d8 deprecate av_guess_image2_codec
 230     c3675df rename avf_sdp_create->av_sdp_create
 231
 232 2011-04-03 - lavf 52.105.0 - avio.h
 233   Large-scale renaming/deprecating of AVIOContext-related functions:
 234     724f6a0 deprecate url_fdopen
 235     403ee83 deprecate url_open_dyn_packet_buf
 236     6dc7d80 rename url_close_dyn_buf       -> avio_close_dyn_buf
 237     b92c545 rename url_open_dyn_buf        -> avio_open_dyn_buf
 238     8978fed introduce an AVIOContext.seekable field as a replacement for
 239             AVIOContext.is_streamed and url_is_streamed()
 240     b64030f deprecate get_checksum()
 241     4c4427a deprecate init_checksum()
 242     4ec153b deprecate udp_set_remote_url/get_local_port
 243     933e90a deprecate av_url_read_fseek/fpause
 244     8d9769a deprecate url_fileno
 245     b7f2fdd rename put_flush_packet -> avio_flush
 246     35f1023 deprecate url_close_buf
 247     83fddae deprecate url_open_buf
 248     d9d86e0 rename url_fprintf -> avio_printf
 249     59f65d9 deprecate url_setbufsize
 250     3e68b3b deprecate url_ferror
 251     66e5b1d deprecate url_feof
 252     e8bb2e2 deprecate url_fget_max_packet_size
 253     76aa876 rename url_fsize -> avio_size
 254     e519753 deprecate url_fgetc
 255     655e45e deprecate url_fgets
 256     a2704c9 rename url_ftell -> avio_tell
 257     e16ead0 deprecate get_strz() in favor of avio_get_str
 258     0300db8,2af07d3 rename url_fskip -> avio_skip
 259     6b4aa5d rename url_fseek -> avio_seek
 260     61840b4 deprecate put_tag
 261     22a3212 rename url_fopen/fclose -> avio_open/close.
 262     0ac8e2b deprecate put_nbyte
 263     77eb550 rename put_byte          -> avio_w8
 264                    put_[b/l]e<type>  -> avio_w[b/l]<type>
 265                    put_buffer        -> avio_write
 266     b7effd4 rename get_byte          -> avio_r8,
 267                    get_[b/l]e<type>  -> avio_r[b/l]<type>
 268                    get_buffer        -> avio_read
 269     b3db9ce deprecate get_partial_buffer
 270     8d9ac96 rename av_alloc_put_byte -> avio_alloc_context
 271
 272 2011-03-25 - 34b47d7 - lavc 52.115.0 - AVCodecContext.audio_service_type
 273   Add audio_service_type field to AVCodecContext.
 274
 275 2011-03-17 - e309fdc - lavu 50.40.0 - pixfmt.h
 276   Add PIX_FMT_BGR48LE and PIX_FMT_BGR48BE pixel formats
 277
 278 2011-03-02 - 863c471 - lavf  52.103.0 - av_pkt_dump2, av_pkt_dump_log2
 279   Add new functions av_pkt_dump2, av_pkt_dump_log2 that uses the
 280   source stream timebase for outputting timestamps. Deprecate
 281   av_pkt_dump and av_pkt_dump_log.
 282
 283 2011-02-20 - e731b8d - lavf  52.102.0 - avio.h
 284   * e731b8d - rename init_put_byte() to ffio_init_context(), deprecating the
 285               original, and move it to a private header so it is no longer
 286               part of our public API. Instead, use av_alloc_put_byte().
 287   * ae628ec - rename ByteIOContext to AVIOContext.
 288
 289 2011-02-16 - 09d171b - lavf  52.101.0 - avformat.h
 290                        lavu  52.39.0  - parseutils.h
 291   * 610219a - Add av_ prefix to dump_format().
 292   * f6c7375 - Replace parse_date() in lavf with av_parse_time() in lavu.
 293   * ab0287f - Move find_info_tag from lavf to lavu and add av_prefix to it.
 294
 295 2011-02-15 - lavu 52.38.0 - merge libavcore
 296   libavcore is merged back completely into libavutil
 297
 298 2011-02-10 - 55bad0c - lavc 52.113.0 - vbv_delay
 299   Add vbv_delay field to AVCodecContext
 300
 301 2011-02-14 - 24a83bd - lavf 52.100.0 - AV_DISPOSITION_CLEAN_EFFECTS
 302   Add AV_DISPOSITION_CLEAN_EFFECTS disposition flag.
 303
 304 2011-02-14 - 910b5b8 - lavfi 1.76.0 - AVFilterLink sample_aspect_ratio
 305   Add sample_aspect_ratio field to AVFilterLink.
 306
 307 2011-02-10 - 12c14cd - lavf 52.99.0 - AVStream.disposition
 308   Add AV_DISPOSITION_HEARING_IMPAIRED and AV_DISPOSITION_VISUAL_IMPAIRED.
 309
 310 2011-02-09 - 5592734 - lavc 52.112.0 - avcodec_thread_init()
 311   Deprecate avcodec_thread_init()/avcodec_thread_free() use; instead
 312   set thread_count before calling avcodec_open.
 313
 314 2011-02-09 - 778b08a - lavc 52.111.0 - threading API
 315   Add CODEC_CAP_FRAME_THREADS with new restrictions on get_buffer()/
 316   release_buffer()/draw_horiz_band() callbacks for appropriate codecs.
 317   Add thread_type and active_thread_type fields to AVCodecContext.
 318
 319 2011-02-08 - 3940caa - lavf 52.98.0 - av_probe_input_buffer
 320   Add av_probe_input_buffer() to avformat.h for probing format from a
 321   ByteIOContext.
 322
 323 2011-02-06 - fe174fc - lavf 52.97.0 - avio.h
 324   Add flag for non-blocking protocols: URL_FLAG_NONBLOCK
 325
 326 2011-02-04 - f124b08 - lavf 52.96.0 - avformat_free_context()
 327   Add avformat_free_context() in avformat.h.
 328
 329 2011-02-03 - f5b82f4 - lavc 52.109.0 - add CODEC_ID_PRORES
 330   Add CODEC_ID_PRORES to avcodec.h.
 331
 332 2011-02-03 - fe9a3fb - lavc 52.109.0 - H.264 profile defines
 333   Add defines for H.264 * Constrained Baseline and Intra profiles
 334
 335 2011-02-02 - lavf 52.95.0
 336   * 50196a9 - add a new installed header version.h.
 337   * 4efd5cf, dccbd97, 93b78d1 - add several variants of public
 338     avio_{put,get}_str* functions.  Deprecate corresponding semi-public
 339     {put,get}_str*.
 340
 341 2011-02-02 - dfd2a00 - lavu 50.37.0 - log.h
 342   Make av_dlog public.
 343
 344 2011-01-31 - 7b3ea55 - lavfi 1.76.0 - vsrc_buffer
 345   Add sample_aspect_ratio fields to vsrc_buffer arguments
 346
 347 2011-01-31 - 910b5b8 - lavfi 1.75.0 - AVFilterLink sample_aspect_ratio
 348   Add sample_aspect_ratio field to AVFilterLink.
 349
 350 2011-01-15 - r26374 - lavfi 1.74.0 - AVFilterBufferRefAudioProps
 351   Rename AVFilterBufferRefAudioProps.samples_nb to nb_samples.
 352
 353 2011-01-14 - r26330 - lavf 52.93.0 - av_metadata_copy()
 354   Add av_metadata_copy() in avformat.h.
 355
 356 2011-01-07 - r26262 - lavc 52.107.0 - deprecate reordered_opaque
 357   Deprecate reordered_opaque in favor of pkt_pts/dts.
 358
 359 2011-01-07 - r26261 - lavc 52.106.0 - pkt_dts
 360   Add pkt_dts to AVFrame, this will in the future allow multithreading decoders
 361   to not mess up dts.
 362
 363 2011-01-07 - r26260 - lavc 52.105.0 - pkt_pts
 364   Add pkt_pts to AVFrame.
 365
 366 2011-01-07 - r26259 - lavc 52.104.0 - av_get_profile_name()
 367   Add av_get_profile_name to libavcodec/avcodec.h.
 368
 369 2010-12-27 - r26108 - lavfi 1.71.0 - AV_PERM_NEG_LINESIZES
 370   Add AV_PERM_NEG_LINESIZES in avfilter.h.
 371
 372 2010-12-27 - r26104 - lavf 52.91.0 - av_find_best_stream()
 373   Add av_find_best_stream to libavformat/avformat.h.
 374
 375 2010-12-27 - r26103 - lavf 52.90.0
 376   Add AVFMT_NOSTREAMS flag for formats with no streams,
 377   like e.g. text metadata.
 378
 379 2010-12-22 - r26073 - lavu 50.36.0 - file.h
 380   Add functions av_file_map() and av_file_unmap() in file.h.
 381
 382 2010-12-19 - r26056 - lavu 50.35.0 - error.h
 383   Add "not found" error codes:
 384   AVERROR_DEMUXER_NOT_FOUND
 385   AVERROR_MUXER_NOT_FOUND
 386   AVERROR_DECODER_NOT_FOUND
 387   AVERROR_ENCODER_NOT_FOUND
 388   AVERROR_PROTOCOL_NOT_FOUND
 389   AVERROR_FILTER_NOT_FOUND
 390   AVERROR_BSF_NOT_FOUND
 391   AVERROR_STREAM_NOT_FOUND
 392
 393 2010-12-09 - r25923 - lavcore 0.16.0 - avcore.h
 394   Move AV_NOPTS_VALUE, AV_TIME_BASE, AV_TIME_BASE_Q symbols from
 395   avcodec.h to avcore.h.
 396
 397 2010-12-04 - r25886 - lavc 52.98.0 - CODEC_CAP_NEG_LINESIZES
 398   Add CODEC_CAP_NEG_LINESIZES codec capability flag in avcodec.h.
 399
 400 2010-12-04 - r25879 - lavu 50.34.0 - av_get_pix_fmt_string()
 401   Deprecate avcodec_pix_fmt_string() in favor of
 402   pixdesc.h/av_get_pix_fmt_string().
 403
 404 2010-12-04 - r25878 - lavcore 0.15.0 - av_image_alloc()
 405   Add av_image_alloc() to libavcore/imgutils.h.
 406
 407 2010-12-02 - r25862 - lavfi 1.67.0 - avfilter_graph_create_filter()
 408   Add function avfilter_graph_create_filter() in avfiltergraph.h.
 409
 410 2010-11-25 - r25826 - lavfi 1.65.0 - avfilter_get_video_buffer_ref_from_arrays()
 411   Add function avfilter_get_video_buffer_ref_from_arrays() in
 412   avfilter.h.
 413
 414 2010-11-21 - r25787 - lavcore 0.14.0 - audioconvert.h
 415   Add a public audio channel API in audioconvert.h, and deprecate the
 416   corresponding functions in libavcodec:
 417   avcodec_get_channel_name()
 418   avcodec_get_channel_layout()
 419   avcodec_get_channel_layout_string()
 420   avcodec_channel_layout_num_channels()
 421   and the CH_* macros defined in libavcodec/avcodec.h.
 422
 423 2010-11-21 - r25777 - lavf 52.85.0 - avformat.h
 424   Add av_append_packet().
 425
 426 2010-11-21 - r25776 - lavc 52.97.0 - avcodec.h
 427   Add av_grow_packet().
 428
 429 2010-11-17 - r25761 - lavcore 0.13.0 - parseutils.h
 430   Add av_parse_color() declared in libavcore/parseutils.h.
 431
 432 2010-11-13 - r25745 - lavc 52.95.0 - AVCodecContext
 433   Add AVCodecContext.subtitle_header and AVCodecContext.subtitle_header_size
 434   fields.
 435
 436 2010-11-13 - r25740 - lavfi 1.62.0 - avfiltergraph.h
 437   Make avfiltergraph.h public.
 438
 439 2010-11-13 - r25737 - lavfi 1.61.0 - avfiltergraph.h
 440   Remove declarations from avfiltergraph.h for the functions:
 441   avfilter_graph_check_validity()
 442   avfilter_graph_config_links()
 443   avfilter_graph_config_formats()
 444   which are now internal.
 445   Use avfilter_graph_config() instead.
 446
 447 2010-11-08 - r25708 - lavu 50.33.0 - eval.h
 448   Deprecate functions:
 449   av_parse_and_eval_expr(),
 450   av_parse_expr(),
 451   av_eval_expr(),
 452   av_free_expr(),
 453   in favor of the functions:
 454   av_expr_parse_and_eval(),
 455   av_expr_parse(),
 456   av_expr_eval(),
 457   av_expr_free().
 458
 459 2010-11-08 - r25707 - lavfi 1.59.0 - avfilter_free()
 460   Rename avfilter_destroy() to avfilter_free().
 461   This change breaks libavfilter API/ABI.
 462
 463 2010-11-07 - r25705 - lavfi 1.58.0 - avfiltergraph.h
 464   Remove graphparser.h header, move AVFilterInOut and
 465   avfilter_graph_parse() declarations to libavfilter/avfiltergraph.h.
 466
 467 2010-11-07 - r25700 - lavfi 1.57.0 - AVFilterInOut
 468   Rename field AVFilterInOut.filter to AVFilterInOut.filter_ctx.
 469   This change breaks libavfilter API.
 470
 471 2010-11-04 - r25674 - lavfi 1.56.0 - avfilter_graph_free()
 472   Rename avfilter_graph_destroy() to avfilter_graph_free().
 473   This change breaks libavfilter API/ABI.
 474
 475 2010-11-04 - r25673 - lavfi 1.55.0 - avfilter_graph_alloc()
 476   Add avfilter_graph_alloc() to libavfilter/avfiltergraph.h.
 477
 478 2010-11-02 - r25654 - lavcore 0.12.0 - av_get_bits_per_sample_fmt()
 479   Add av_get_bits_per_sample_fmt() to libavcore/samplefmt.h and
 480   deprecate av_get_bits_per_sample_format().
 481
 482 2010-11-02 - r25653 - lavcore 0.11.0 - samplefmt.h
 483   Add sample format functions in libavcore/samplefmt.h:
 484   av_get_sample_fmt_name(),
 485   av_get_sample_fmt(),
 486   av_get_sample_fmt_string(),
 487   and deprecate the corresponding libavcodec/audioconvert.h functions:
 488   avcodec_get_sample_fmt_name(),
 489   avcodec_get_sample_fmt(),
 490   avcodec_sample_fmt_string().
 491
 492 2010-11-02 - r25652 - lavcore 0.10.0 - samplefmt.h
 493   Define enum AVSampleFormat in libavcore/samplefmt.h, deprecate enum
 494   SampleFormat.
 495
 496 2010-10-16 - r25502 - lavfi 1.52.0 - avfilter_graph_config()
 497   Add the function avfilter_graph_config() in avfiltergraph.h.
 498
 499 2010-10-15 - r25493 - lavf 52.83.0 - metadata API
 500   Change demuxers to export metadata in generic format and
 501   muxers to accept generic format. Deprecate the public
 502   conversion API.
 503
 504 2010-10-10 - r25441 - lavfi 1.49.0 - AVFilterLink.time_base
 505   Add time_base field to AVFilterLink.
 506
 507 2010-09-27 - r25236 - lavu 50.31.0 - av_set_options_string()
 508   Move av_set_options_string() from libavfilter/parseutils.h to
 509   libavutil/opt.h.
 510
 511 2010-09-27 - r25227 - lavfi 1.47.0 - AVFilterLink
 512   Make the AVFilterLink fields srcpad and dstpad store the pointers to
 513   the source and destination pads, rather than their indexes.
 514
 515 2010-09-27 - r25225 - lavu 50.30.0 - av_get_token()
 516   Move av_get_token() from libavfilter/parseutils.h to
 517   libavutil/avstring.h.
 518
 519 2010-09-26 - r32368 - lsws 0.12.0 - swscale.h
 520   Add the functions sws_alloc_context() and sws_init_context().
 521
 522 2010-09-26 - r25210 - lavu 50.29.0 - opt.h
 523   Move libavcodec/opt.h to libavutil/opt.h.
 524
 525 2010-09-24 - r25174 - lavu 50.28.0 - av_log_set_flags()
 526   Default of av_log() changed due to many problems to the old no repeat
 527   detection. Read the docs of AV_LOG_SKIP_REPEATED in log.h before
 528   enabling it for your app!.
 529
 530 2010-09-24 - r25167 - lavc 52.90.0 - av_opt_show2()
 531   Deprecate av_opt_show() in favor or av_opt_show2().
 532
 533 2010-09-14 - r25120 - lavu 50.27.0 - av_popcount()
 534   Add av_popcount() to libavutil/common.h.
 535
 536 2010-09-08 - r25076 - lavu 50.26.0 - av_get_cpu_flags()
 537   Add av_get_cpu_flags().
 538
 539 2010-09-07 - r25067 - lavcore 0.9.0 - av_image_copy()
 540   Add av_image_copy().
 541
 542 2010-09-07 - r25064 - lavcore 0.8.0 - av_image_copy_plane()
 543   Add av_image_copy_plane().
 544
 545 2010-09-07 - r25057 - lavcore 0.7.0 - imgutils.h
 546   Adopt hierarchical scheme for the imgutils.h function names,
 547   deprecate the old names.
 548
 549 2010-09-04 - r25040 - lavu 50.25.0 - AV_CPU_FLAG_*
 550   Deprecate the FF_MM_* flags defined in libavcodec/avcodec.h in favor
 551   of the AV_CPU_FLAG_* flags defined in libavutil/cpu.h.
 552
 553 2010-08-26 - r24936 - lavc 52.87.0 - avcodec_get_channel_layout()
 554   Add avcodec_get_channel_layout() in audioconvert.h.
 555
 556 2010-08-20 - r24851 - lavcore 0.6.0 - av_fill_image_max_pixsteps()
 557   Rename av_fill_image_max_pixstep() to av_fill_image_max_pixsteps().
 558
 559 2010-08-18 - r24827 - lavcore 0.5.0 - av_fill_image_max_pixstep()
 560   Add av_fill_image_max_pixstep() in imgutils.h.
 561
 562 2010-08-17 - r24814 - lavu 50.24.0 - AV_NE()
 563   Add the AV_NE macro.
 564
 565 2010-08-17 - r24811 - lavfi 1.36.0 - audio framework
 566   Implement AVFilterBufferRefAudioProps struct for audio properties,
 567   get_audio_buffer(), filter_samples() functions and related changes.
 568
 569 2010-08-12 - r24787 - lavcore 0.4.0 - av_get_image_linesize()
 570   Add av_get_image_linesize() in imgutils.h.
 571
 572 2010-08-11 - r24773 - lavfi 1.34.0 - AVFilterBufferRef
 573   Resize data and linesize arrays in AVFilterBufferRef to 8.
 574
 575   This change breaks libavfilter API/ABI.
 576
 577 2010-08-11 - r24768 - lavc 52.85.0 - av_picture_data_copy()
 578   Add av_picture_data_copy in avcodec.h.
 579
 580 2010-08-11 - r24765 - lavfi 1.33.0 - avfilter_open()
 581   Change avfilter_open() signature:
 582   AVFilterContext *avfilter_open(AVFilter *filter, const char *inst_name) ->
 583   int avfilter_open(AVFilterContext **filter_ctx, AVFilter *filter, const char *inst_name);
 584
 585   This change breaks libavfilter API/ABI.
 586
 587 2010-08-11 - r24763 - lavfi 1.32.0 - AVFilterBufferRef
 588   Add a type field to AVFilterBufferRef, and move video specific
 589   properties to AVFilterBufferRefVideoProps.
 590
 591   This change breaks libavfilter API/ABI.
 592
 593 2010-08-07 - r24732 - lavfi 1.31.0 - AVFilterLink
 594   Rename AVFilterLink fields:
 595   AVFilterLink.srcpic    ->  AVFilterLink.src_buf
 596   AVFilterLink.cur_pic   ->  AVFilterLink.cur_buf
 597   AVFilterLink.outpic    ->  AVFilterLink.out_buf
 598
 599 2010-08-07 - r24731 - lavfi 1.30.0
 600   Rename functions and fields:
 601   avfilter_(un)ref_pic       -> avfilter_(un)ref_buffer
 602   avfilter_copy_picref_props -> avfilter_copy_buffer_ref_props
 603   AVFilterBufferRef.pic      -> AVFilterBufferRef.buffer
 604
 605 2010-08-07 - r24730 - lavfi 1.29.0 - AVFilterBufferRef
 606   Rename AVFilterPicRef to AVFilterBufferRef.
 607
 608 2010-08-07 - r24728 - lavfi 1.28.0 - AVFilterBuffer
 609   Move format field from AVFilterBuffer to AVFilterPicRef.
 610
 611 2010-08-06 - r24709 - lavcore 0.3.0 - av_check_image_size()
 612   Deprecate avcodec_check_dimensions() in favor of the function
 613   av_check_image_size() defined in libavcore/imgutils.h.
 614
 615 2010-07-30 - r24592 - lavfi 1.27.0 - AVFilterBuffer
 616   Increase size of the arrays AVFilterBuffer.data and
 617   AVFilterBuffer.linesize from 4 to 8.
 618
 619   This change breaks libavfilter ABI.
 620
 621 2010-07-29 - r24583 - lavcore 0.2.0 - imgutils.h
 622   Add functions av_fill_image_linesizes() and
 623   av_fill_image_pointers(), declared in libavcore/imgutils.h.
 624
 625 2010-07-27 - r24518 - lavcore 0.1.0 - parseutils.h
 626   Deprecate av_parse_video_frame_size() and av_parse_video_frame_rate()
 627   defined in libavcodec in favor of the newly added functions
 628   av_parse_video_size() and av_parse_video_rate() declared in
 629   libavcore/parseutils.h.
 630
 631 2010-07-23 - r24439 - lavu 50.23.0 - mathematics.h
 632   Add the M_PHI constant definition.
 633
 634 2010-07-22 - r24424 - lavfi 1.26.0 - media format generalization
 635   Add a type field to AVFilterLink.
 636
 637   Change the field types:
 638   enum PixelFormat format   -> int format   in AVFilterBuffer
 639   enum PixelFormat *formats -> int *formats in AVFilterFormats
 640   enum PixelFormat *format  -> int format   in AVFilterLink
 641
 642   Change the function signatures:
 643   AVFilterFormats *avfilter_make_format_list(const enum PixelFormat *pix_fmts); ->
 644   AVFilterFormats *avfilter_make_format_list(const int *fmts);
 645
 646   int avfilter_add_colorspace(AVFilterFormats **avff, enum PixelFormat pix_fmt); ->
 647   int avfilter_add_format    (AVFilterFormats **avff, int fmt);
 648
 649   AVFilterFormats *avfilter_all_colorspaces(void); ->
 650   AVFilterFormats *avfilter_all_formats    (enum AVMediaType type);
 651
 652   This change breaks libavfilter API/ABI.
 653
 654 2010-07-21 - r24393 - lavcore 0.0.0
 655   Add libavcore.
 656
 657 2010-07-17 - r24291 - lavfi 1.25.0 - AVFilterBuffer
 658   Remove w and h fields from AVFilterBuffer.
 659
 660 2010-07-17 - r24284 - lavfi 1.24.0 - AVFilterBuffer
 661   Rename AVFilterPic to AVFilterBuffer.
 662
 663 2010-07-17 - r24278 - lavf 52.74.0 - url_fskip()
 664   Make url_fskip() return an int error code instead of void.
 665
 666 2010-07-11 - r24199 - lavc 52.83.0
 667   Add AVCodecContext.lpc_type and AVCodecContext.lpc_passes fields.
 668   Add AVLPCType enum.
 669   Deprecate AVCodecContext.use_lpc.
 670
 671 2010-07-11 - r24185 - lavc 52.82.0 - avsubtitle_free()
 672   Add a function for free the contents of a AVSubtitle generated by
 673   avcodec_decode_subtitle.
 674
 675 2010-07-11 - r24174 - lavu 50.22.0 - bswap.h and intreadwrite.h
 676   Make the bswap.h and intreadwrite.h API public.
 677
 678 2010-07-08 - r24101 - lavu 50.21.0 - pixdesc.h
 679   Rename read/write_line() to av_read/write_image_line().
 680
 681 2010-07-07 - r24091 - lavfi 1.21.0 - avfilter_copy_picref_props()
 682   Add avfilter_copy_picref_props().
 683
 684 2010-07-03 - r24021 - lavc 52.79.0
 685   Add FF_COMPLIANCE_UNOFFICIAL and change all instances of
 686   FF_COMPLIANCE_INOFFICIAL to use FF_COMPLIANCE_UNOFFICIAL.
 687
 688 2010-07-02 - r23985 - lavu 50.20.0 - lfg.h
 689   Export av_lfg_init(), av_lfg_get(), av_mlfg_get(), and av_bmg_get() through
 690   lfg.h.
 691
 692 2010-06-28 - r23835 - lavfi 1.20.1 - av_parse_color()
 693   Extend av_parse_color() syntax, make it accept an alpha value specifier and
 694   set the alpha value to 255 by default.
 695
 696 2010-06-22 - r23706 - lavf 52.71.0 - URLProtocol.priv_data_size, priv_data_class
 697   Add priv_data_size and priv_data_class to URLProtocol.
 698
 699 2010-06-22 - r23704 - lavf 52.70.0 - url_alloc(), url_connect()
 700   Add url_alloc() and url_connect().
 701
 702 2010-06-22 - r23702 - lavf 52.69.0 - av_register_protocol2()
 703   Add av_register_protocol2(), deprecating av_register_protocol().
 704
 705 2010-06-09 - r23551 - lavu 50.19.0 - av_compare_mod()
 706   Add av_compare_mod() to libavutil/mathematics.h.
 707
 708 2010-06-05 - r23485 - lavu 50.18.0 - eval API
 709   Make the eval API public.
 710
 711 2010-06-04 - r23461 - lavu 50.17.0 - AV_BASE64_SIZE
 712   Add AV_BASE64_SIZE() macro.
 713
 714 2010-06-02 - r23421 - lavc 52.73.0 - av_get_codec_tag_string()
 715   Add av_get_codec_tag_string().
 716
 717 2010-06-01 - r31301 - lsws 0.11.0 - convertPalette API
 718   Add sws_convertPalette8ToPacked32() and sws_convertPalette8ToPacked24().
 719
 720 2010-05-26 - r23334 - lavc 52.72.0 - CODEC_CAP_EXPERIMENTAL
 721   Add CODEC_CAP_EXPERIMENTAL flag.
 722   NOTE: this was backported to 0.6
 723
 724 2010-05-23 - r23255 - lavu 50.16.0 - av_get_random_seed()
 725   Add av_get_random_seed().
 726
 727 2010-05-18 - r23161 - lavf 52.63.0 - AVFMT_FLAG_RTP_HINT
 728   Add AVFMT_FLAG_RTP_HINT as possible value for AVFormatContext.flags.
 729   NOTE: this was backported to 0.6
 730
 731 2010-05-09 - r23066 - lavfi 1.20.0 - AVFilterPicRef
 732   Add interlaced and top_field_first fields to AVFilterPicRef.
 733
 734 ------------------------------8<-------------------------------------
 735                    0.6 branch was cut here
 736 ----------------------------->8--------------------------------------
 737
 738 2010-05-01 - r23002 - lavf 52.62.0 - probe function
 739   Add av_probe_input_format2 to API, it allows ignoring probe
 740   results below given score and returns the actual probe score.
 741
 742 2010-04-01 - r22806 - lavf 52.61.0 - metadata API
 743   Add a flag for av_metadata_set2() to disable overwriting of
 744   existing tags.
 745
 746 2010-04-01 - r22753 - lavc 52.66.0
 747   Add avcodec_get_edge_width().
 748
 749 2010-03-31 - r22750 - lavc 52.65.0
 750   Add avcodec_copy_context().
 751
 752 2010-03-31 - r22748 - lavf 52.60.0 - av_match_ext()
 753   Make av_match_ext() public.
 754
 755 2010-03-31 - r22736 - lavu 50.14.0 - AVMediaType
 756   Move AVMediaType enum from libavcodec to libavutil.
 757
 758 2010-03-31 - r22735 - lavc 52.64.0 - AVMediaType
 759   Define AVMediaType enum, and use it instead of enum CodecType, which
 760   is deprecated and will be dropped at the next major bump.
 761
 762 2010-03-25 - r22684 - lavu 50.13.0 - av_strerror()
 763   Implement av_strerror().
 764
 765 2010-03-23 - r22649 - lavc 52.60.0 - av_dct_init()
 766   Support DCT-I and DST-I.
 767
 768 2010-03-15 - r22540 - lavf 52.56.0 - AVFormatContext.start_time_realtime
 769   Add AVFormatContext.start_time_realtime field.
 770
 771 2010-03-13 - r22506 - lavfi 1.18.0 - AVFilterPicRef.pos
 772   Add AVFilterPicRef.pos field.
 773
 774 2010-03-13 - r22501 - lavu 50.12.0 - error.h
 775   Move error code definitions from libavcodec/avcodec.h to
 776   the new public header libavutil/error.h.
 777
 778 2010-03-07 - r22291 - lavc 52.56.0 - avfft.h
 779   Add public FFT interface.
 780
 781 2010-03-06 - r22251 - lavu 50.11.0 - av_stristr()
 782   Add av_stristr().
 783
 784 2010-03-03 - r22174 - lavu 50.10.0 - av_tree_enumerate()
 785   Add av_tree_enumerate().
 786
 787 2010-02-07 - r21673 - lavu 50.9.0 - av_compare_ts()
 788   Add av_compare_ts().
 789
 790 2010-02-05 - r30513 - lsws 0.10.0 - sws_getCoefficients()
 791   Add sws_getCoefficients().
 792
 793 2010-02-01 - r21587 - lavf 52.50.0 - metadata API
 794   Add a list of generic tag names, change 'author' -> 'artist',
 795   'year' -> 'date'.
 796
 797 2010-01-30 - r21545 - lavu 50.8.0 - av_get_pix_fmt()
 798   Add av_get_pix_fmt().
 799
 800 2010-01-21 - r30381 - lsws 0.9.0 - sws_scale()
 801   Change constness attributes of sws_scale() parameters.
 802
 803 2010-01-10 - r21121 - lavfi 1.15.0 - avfilter_graph_config_links()
 804   Add a log_ctx parameter to avfilter_graph_config_links().
 805
 806 2010-01-07 - r30236 - lsws 0.8.0 - sws_isSupported{In,Out}put()
 807   Add sws_isSupportedInput() and sws_isSupportedOutput() functions.
 808
 809 2010-01-06 - r21035 - lavfi 1.14.0 - avfilter_add_colorspace()
 810   Change the avfilter_add_colorspace() signature, make it accept an
 811   (AVFilterFormats **) rather than an (AVFilterFormats *) as before.
 812
 813 2010-01-03 - r21007 - lavfi 1.13.0 - avfilter_add_colorspace()
 814   Add avfilter_add_colorspace().
 815
 816 2010-01-02 - r20998 - lavf 52.46.0 - av_match_ext()
 817   Add av_match_ext(), it should be used in place of match_ext().
 818
 819 2010-01-01 - r20991 - lavf 52.45.0 - av_guess_format()
 820   Add av_guess_format(), it should be used in place of guess_format().
 821
 822 2009-12-13 - r20834 - lavf 52.43.0 - metadata API
 823   Add av_metadata_set2(), AV_METADATA_DONT_STRDUP_KEY and
 824   AV_METADATA_DONT_STRDUP_VAL.
 825
 826 2009-12-13 - r20829 - lavu 50.7.0 - avstring.h API
 827   Add av_d2str().
 828
 829 2009-12-13 - r20826 - lavc 52.42.0 - AVStream
 830   Add avg_frame_rate.
 831
 832 2009-12-12 - r20808 - lavu 50.6.0 - av_bmg_next()
 833   Introduce the av_bmg_next() function.
 834
 835 2009-12-05 - r20734 - lavfi 1.12.0 - avfilter_draw_slice()
 836   Add a slice_dir parameter to avfilter_draw_slice().
 837
 838 2009-11-26 - r20611 - lavfi 1.11.0 - AVFilter
 839   Remove the next field from AVFilter, this is not anymore required.
 840
 841 2009-11-25 - r20607 - lavfi 1.10.0 - avfilter_next()
 842   Introduce the avfilter_next() function.
 843
 844 2009-11-25 - r20605 - lavfi 1.9.0 - avfilter_register()
 845   Change the signature of avfilter_register() to make it return an
 846   int. This is required since now the registration operation may fail.
 847
 848 2009-11-25 - r20603 - lavu 50.5.0 - pixdesc.h API
 849   Make the pixdesc.h API public.
 850
 851 2009-10-27 - r20385 - lavfi 1.5.0 - AVFilter.next
 852   Add a next field to AVFilter, this is used for simplifying the
 853   registration and management of the registered filters.
 854
 855 2009-10-23 - r20356 - lavfi 1.4.1 - AVFilter.description
 856   Add a description field to AVFilter.
 857
 858 2009-10-19 - r20302 - lavfi 1.3.0 - avfilter_make_format_list()
 859   Change the interface of avfilter_make_format_list() from
 860   avfilter_make_format_list(int n, ...) to
 861   avfilter_make_format_list(enum PixelFormat *pix_fmts).
 862
 863 2009-10-18 - r20272 - lavfi 1.0.0 - avfilter_get_video_buffer()
 864   Make avfilter_get_video_buffer() recursive and add the w and h
 865   parameters to it.
 866
 867 2009-10-07 - r20189 - lavfi 0.5.1 - AVFilterPic
 868   Add w and h fields to AVFilterPic.
 869
 870 2009-06-22 - r19250 - lavf 52.34.1 - AVFormatContext.packet_size
 871   This is now an unsigned int instead of a signed int.
 872
 873 2009-06-19 - r19222 - lavc 52.32.0 - AVSubtitle.pts
 874   Add a pts field to AVSubtitle which gives the subtitle packet pts
 875   in AV_TIME_BASE. Some subtitle de-/encoders (e.g. XSUB) will
 876   not work right without this.
 877
 878 2009-06-03 - r19078 - lavc 52.30.2 - AV_PKT_FLAG_KEY
 879   PKT_FLAG_KEY has been deprecated and will be dropped at the next
 880   major version. Use AV_PKT_FLAG_KEY instead.
 881
 882 2009-06-01 - r19025 - lavc 52.30.0 - av_lockmgr_register()
 883   av_lockmgr_register() can be used to register a callback function
 884   that lavc (and in the future, libraries that depend on lavc) can use
 885   to implement mutexes. The application should provide a callback function
 886   that implements the AV_LOCK_* operations described in avcodec.h.
 887   When the lock manager is registered, FFmpeg is guaranteed to behave
 888   correctly in a multi-threaded application.
 889
 890 2009-04-30 - r18719 - lavc 52.28.0 - av_free_packet()
 891   av_free_packet() is no longer an inline function. It is now exported.
 892
 893 2009-04-11 - r18431 - lavc 52.25.0 - deprecate av_destruct_packet_nofree()
 894   Please use NULL instead. This has been supported since r16506
 895   (lavf > 52.23.1, lavc > 52.10.0).
 896
 897 2009-04-07 - r18351 - lavc 52.23.0 - avcodec_decode_video/audio/subtitle
 898   The old decoding functions are deprecated, all new code should use the
 899   new functions avcodec_decode_video2(), avcodec_decode_audio3() and
 900   avcodec_decode_subtitle2(). These new functions take an AVPacket *pkt
 901   argument instead of a const uint8_t *buf / int buf_size pair.
 902
 903 2009-04-03 - r18321 - lavu 50.3.0 - av_fifo_space()
 904   Introduce the av_fifo_space() function.
 905
 906 2009-04-02 - r18317 - lavc 52.23.0 - AVPacket
 907   Move AVPacket declaration from libavformat/avformat.h to
 908   libavcodec/avcodec.h.
 909
 910 2009-03-22 - r18163 - lavu 50.2.0 - RGB32 pixel formats
 911   Convert the pixel formats PIX_FMT_ARGB, PIX_FMT_RGBA, PIX_FMT_ABGR,
 912   PIX_FMT_BGRA, which were defined as macros, into enum PixelFormat values.
 913   Conversely PIX_FMT_RGB32, PIX_FMT_RGB32_1, PIX_FMT_BGR32 and
 914   PIX_FMT_BGR32_1 are now macros.
 915   avcodec_get_pix_fmt() now recognizes the "rgb32" and "bgr32" aliases.
 916   Re-sort the enum PixelFormat list accordingly.
 917   This change breaks API/ABI backward compatibility.
 918
 919 2009-03-22 - r18133 - lavu 50.1.0 - PIX_FMT_RGB5X5 endian variants
 920   Add the enum PixelFormat values:
 921   PIX_FMT_RGB565BE, PIX_FMT_RGB565LE, PIX_FMT_RGB555BE, PIX_FMT_RGB555LE,
 922   PIX_FMT_BGR565BE, PIX_FMT_BGR565LE, PIX_FMT_BGR555BE, PIX_FMT_BGR555LE.
 923
 924 2009-03-21 - r18116 - lavu 50.0.0  - av_random*
 925   The Mersenne Twister PRNG implemented through the av_random* functions
 926   was removed. Use the lagged Fibonacci PRNG through the av_lfg* functions
 927   instead.
 928
 929 2009-03-08 - r17869 - lavu 50.0.0  - AVFifoBuffer
 930   av_fifo_init, av_fifo_read, av_fifo_write and av_fifo_realloc were dropped
 931   and replaced by av_fifo_alloc, av_fifo_generic_read, av_fifo_generic_write
 932   and av_fifo_realloc2.
 933   In addition, the order of the function arguments of av_fifo_generic_read
 934   was changed to match av_fifo_generic_write.
 935   The AVFifoBuffer/struct AVFifoBuffer may only be used in an opaque way by
 936   applications, they may not use sizeof() or directly access members.
 937
 938 2009-03-01 - r17682 - lavf 52.31.0 - Generic metadata API
 939   Introduce a new metadata API (see av_metadata_get() and friends).
 940   The old API is now deprecated and should not be used anymore. This especially
 941   includes the following structure fields:
 942     - AVFormatContext.title
 943     - AVFormatContext.author
 944     - AVFormatContext.copyright
 945     - AVFormatContext.comment
 946     - AVFormatContext.album
 947     - AVFormatContext.year
 948     - AVFormatContext.track
 949     - AVFormatContext.genre
 950     - AVStream.language
 951     - AVStream.filename
 952     - AVProgram.provider_name
 953     - AVProgram.name
 954     - AVChapter.title