A class for logging and AVOptions.

Set by avformat_alloc_context(). Exports (de)muxer private options if they exist.

Definition at line 1269 of file avformat.h.

Referenced by av_bsf_alloc(), av_hwdevice_ctx_alloc(), and av_hwframe_ctx_alloc().

The input container format.

Demuxing only, set by avformat_open_input().

Definition at line 1276 of file avformat.h.

Referenced by assert_file_overwrite(), av_dump_format(), avformat_find_stream_info(), dump_stream_format(), dump_stream_group(), estimate_timings(), ff_img_read_header(), hls_read_packet(), ifile_open(), ist_use(), parse_playlist(), rawvideo_read_header(), read_thread(), show_format(), show_stream(), show_stream_group(), and ts_discontinuity_detect().

The output container format.

Muxing only, must be set by the caller before avformat_write_header().

Examples

mux.c, remux.c, and transcode.c.

Definition at line 1283 of file avformat.h.

Referenced by add_stream(), av_dump_format(), create_rtp_muxer(), create_streams(), dash_check_bitstream(), dash_init(), dump_stream_format(), dump_stream_group(), ff_rtp_chain_mux_open(), ff_rtp_get_payload_type(), hds_write_header(), hls_mux_init(), hls_start(), hls_write_packet(), init_fps(), ism_write_header(), log_slave(), main(), map_auto_audio(), map_auto_data(), map_auto_subtitle(), map_auto_video(), mpeg_mux_init(), mpegts_init(), mux_fixup_ts(), new_stream_video(), of_open(), open_output_file(), ost_add(), print_sdp(), print_streams(), rtp_mpegts_write_header(), seg_check_bitstream(), seg_write_packet(), segment_mux_init(), segment_start(), streamcopy_init(), and thread_set_name().

Format private data.

This is an AVOptions-enabled struct if and only if iformat/oformat.priv_class is not NULL.

• muxing: set by avformat_write_header()
• demuxing: set by avformat_open_input()

Definition at line 1292 of file avformat.h.

Referenced by add_display_matrix(), add_file(), add_video_stream(), alloc_and_insert_node(), android_camera_read_close(), android_camera_read_header(), android_camera_read_packet(), apng_write_header(), apng_write_packet(), apng_write_trailer(), at_write_header(), at_write_packet(), at_write_trailer(), audio_get_output_timestamp(), audio_read_close(), audio_read_header(), audio_read_packet(), audio_write_frame(), audio_write_header(), audio_write_packet(), audio_write_trailer(), av1_frame_split_close(), av1_frame_split_filter(), av1_frame_split_flush(), av1_frame_split_init(), av1_parser_close(), av1_parser_init(), av1_parser_parse(), av_bsf_alloc(), av_bsf_free(), av_bsf_list_finalize(), bsf_child_next(), camera_dev_disconnected(), camera_dev_error(), cbs_apv_derive_tile_info(), cbs_av1_close(), cbs_av1_flush(), cbs_av1_read_unit(), cbs_av1_write_obu(), cbs_h2645_replace_ps(), cbs_h2645_split_fragment(), cbs_h264_close(), cbs_h264_flush(), cbs_h265_close(), cbs_h265_flush(), cbs_h266_close(), cbs_h266_flush(), cbs_h266_read_nal_unit(), cbs_h266_replace_ph(), cbs_vp9_flush(), cdef_params(), cine_read_packet(), cine_read_seek(), close(), close_slaves(), color_config(), concat_parse_script(), concat_read_close(), concat_read_header(), concat_read_packet(), concat_seek(), convert_timestamp(), create_capture_session(), create_image_reader(), create_subcc_packet(), create_subcc_streams(), dec_ref_pic_marking(), decklink_input_callback::decklink_input_callback(), decklink_select_input(), decklink_setup_audio(), decklink_setup_video(), decklink_write_audio_packet(), decklink_write_data_packet(), decklink_write_subtitle_packet(), decklink_write_video_packet(), detect_stream_specific(), device_init(), device_open(), dfpwm_dec_frame(), dfpwm_dec_init(), dfpwm_enc_frame(), dfpwm_enc_init(), dshow_add_device(), dshow_cycle_devices(), dshow_cycle_formats(), dshow_cycle_pins(), dshow_list_device_options(), dshow_open_device(), dshow_read_header(), dshow_set_audio_buffer_size(), dshow_should_set_format(), dts2pts_close(), dts2pts_filter(), dts2pts_flush(), dts2pts_init(), dump_extradata(), dv_error_marker_filter(), dv_error_marker_init(), efi_read(), encode_nals(), extract_extradata_av1(), extract_extradata_close(), extract_extradata_filter(), extract_extradata_h2645(), extract_extradata_init(), extract_extradata_mpeg12(), extract_extradata_mpeg4(), extract_extradata_vc1(), failing_deinit(), fbdev_read_close(), fbdev_read_header(), fbdev_read_packet(), ff_alsa_close(), ff_alsa_open(), ff_alsa_xrun_recover(), ff_decklink_cleanup(), ff_decklink_init_device(), ff_decklink_list_formats(), ff_decklink_read_close(), ff_decklink_read_header(), ff_decklink_read_packet(), ff_decklink_set_configs(), ff_decklink_set_format(), ff_decklink_write_header(), ff_decklink_write_trailer(), ff_dshow_try_setup_crossbar_options(), ff_eia608_to_smpte436m_filter(), ff_eia608_to_smpte436m_init(), ff_frame_thread_free(), ff_img_read_header(), ff_img_read_packet(), ff_mov_cenc_av1_write_obus(), ff_oss_audio_open(), ff_rtp_get_payload_type(), ff_rtp_send_aac(), ff_rtp_send_amr(), ff_rtp_send_av1(), ff_rtp_send_data(), ff_rtp_send_h261(), ff_rtp_send_h263(), ff_rtp_send_h263_rfc2190(), ff_rtp_send_h264_hevc(), ff_rtp_send_jpeg(), ff_rtp_send_latm(), ff_rtp_send_mpegvideo(), ff_rtp_send_raw_rfc4175(), ff_rtp_send_vp8(), ff_rtp_send_vp9(), ff_rtp_send_xiph(), ff_sndio_open(), fifo_consumer_thread(), fifo_deinit(), fifo_init(), fifo_mux_init(), fifo_test_header(), fifo_test_packet(), fifo_test_trailer(), fifo_thread_attempt_recovery(), fifo_thread_flush_output(), fifo_thread_process_recovery_failure(), fifo_thread_recover(), fifo_thread_write_header(), fifo_thread_write_packet(), fifo_thread_write_trailer(), fifo_write_header(), fifo_write_packet(), fifo_write_trailer(), film_deinit(), film_grain_params(), film_init(), film_write_header(), film_write_packet(), flush(), flush_buffered(), flush_packet(), frame(), frame_header(), frame_header_obu(), frame_size(), frame_size_with_refs(), frm_read_packet(), gdigrab_read_close(), gdigrab_read_header(), gdigrab_read_packet(), gdv_read_header(), gdv_read_packet(), get_current_fragment(), get_image_format(), get_metadata(), get_next_nb_samples(), get_packet_lj92(), get_sensor_orientation(), get_system_header_size(), get_vcd_padding_size(), h264_extradata_to_annexb(), h264_filter(), h264_flush(), h264_init(), h264_mp4toannexb_close(), h264_mp4toannexb_filter(), h264_mp4toannexb_flush(), h264_queue_frame(), h264_redundant_pps_fixup_slice(), hevc_mp4toannexb_filter(), hevc_mp4toannexb_init(), hls_start(), hls_write_packet(), image_available(), img_read_close(), init(), init_convert_timestamp(), init_subtitle_context(), kmsgrab_get_fb(), kmsgrab_read_close(), kmsgrab_read_header(), kmsgrab_read_packet(), laf_read_close(), laf_read_header(), laf_read_packet(), laf_read_seek(), lavfi_read_close(), lavfi_read_header(), lavfi_read_packet(), list_formats(), list_standards(), loop_filter_params(), lr_params(), match_framerate(), match_streams(), match_streams_exact_id(), match_streams_one_to_one(), match_video_size(), mcc_init(), mcc_write_header(), mcc_write_packet(), mmap_init(), mmap_read_frame(), mmap_start(), mpeg4_unpack_bframes_filter(), mpeg_mux_init(), mpeg_mux_write_packet(), mv_read_header(), mv_read_packet(), mv_read_seek(), nal_send(), noise(), noise_init(), obu_header(), open_camera(), open_file(), open_next_file(), opus_decode_flush(), opus_find_frame_end(), opus_header(), opus_packet(), opus_parse(), output_packet(), parse_audio_var(), parse_device_name(), parse_global_var(), parse_nal_units(), picture_coding_extension(), picture_display_extension(), picture_header(), pps(), pps_multilayer_extension(), pps_range_extension(), pred_weight_table(), put_pack_header(), put_padding_packet(), put_system_header(), put_vcd_padding_sector(), quantization_matrix(), quantization_params(), rawvideo_read_header(), rcwt_flush_cluster(), rcwt_read_header(), rcwt_write_header(), rcwt_write_packet(), read_close(), read_data(), read_data_continuous(), read_data_subtitle_segment(), read_header(), read_packet(), read_seek(), read_subtitle_packet(), read_tx_mode(), real_seek(), rechunk_filter(), reconfig_encoder(), ref_pic_list_modification(), ref_pic_list_struct(), remove_extradata(), render_size(), rtcp_send_sr(), rtp_send_ilbc(), rtp_send_mpegaudio(), rtp_send_mpegts_raw(), rtp_send_raw(), rtp_send_samples(), rtp_write_header(), rtp_write_packet(), rtp_write_trailer(), rv10_write_header(), sbg_read_header(), scan_file(), scc_write_header(), scc_write_packet(), sds_read_header(), sds_read_packet(), segment_start(), segmentation_params(), SEI_FUNC(), send_mode_a(), send_mode_b(), send_packet(), send_picture(), sequence_extension(), sequence_header(), set_frame_duration(), set_frame_refs(), setts_filter(), setts_init(), setup_crossbar_options(), setup_frame(), setup_roi(), show_stream(), showinfo_filter(), skip_mode_params(), slice_header(), slice_segment_header(), smush_read_header(), smush_read_packet(), sps(), srt_write_header(), srt_write_packet(), superres_params(), synth_frame(), synth_superframe(), tedcaptions_read_close(), tedcaptions_read_header(), tedcaptions_read_packet(), tedcaptions_read_seek(), tee_process_slave_failure(), tee_write_header(), tee_write_packet(), tee_write_trailer(), temporal_delimiter_obu(), theora_gptopts(), tile(), tile_group_obu(), tile_header(), tile_info(), truehd_core_filter(), truehd_core_flush(), try_seek(), ttml_write_header(), ttml_write_packet(), ttml_write_trailer(), uncompressed_header(), uninit(), update_init_section(), v4l2_get_device_list(), v4l2_read_close(), v4l2_read_header(), v4l2_set_parameters(), vaapi_encode_surface_alignment(), decklink_input_callback::VideoInputFormatChanged(), decklink_input_callback::VideoInputFrameArrived(), vp9_superframe_close(), vp9_superframe_filter(), vp9_superframe_flush(), vp9_superframe_init(), vp9_superframe_split_filter(), vp9_superframe_split_flush(), vp9_superframe_split_init(), vp9_superframe_split_uninit(), vvc_mp4toannexb_filter(), vvc_mp4toannexb_init(), wait_for_image_format(), wmavoice_decode_end(), wmavoice_decode_init(), wmavoice_decode_packet(), wmavoice_flush(), write_header(), write_headers(), write_packet(), write_streamheader(), write_trailer(), wsaud_write_header(), wsaud_write_packet(), wsaud_write_trailer(), wv_read_block_header(), wv_write_packet(), wv_write_trailer(), and X264_frame().

I/O context.

• demuxing: either set by the user before avformat_open_input() (then the user must close it manually) or set by avformat_open_input().
• muxing: set by the user before avformat_write_header(). The caller must take care of closing / freeing the IO context.

Do NOT set this field if AVFMT_NOFILE flag is set in iformat/oformat.flags. In such a case, the (de)muxer will handle I/O in some other way and this field will be NULL.

Examples

avio_read_callback.c, mux.c, qsv_transcode.c, remux.c, transcode.c, and vaapi_transcode.c.

Definition at line 1306 of file avformat.h.

Referenced by apng_write_header(), apng_write_trailer(), asfrtp_parse_packet(), avformat_find_stream_info(), avi_read_close(), chunk_end(), chunk_start(), cine_read_header(), cine_read_packet(), cine_read_seek(), close_demux_for_component(), close_slave(), concat_parse_script(), create_rtp_muxer(), dash_flush(), dash_free(), dash_init(), dash_write_packet(), efi_read(), estimate_timings(), estimate_timings_from_bit_rate(), estimate_timings_from_pts(), event_loop(), ff_img_read_header(), ff_img_read_packet(), ff_mov_add_hinted_packet(), ff_mov_close_hinting(), ff_mov_generate_squashed_ttml_packet(), ff_rtp_chain_mux_open(), ff_rtp_send_data(), ff_rtsp_tcp_write_packet(), ff_rtsp_undo_setup(), ff_sauce_read(), ff_wms_parse_sdp_a_line(), fifo_thread_write_trailer(), film_write_packet(), finish(), flush_dynbuf(), flush_packet(), free_playlist_list(), free_representation(), frm_read_header(), frm_read_packet(), gdv_read_header(), gdv_read_packet(), hds_flush(), hds_free(), hds_write_header(), hls_mux_init(), hls_read_header(), hls_start(), hls_write_packet(), hls_write_trailer(), init_fps(), init_subtitle_context(), ism_flush(), ism_free(), ism_write_header(), laf_read_header(), laf_read_packet(), LLVMFuzzerTestOneInput(), main(), mcc_write_header(), mcc_write_packet(), microdvd_write_packet(), mpegts_write_packet_internal(), msnwc_tcp_read_header(), msnwc_tcp_read_packet(), mv_read_header(), mv_read_packet(), mv_read_seek(), mxf_parse_handle_essence(), mxf_read_local_tags(), mxf_seek_to_previous_partition(), of_open(), open_output_file(), parse_audio_var(), parse_global_var(), parse_playlist(), parse_video_var(), put_vcd_padding_sector(), rcwt_flush_cluster(), rcwt_read_header(), rcwt_write_header(), rdt_parse_packet(), read_gab2_sub(), read_header(), read_packet(), read_seek(), read_table(), read_thread(), reopen_demux_for_component(), rtcp_send_sr(), rtp_mpegts_write_close(), rtp_mpegts_write_header(), rtp_mpegts_write_packet(), rtp_write_header(), rtp_write_trailer(), rv10_write_header(), sap_read_header(), sap_write_close(), sbg_read_header(), scc_write_header(), scc_write_packet(), sds_read_header(), sds_read_packet(), seg_free(), seg_init(), seg_write_header(), seg_write_packet(), seg_write_trailer(), segment_end(), segment_start(), show_format(), smush_read_header(), smush_read_packet(), srt_write_packet(), tedcaptions_read_header(), ttml_write_header(), ttml_write_packet(), ttml_write_trailer(), update_stream_timings(), var_read_metadata(), webm_chunk_deinit(), webm_chunk_init(), webm_chunk_write_header(), webm_chunk_write_packet(), webm_chunk_write_trailer(), webvtt_write_header(), webvtt_write_packet(), whip_deinit(), write_header(), write_muxed_file(), write_packet_header(), wsaud_write_header(), wsaud_write_init(), wsaud_write_packet(), wsaud_write_trailer(), wv_write_packet(), and wv_write_trailer().

Flags signalling stream properties.

A combination of AVFMTCTX_*. Set by libavformat.

Definition at line 1313 of file avformat.h.

Referenced by avformat_find_stream_info(), ff_img_read_header(), handle_packet(), hls_read_header(), hls_read_packet(), sap_read_header(), and tb_unreliable().

Number of elements in AVFormatContext.streams.

Set by avformat_new_stream(), must not be modified by any other code.

Examples

mux.c, qsv_decode.c, remux.c, and transcode.c.

Definition at line 1320 of file avformat.h.

Referenced by add_stream(), asfrtp_parse_sdp_line(), at_write_header(), audio_write_header(), av_dump_format(), av_find_best_stream(), av_program_add_stream_index(), avformat_find_stream_info(), close_slave(), concat_parse_script(), concat_read_header(), copy_metadata(), create_streams(), create_subcc_streams(), dump_stream_meta(), estimate_timings(), estimate_timings_from_bit_rate(), estimate_timings_from_pts(), ff_decklink_write_header(), ff_metadata_conv_ctx(), ff_nut_reset_ts(), ff_rdt_parse_open(), ff_rfps_calculate(), fifo_consumer_thread(), fifo_mux_init(), fifo_thread_write_header(), fill_all_stream_timings(), film_init(), find_stream(), get_system_header_size(), handle_file(), handle_id3(), has_duration(), hds_write_header(), hls_read_header(), hls_read_packet(), id3_has_changed_values(), ifile_open(), init_filters(), laf_read_header(), laf_read_packet(), log_slave(), main(), match_streams(), match_streams_exact_id(), match_streams_one_to_one(), mcc_init(), movie_common_init(), mpeg_mux_deinit(), mpeg_mux_end(), mpeg_mux_init(), mv_read_packet(), mv_read_seek(), mxf_compute_index_tables(), mxf_parse_structural_metadata(), of_add_metadata(), of_parse_group_token(), open_demux_for_component(), open_input_file(), open_output_file(), open_slave(), open_track_resource_context(), output_packet(), probe_file(), put_system_header(), read_gab2_sub(), read_interval_packets(), read_packet(), read_thread(), real_seek(), remove_decoded_packets(), reopen_demux_for_component(), rtp_write_header(), rv10_write_header(), sap_fetch_packet(), sap_read_header(), seg_init(), set_disposition_bits(), set_dispositions(), setup_sync_queues(), show_format(), stream_component_close(), stream_component_open(), tee_write_header(), update_stream_timings(), update_streams_from_subdemuxer(), write_header(), write_headers(), write_index(), and write_mainheader().

A list of all streams in the file.

New streams are created with avformat_new_stream().

• demuxing: streams are created by libavformat in avformat_open_input(). If AVFMTCTX_NOHEADER is set in ctx_flags, then new streams may also appear in av_read_frame().
• muxing: streams are created by the user before avformat_write_header().

Freed by libavformat in avformat_free_context().

Examples

decode_filter_audio.c, decode_filter_video.c, demux_decode.c, extract_mvs.c, hw_decode.c, mux.c, qsv_decode.c, qsv_transcode.c, remux.c, transcode.c, and vaapi_transcode.c.

Definition at line 1332 of file avformat.h.

Referenced by apng_write_header(), asfrtp_parse_packet(), asfrtp_parse_sdp_line(), at_write_header(), audio_write_frame(), audio_write_header(), av_find_best_stream(), avformat_find_stream_info(), cine_read_packet(), copy_metadata(), create_rtp_muxer(), create_subcc_streams(), dash_check_bitstream(), dash_read_packet(), decklink_write_audio_packet(), decklink_write_video_packet(), dump_stream_format(), dump_stream_meta(), dv_parse_sdp_line(), encode_write(), encode_write_frame(), estimate_timings(), estimate_timings_from_bit_rate(), estimate_timings_from_pts(), ff_decklink_write_header(), ff_decklink_write_packet(), ff_img_read_packet(), ff_load_image(), ff_metadata_conv_ctx(), ff_mov_init_hinting(), ff_rdt_parse_open(), ff_rfps_calculate(), ff_rtp_chain_mux_open(), ff_rtp_send_aac(), ff_rtp_send_amr(), ff_rtp_send_jpeg(), ff_rtp_send_latm(), ff_rtp_send_raw_rfc4175(), ff_rtp_send_xiph(), ff_sauce_read(), fifo_consumer_thread(), fifo_mux_init(), fifo_thread_attempt_recovery(), fifo_thread_write_header(), fifo_thread_write_packet(), fill_all_stream_timings(), fill_timing_for_id3_timestamped_stream(), film_init(), film_write_header(), film_write_packet(), find_stream(), flush_buffered(), flush_packet(), frm_read_packet(), get_private_data(), get_system_header_size(), get_timebase(), handle_file(), has_duration(), hds_write_header(), hevc_parse_sdp_line(), hls_read_header(), hls_read_packet(), hls_write_header(), id3_has_changed_values(), ifile_open(), imf_read_packet(), init_convert_timestamp(), init_filters(), laf_read_packet(), lavfi_read_header(), lavfi_read_packet(), log_packet(), log_slave(), main(), match_streams_exact_id(), match_streams_one_to_one(), mcc_init(), mov_read_chapters(), mov_write_ttml_document_from_queue(), mov_write_udta_sdp(), movie_common_init(), mpeg_mux_deinit(), mpeg_mux_end(), mpeg_mux_init(), mpeg_mux_write_packet(), mpegts_push_data(), mpegts_write_packet_internal(), mv_read_packet(), mv_read_seek(), mxf_compute_index_tables(), mxf_parse_structural_metadata(), mxf_set_audio_pts(), nal_send(), next_duration(), of_add_metadata(), of_parse_group_token(), open_codec_context(), open_demux_for_component(), open_input_file(), open_output_file(), open_slave(), open_track_resource_context(), opt_map(), opt_target(), opus_header(), opus_packet(), output_packet(), output_segment_list(), pmt_cb(), probe_file(), put_system_header(), rcwt_write_header(), read_gab2_sub(), read_packet(), read_seek(), read_thread(), real_seek(), remove_decoded_packets(), reopen_demux_for_component(), report_new_stream(), rtcp_send_sr(), rtp_mpegts_write_header(), rtp_mpegts_write_packet(), rtp_send_ilbc(), rtp_write_header(), rtp_write_packet(), sap_fetch_packet(), sap_read_header(), sap_write_header(), sbg_read_packet(), sbg_read_seek2(), scc_write_header(), seek_test(), seg_check_bitstream(), seg_init(), set_disposition_bits(), srt_write_header(), stream_component_close(), stream_component_open(), tee_write_packet(), ttml_write_header(), update_stream_extradata(), update_stream_timings(), update_streams_from_subdemuxer(), v4l2_set_parameters(), video_decode(), video_decode_example(), webm_chunk_write_header(), webvtt_write_header(), write_header(), write_headers(), write_hls_media_playlist(), and wsaud_write_header().

Number of elements in AVFormatContext.stream_groups.

Set by avformat_stream_group_create(), must not be modified by any other code.

Definition at line 1339 of file avformat.h.

Referenced by av_dump_format(), dump_stream_group(), get_stream_group_index_from_id(), of_map_group(), of_parse_group_token(), of_parse_iamf_submixes(), show_format(), and show_stream_groups().

A list of all stream groups in the file.

New groups are created with avformat_stream_group_create(), and filled with avformat_stream_group_add_stream().

• demuxing: groups may be created by libavformat in avformat_open_input(). If AVFMTCTX_NOHEADER is set in ctx_flags, then new groups may also appear in av_read_frame().
• muxing: groups may be created by the user before avformat_write_header().

Freed by libavformat in avformat_free_context().

Definition at line 1351 of file avformat.h.

Referenced by dump_stream_group(), get_stream_group_index_from_id(), of_map_group(), of_parse_group_token(), of_parse_iamf_submixes(), and show_stream_groups().

Number of chapters in AVChapter array.

When muxing, chapters are normally written in the file header, so nb_chapters should normally be initialized before write_header is called. Some muxers (e.g. mov and mkv) can also write chapters in the trailer. To write chapters in the trailer, nb_chapters must be zero when write_header is called and non-zero when write_trailer is called.

• muxing: set by user
• demuxing: set by libavformat

Definition at line 1364 of file avformat.h.

Referenced by av_dump_format(), copy_chapters(), copy_meta(), event_loop(), ff_metadata_conv_ctx(), of_add_metadata(), ogm_chapter(), parse_forced_key_frames(), show_chapters(), and write_headers().

Definition at line 1365 of file avformat.h.

Referenced by av_dump_format(), copy_chapters(), ff_metadata_conv_ctx(), of_add_metadata(), ogm_chapter(), parse_forced_key_frames(), show_chapters(), and write_chapter().

input or output URL.

Unlike the old filename field, this field has no length restriction.

• demuxing: set by avformat_open_input(), initialized to an empty string if url parameter was NULL in avformat_open_input().
• muxing: may be set by the caller before calling avformat_write_header() (or avformat_init_output() if that is called first) to a string which is freeable by av_free(). Set to an empty string if it was NULL in avformat_init_output().

Freed by libavformat in avformat_free_context().

Definition at line 1380 of file avformat.h.

Referenced by add_file(), append_single_file(), assert_file_overwrite(), at_write_header(), audio_read_header(), audio_write_header(), create_streams(), dash_init(), decklink_setup_video(), destroy_context(), fbdev_read_header(), ff_alsa_open(), ff_decklink_list_formats(), ff_decklink_read_header(), ff_decklink_write_header(), ff_img_read_header(), ff_img_read_packet(), ff_rtsp_setup_output_streams(), fifo_init(), fifo_thread_write_header(), gdigrab_read_header(), hls_append_segment(), hls_delete_old_segments(), hls_mux_init(), hls_rename_temp_file(), hls_start(), hls_write_packet(), hls_write_trailer(), lavfi_read_header(), log_slave(), map_auto_audio(), map_auto_data(), map_auto_video(), of_open(), open_input_file(), parse_device_name(), read_header(), seg_init(), seg_write_header(), seg_write_packet(), segment_end(), segment_start(), set_segment_filename(), show_format(), sls_flag_file_rename(), sls_flag_use_localtime_filename(), sls_flags_filename_process(), tee_write_header(), v4l2_read_header(), webm_chunk_init(), and write_header().

Position of the first frame of the component, in AV_TIME_BASE fractional seconds.

NEVER set this value directly: It is deduced from the AVStream values.

Demuxing only, set by libavformat.

Definition at line 1389 of file avformat.h.

Referenced by av_dump_format(), estimate_timings(), event_loop(), fill_all_stream_timings(), ifile_open(), ist_filter_add(), movie_common_init(), read_packets(), read_thread(), rewind_file(), show_format(), and update_stream_timings().

Duration of the stream, in AV_TIME_BASE fractional seconds.

Only set this value if you know none of the individual stream durations and also do not set any of them. This is deduced from the AVStream values if not set.

Demuxing only, set by libavformat.

Definition at line 1399 of file avformat.h.

Referenced by av_dump_format(), concat_read_header(), estimate_timings(), estimate_timings_from_bit_rate(), event_loop(), fill_all_stream_timings(), get_best_effort_duration(), has_duration(), ifile_open(), libjxl_anim_encode_frame(), libjxl_receive_frame(), of_open(), process_command(), request_frame(), set_frame_duration(), show_format(), update_stream_timings(), and xfade_opencl_config_output().

Total stream bitrate in bit/s, 0 if not available.

Never set it directly if the file_size and the duration are known as FFmpeg can compute it automatically.

Definition at line 1406 of file avformat.h.

Referenced by av_dump_format(), estimate_timings(), estimate_timings_from_bit_rate(), event_loop(), get_bit_rate(), LLVMFuzzerTestOneInput(), psy_3gpp_init(), reconfig_encoder(), show_format(), update_stream_timings(), and vaapi_encode_h264_init_sequence_params().

Definition at line 1408 of file avformat.h.

Referenced by dss_723_1_read_packet(), dss_read_seek(), mpeg_mux_init(), rawvideo_read_header(), and rtp_write_header().

Definition at line 1409 of file avformat.h.

Referenced by create_rtp_muxer(), ff_rtp_chain_mux_open(), ff_rtp_send_aac(), ff_rtp_send_amr(), ff_rtp_send_xiph(), fifo_mux_init(), hls_mux_init(), mpeg_mux_init(), of_open(), output_packet(), rtp_mpegts_write_header(), rtp_send_ilbc(), sap_read_header(), segment_mux_init(), and webm_chunk_init().

Flags modifying the (de)muxer behaviour.

A combination of AVFMT_FLAG_*. Set by the user before avformat_open_input() / avformat_write_header().

Definition at line 1415 of file avformat.h.

Referenced by add_legacy_sws_pass(), android_camera_read_packet(), aribcaption_decode(), avfilter_init_dict(), avformat_find_stream_info(), check_ops(), create_rtp_muxer(), d3d12va_encode_init_gop_structure(), d3d12va_encode_init_rate_control(), dash_init(), decode_bl16(), decode_frame_header(), decode_slice_thread(), deint_vaapi_build_filter_params(), device_open(), dnxhd_decode_macroblock(), fbdev_read_header(), fbdev_read_packet(), ff_alsa_open(), ff_d3d12va_encode_init(), ff_img_read_header(), ff_rtp_chain_mux_open(), ff_vaapi_encode_init(), ff_vk_decode_flush(), ff_vulkan_encode_init(), fic_decode_frame(), fifo_mux_init(), find_slice_quant(), gdigrab_read_packet(), hds_write_header(), hls_read_header(), ifile_open(), imm5_init(), init_fps(), libjxl_receive_frame(), main(), mcc_write_header(), mlp_encode_init(), mov_write_isml_manifest(), mss1_decode_frame(), nvenc_check_capabilities(), nvenc_map_preset(), nvenc_setup_device(), nvenc_setup_encoder(), nvenc_setup_h264_config(), nvenc_setup_rate_control(), of_open(), open_file(), open_slave(), open_track_resource_context(), opus_parse(), process_frame_obj(), psy_3gpp_init(), read_packet(), read_thread(), reopen_demux_for_component(), rtp_write_header(), segment_mux_init(), set_enable_expr(), setup_frame(), sws_frame_setup(), tdsc_init(), vaapi_decode_find_best_format(), vaapi_encode_init_gop_structure(), vaapi_encode_init_rate_control(), vaapi_encode_init_slice_structure(), vaapi_encode_output(), vaapi_frames_init(), vble_decode_frame(), vpx_init(), vulkan_encode_av1_init(), vulkan_encode_h264_init(), vulkan_encode_h265_init(), vulkan_encode_issue(), vulkan_encode_output(), webm_chunk_init(), write_header(), write_major_sync(), and X264_frame().

Maximum number of bytes read from input in order to determine stream properties.

Used when reading the global header and in avformat_find_stream_info().

Demuxing only, set by the caller before avformat_open_input().

Note

this is not used for determining the input format

See also

format_probesize

Definition at line 1448 of file avformat.h.

Referenced by avformat_find_stream_info(), hls_read_header(), lavfi_read_header(), and reopen_demux_for_component().

Maximum duration (in AV_TIME_BASE units) of the data read from input in avformat_find_stream_info().

Demuxing only, set by the caller before avformat_find_stream_info(). Can be set to 0 to let avformat choose using a heuristic.

Definition at line 1456 of file avformat.h.

Referenced by avformat_find_stream_info(), hls_read_header(), and reopen_demux_for_component().

Definition at line 1458 of file avformat.h.

Referenced by av_tea_init(), av_xtea_init(), av_xtea_le_init(), tea_crypt_ecb(), xtea_crypt_ecb(), and xtea_le_crypt_ecb().

Definition at line 1459 of file avformat.h.

Definition at line 1461 of file avformat.h.

Referenced by av_dump_format(), av_find_program_from_stream(), av_new_program(), av_program_add_stream_index(), clear_avprogram(), discard_pid(), discard_unused_programs(), ff_metadata_conv_ctx(), of_add_metadata(), pat_cb(), show_format(), show_programs(), and update_stream_timings().

Definition at line 1462 of file avformat.h.

Referenced by av_dump_format(), av_find_program_from_stream(), av_new_program(), av_program_add_stream_index(), clear_avprogram(), discard_pid(), discard_unused_programs(), ff_metadata_conv_ctx(), of_add_metadata(), pat_cb(), show_programs(), and update_stream_timings().

Forced video codec_id.

Demuxing: Set by user.

Definition at line 1468 of file avformat.h.

Referenced by device_try_init(), dshow_cycle_formats(), dshow_read_header(), dshow_should_set_format(), ff_img_read_header(), ifile_open(), mmap_read_frame(), and v4l2_read_header().

Forced audio codec_id.

Demuxing: Set by user.

Definition at line 1474 of file avformat.h.

Referenced by audio_read_header(), ff_img_read_header(), and ifile_open().

Forced subtitle codec_id.

Demuxing: Set by user.

Definition at line 1480 of file avformat.h.

Referenced by ifile_open().

Forced Data codec_id.

Demuxing: Set by user.

Definition at line 1486 of file avformat.h.

Referenced by ifile_open().

Metadata that applies to the whole file.

• demuxing: set by libavformat in avformat_open_input()
• muxing: may be set by the caller before avformat_write_header()

Freed by libavformat in avformat_free_context().

Examples

show_metadata.c.

Definition at line 1496 of file avformat.h.

Referenced by av_dump_format(), copy_meta(), ff_decklink_read_packet(), ff_metadata_conv_ctx(), ff_sauce_read(), ff_wms_parse_sdp_a_line(), fifo_mux_init(), handle_id3(), hls_mux_init(), hls_read_header(), hls_read_packet(), main(), mxf_parse_structural_metadata(), of_add_metadata(), open_slave(), read_header(), read_string(), read_thread(), read_uint16(), read_uint32(), read_uint64(), read_uint8(), rtp_mpegts_write_header(), rv10_write_header(), scan_file(), segment_mux_init(), show_format(), var_read_metadata(), and webm_chunk_init().

Start time of the stream in real world time, in microseconds since the Unix epoch (00:00 1st January 1970).

That is, pts=0 in the stream was captured at this real world time.

• muxing: Set by the caller before avformat_write_header(). If set to either 0 or AV_NOPTS_VALUE, then the current wall-time will be used.
• demuxing: Set by libavformat. AV_NOPTS_VALUE if unknown. Note that the value may become known after some number of frames have been received.

Definition at line 1509 of file avformat.h.

Referenced by create_rtp_muxer(), ff_rtp_chain_mux_open(), and rtp_write_header().

The number of frames used for determining the framerate in avformat_find_stream_info().

Demuxing only, set by the caller before avformat_find_stream_info().

Definition at line 1516 of file avformat.h.

Referenced by avformat_find_stream_info().

Error recognition; higher values will detect more errors but may misdetect some more or less valid parts as errors.

Demuxing only, set by the caller before avformat_open_input().

Definition at line 1523 of file avformat.h.

Custom interrupt callbacks for the I/O layer.

demuxing: set by the user before avformat_open_input(). muxing: set by the user before avformat_write_header() (mainly useful for AVFMT_NOFILE formats). The callback should also be passed to avio_open2() if it's used to open the file.

Definition at line 1534 of file avformat.h.

Referenced by avformat_find_stream_info(), create_rtp_muxer(), dash_init(), ff_rtp_chain_mux_open(), fifo_mux_init(), fifo_test_packet(), hds_write_header(), hls_mux_init(), hls_read_header(), ifile_open(), ism_seek(), ism_write_header(), lavfi_read_header(), LLVMFuzzerTestOneInput(), of_open(), open_file(), open_slave(), read_thread(), reopen_demux_for_component(), sap_read_header(), segment_mux_init(), and webm_chunk_init().

Flags to enable debugging.

Definition at line 1539 of file avformat.h.

Referenced by LLVMFuzzerTestOneInput().

The maximum number of streams.

• encoding: unused
• decoding: set by user

Definition at line 1547 of file avformat.h.

Maximum amount of memory in bytes to use for the index of each stream.

If the index exceeds this size, entries will be discarded as needed to maintain a smaller size. This can lead to slower or less accurate seeking (depends on demuxer). Demuxers for which a full in-memory index is mandatory will ignore this.

• muxing: unused
• demuxing: set by user

Definition at line 1559 of file avformat.h.

Maximum amount of memory in bytes to use for buffering frames obtained from realtime capture devices.

Definition at line 1565 of file avformat.h.

Maximum buffering duration for interleaving.

To ensure all the streams are interleaved correctly, av_interleaved_write_frame() will wait until it has at least one packet for each stream before actually writing any packets to the output file. When some streams are "sparse" (i.e. there are large gaps between successive packets), this can result in excessive buffering.

This field specifies the maximum difference between the timestamps of the first and the last packet in the muxing queue, above which libavformat will output a packet regardless of whether it has queued a packet for all the streams.

Muxing only, set by the caller before avformat_write_header().

Definition at line 1583 of file avformat.h.

Maximum number of packets to read while waiting for the first timestamp.

Decoding only.

Definition at line 1589 of file avformat.h.

Referenced by avformat_find_stream_info().

Max chunk time in microseconds.

Note, not all formats support this and unpredictable things may happen if it is used when not supported.

• encoding: Set by user
• decoding: unused

Definition at line 1597 of file avformat.h.

Max chunk size in bytes Note, not all formats support this and unpredictable things may happen if it is used when not supported.

• encoding: Set by user
• decoding: unused

Definition at line 1605 of file avformat.h.

Maximum number of packets that can be probed.

• encoding: unused
• decoding: set by user

Definition at line 1612 of file avformat.h.

Allow non-standard and experimental extension.

See also

AVCodecContext.strict_std_compliance

Definition at line 1618 of file avformat.h.

Referenced by create_rtp_muxer(), dash_init(), ff_rtp_chain_mux_open(), hls_mux_init(), LLVMFuzzerTestOneInput(), mov_write_video_tag(), open_slave(), rtp_write_header(), and webm_chunk_init().

Flags indicating events happening on the file, a combination of AVFMT_EVENT_FLAG_*.

• demuxing: may be set by the demuxer in avformat_open_input(), avformat_find_stream_info() and av_read_frame(). Flags must be cleared by the user once the event has been handled.
• muxing: may be set by the user after avformat_write_header() to indicate a user-triggered event. The muxer will clear the flags for events it has handled in av_[interleaved]_write_frame().

Definition at line 1631 of file avformat.h.

Referenced by hls_read_packet().

Avoid negative timestamps during muxing.

Any value of the AVFMT_AVOID_NEG_TS_* constants. Note, this works better when using av_interleaved_write_frame().

• muxing: Set by user
• demuxing: unused

Definition at line 1648 of file avformat.h.

Referenced by dash_init(), seg_init(), and webm_chunk_init().

Audio preload in microseconds.

Note, not all formats support this and unpredictable things may happen if it is used when not supported.

• encoding: Set by user
• decoding: unused

Definition at line 1660 of file avformat.h.

forces the use of wallclock timestamps as pts/dts of packets This has undefined results in the presence of B frames.

• encoding: unused
• decoding: Set by user

Definition at line 1668 of file avformat.h.

Skip duration calculation in estimate_timings_from_pts.

• encoding: unused
• decoding: set by user

See also

duration_probesize

Definition at line 1677 of file avformat.h.

Referenced by estimate_timings_from_pts().

avio flags, used to force AVIO_FLAG_DIRECT.

• encoding: unused
• decoding: Set by user

Definition at line 1684 of file avformat.h.

The duration field can be estimated through various ways, and this field can be used to know how the duration was estimated.

• encoding: unused
• decoding: Read by user

Definition at line 1692 of file avformat.h.

Referenced by estimate_timings().

Skip initial bytes when opening stream.

• encoding: unused
• decoding: Set by user

Definition at line 1699 of file avformat.h.

Correct single timestamp overflows.

• encoding: unused
• decoding: Set by user

Definition at line 1706 of file avformat.h.

Force seeking to any (also non key) frames.

• encoding: unused
• decoding: Set by user

Definition at line 1713 of file avformat.h.

Flush the I/O context after each packet.

• encoding: Set by user
• decoding: unused

Definition at line 1720 of file avformat.h.

Referenced by webm_chunk_init().

format probing score.

The maximal score is AVPROBE_SCORE_MAX, its set when the demuxer probes the format.

• encoding: unused
• decoding: set by avformat, read by user

Definition at line 1729 of file avformat.h.

Referenced by show_format().

Maximum number of bytes read from input in order to identify the input format.

Only used when the format is not set explicitly by the caller.

Demuxing only, set by the caller before avformat_open_input().

See also

probesize

Definition at line 1740 of file avformat.h.

',' separated list of allowed decoders.

If NULL then all are allowed

• encoding: unused
• decoding: set by user

Definition at line 1748 of file avformat.h.

Referenced by avformat_find_stream_info().

',' separated list of allowed demuxers.

If NULL then all are allowed

• encoding: unused
• decoding: set by user

Definition at line 1756 of file avformat.h.

',' separated list of allowed protocols.

• encoding: unused
• decoding: set by user

Definition at line 1763 of file avformat.h.

Referenced by ism_seek(), and lavfi_read_header().

',' separated list of disallowed protocols.

• encoding: unused
• decoding: set by user

Definition at line 1770 of file avformat.h.

Referenced by ism_seek().

IO repositioned flag.

This is set by avformat when the underlying IO context read pointer is repositioned, for example when doing byte based seeking. Demuxers can use the flag to detect such changes.

Definition at line 1778 of file avformat.h.

Forced video codec.

This allows forcing a specific decoder, even when there are multiple with the same codec_id. Demuxing: Set by user

Definition at line 1786 of file avformat.h.

Referenced by get_decoder_for_stream(), and ifile_open().

Forced audio codec.

This allows forcing a specific decoder, even when there are multiple with the same codec_id. Demuxing: Set by user

Definition at line 1794 of file avformat.h.

Referenced by dss_read_header(), dss_read_packet(), dss_read_seek(), get_decoder_for_stream(), and ifile_open().

Forced subtitle codec.

This allows forcing a specific decoder, even when there are multiple with the same codec_id. Demuxing: Set by user

Definition at line 1802 of file avformat.h.

Referenced by get_decoder_for_stream(), and ifile_open().

Forced data codec.

This allows forcing a specific decoder, even when there are multiple with the same codec_id. Demuxing: Set by user

Definition at line 1810 of file avformat.h.

Referenced by get_decoder_for_stream(), and ifile_open().

Number of bytes to be written as padding in a metadata header.

Demuxing: Unused. Muxing: Set by user.

Definition at line 1817 of file avformat.h.

User data.

This is a place for some private data of the user.

Definition at line 1823 of file avformat.h.

Referenced by dash_init(), fifo_mux_init(), hls_mux_init(), open_slave(), open_track_resource_context(), program_opencl_config_output(), and segment_mux_init().

Callback used by devices to communicate with application.

Definition at line 1828 of file avformat.h.

Output timestamp offset, in microseconds.

Muxing: set by user

Definition at line 1834 of file avformat.h.

dump format separator.

can be ", " or "\n " or anything else

• muxing: Set by user.
• demuxing: Set by user.

Definition at line 1842 of file avformat.h.

Referenced by dump_stream_format(), and dump_stream_group().

A callback for opening new IO streams.

Whenever a muxer or a demuxer needs to open an IO stream (typically from avformat_open_input() for demuxers, but for certain formats can happen at other times as well), it will call this callback to obtain an IO context.

Parameters

s the format context

pb on success, the newly opened IO context should be returned here

url the url to open

flags a combination of AVIO_FLAG_*

options a dictionary of additional options, with the same semantics as in avio_open2()

Returns

0 on success, a negative AVERROR code on failure

Note

Certain muxers and demuxers do nesting, i.e. they open one or more additional internal format contexts. Thus the AVFormatContext pointer passed to this callback may be different from the one facing the caller. It will, however, have the same 'opaque' field.

Definition at line 1864 of file avformat.h.

Referenced by dash_init(), ff_img_read_packet(), fifo_mux_init(), hls_mux_init(), hls_read_header(), init_subtitle_context(), open_slave(), open_track_resource_context(), read_header(), reopen_demux_for_component(), seg_write_header(), and segment_mux_init().

A callback for closing the streams opened with AVFormatContext.io_open().

Parameters

s the format context

pb IO context to be closed and freed

Returns

0 on success, a negative AVERROR code on failure

Definition at line 1874 of file avformat.h.

Referenced by dash_init(), fifo_mux_init(), hls_mux_init(), open_slave(), open_track_resource_context(), and segment_mux_init().

Maximum number of bytes read from input in order to determine stream durations when using estimate_timings_from_pts in avformat_find_stream_info().

Demuxing only, set by the caller before avformat_find_stream_info(). Can be set to 0 to let avformat choose using a heuristic.

See also

skip_estimate_duration_from_pts

Definition at line 1884 of file avformat.h.

Referenced by estimate_timings_from_pts().