Allow multiple d.

Definition at line 2721 of file avformat.h.

Definition at line 2871 of file avformat.h.

Send a nice hexadecimal dump of a buffer to the specified file stream.

Parameters

f The file stream pointer where the dump should be sent to.

buf buffer

size buffer size

See also

av_hex_dump_log, av_pkt_dump2, av_pkt_dump_log2

Definition at line 77 of file dump.c.

Send a nice hexadecimal dump of a buffer to the log.

Parameters

avcl A pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct.

level The importance level of the message, lower values signifying higher importance.

buf buffer

size buffer size

See also

av_hex_dump, av_pkt_dump2, av_pkt_dump_log2

Definition at line 82 of file dump.c.

Referenced by asf_read_header().

Send a nice dump of a packet to the specified file stream.

Parameters

f The file stream pointer where the dump should be sent to.

pkt packet to dump

dump_payload True if the payload must be displayed, too.

st AVStream that the packet belongs to

Definition at line 111 of file dump.c.

Send a nice dump of a packet to the log.

Parameters

avcl A pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct.

level The importance level of the message, lower values signifying higher importance.

pkt packet to dump

dump_payload True if the payload must be displayed, too.

st AVStream that the packet belongs to

Definition at line 116 of file dump.c.

Referenced by process_input().

Get the AVCodecID for the given codec tag tag.

If no codec id is found returns AV_CODEC_ID_NONE.

Parameters

tags list of supported codec_id-codec_tag pairs, as stored in AVInputFormat.codec_tag and AVOutputFormat.codec_tag

tag codec tag to match to a codec ID

Referenced by decode_stream_header(), dshow_get_format_info(), hls_mux_init(), init_output_stream_streamcopy(), and segment_mux_init().

Get the codec tag for the given codec id id.

If no codec tag is found returns 0.

Parameters

tags list of supported codec_id-codec_tag pairs, as stored in AVInputFormat.codec_tag and AVOutputFormat.codec_tag

id codec ID to match to a codec tag

Referenced by hls_mux_init(), init_muxer(), segment_mux_init(), and set_codec_str().

Get the codec tag for the given codec id.

Parameters

tags list of supported codec_id - codec_tag pairs, as stored in AVInputFormat.codec_tag and AVOutputFormat.codec_tag

id codec id that should be searched for in the list

tag A pointer to the found tag

Returns

0 if id was not found in tags, > 0 if it was found

Referenced by avformat_query_codec(), and init_output_stream_streamcopy().

Definition at line 311 of file avformat.c.

Referenced by seek_frame_internal(), and update_wrap_reference().

Get the index for a specific timestamp.

Parameters

st stream that the timestamp belongs to

timestamp timestamp to retrieve the index for

flags if AVSEEK_FLAG_BACKWARD then the returned index will correspond to the timestamp which is <= the requested one, if backward is 0, then it will be >= if AVSEEK_FLAG_ANY seek to any frame, only keyframes otherwise

Returns

< 0 if no such timestamp could be found

Definition at line 238 of file seek.c.

Referenced by ape_read_seek(), asf_read_seek(), avi_read_packet(), avi_read_seek(), dhav_read_seek(), ff_seek_frame_binary(), film_read_seek(), find_prev_closest_index(), flac_seek(), gxf_seek(), ifv_read_seek(), img_read_seek(), mov_seek_stream(), mp3_seek(), mpc8_read_seek(), mpc_read_seek(), mv_read_seek(), ni_prepare_read(), nsv_read_seek(), nut_write_packet(), read_packet(), read_seek(), rl2_read_seek(), seek_frame_generic(), smacker_read_seek(), tta_read_seek(), and voc_read_seek().

Get the index entry count for the given AVStream.

Parameters

st stream

Returns

the number of index entries in the stream

Definition at line 245 of file seek.c.

Get the AVIndexEntry corresponding to the given index.

Parameters

st Stream containing the requested AVIndexEntry.

idx The desired index.

Returns

A pointer to the requested AVIndexEntry if it exists, NULL otherwise.

Note

The pointer returned by this function is only guaranteed to be valid until any function that takes the stream or the parent AVFormatContext as input argument is called.

Definition at line 250 of file seek.c.

Get the AVIndexEntry corresponding to the given timestamp.

Parameters

st Stream containing the requested AVIndexEntry.

timestamp Timestamp to retrieve the index entry for.

flags If AVSEEK_FLAG_BACKWARD then the returned entry will correspond to the timestamp which is <= the requested one, if backward is 0, then it will be >= if AVSEEK_FLAG_ANY seek to any frame, only keyframes otherwise.

Returns

A pointer to the requested AVIndexEntry if it exists, NULL otherwise.

Note

The pointer returned by this function is only guaranteed to be valid until any function that takes the stream or the parent AVFormatContext as input argument is called.

Definition at line 259 of file seek.c.

Add an index entry into a sorted list.

Update the entry if the list already contains it.

Parameters

timestamp timestamp in the time base of the given stream

Definition at line 118 of file seek.c.

Referenced by add_keyframes_index(), ape_read_header(), asf_build_simple_index(), asf_read_pts(), asf_read_simple_index(), asf_read_timestamp(), av_read_frame(), avi_read_idx1(), avi_sync(), cine_read_header(), clean_index(), ff_img_read_packet(), ff_voc_get_packet(), film_read_header(), find_and_decode_index(), flac_read_header(), flv_read_packet(), gxf_read_index(), mpc8_parse_seektable(), mpc_read_packet(), mpegps_read_pes_header(), mpegts_get_dts(), mv_read_header(), nsv_parse_NSVs_header(), nut_write_packet(), nuv_read_dts(), pmp_header(), pva_read_header(), read_frame_internal(), read_header(), read_index(), read_odml_index(), read_pakt_chunk(), read_part_of_packet(), read_xing_toc(), rl2_read_header(), rm_read_dts(), rm_read_index(), rm_read_packet(), rpl_read_header(), smacker_read_header(), tta_read_header(), and xwma_read_header().

Split a URL string into components.

The pointers to buffers for storing individual components may be null, in order to ignore that component. Buffers for components not found are set to empty strings. If the port is not found, it is set to a negative value.

Parameters

proto the buffer for the protocol

proto_size the size of the proto buffer

authorization the buffer for the authorization

authorization_size the size of the authorization buffer

hostname the buffer for the host name

hostname_size the size of the hostname buffer

port_ptr a pointer to store the port number in

path the buffer for the path

path_size the size of the path buffer

url the URL to split

Definition at line 357 of file utils.c.

Referenced by amqp_proto_open(), ff_http_do_new_request2(), ff_rtp_set_remote_url(), ff_tls_open_underlying(), ff_udp_set_remote_url(), ftp_connect(), ftp_move(), gopher_open(), http_listen(), http_open_cnx_internal(), icecast_open(), libsrt_setup(), libssh_connect(), libssh_move(), mms_open(), mmsh_open_internal(), parse_command_line(), prompeg_open(), resetup_tcp(), rtmp_http_open(), rtmp_open(), rtmpe_open(), rtp_open(), rtsp_listen(), sap_read_header(), sap_write_header(), sctp_open(), srtp_open(), tcp_open(), test2(), test_same_origin(), and udp_open().

Print detailed information about the input or output format, such as duration, bitrate, streams, container, programs, metadata, side data, codec and time base.

Parameters

ic the context to analyze

index index of the stream to dump information about

url the URL to print, such as source or destination file

is_output Select whether the specified context is an input(0) or output(1)

Examples

avio_reading.c, demuxing_decoding.c, muxing.c, remuxing.c, and transcoding.c.

Definition at line 630 of file dump.c.

Referenced by main(), of_check_init(), open_input_file(), open_output_file(), and read_thread().

Return in 'buf' the path with 'd' replaced by a number.

Also handles the '%0nd' format where 'n' is the total number of digits and '%'.

Parameters

buf destination buffer

buf_size destination buffer size

path numbered sequence string

number frame number

flags AV_FRAME_FILENAME_FLAGS_*

Returns

0 if OK, -1 on format error

Definition at line 294 of file utils.c.

Referenced by av_get_frame_filename(), and write_packet().

Definition at line 352 of file utils.c.

Referenced by av_filename_number_test(), export(), ff_img_read_packet(), find_image_range(), get_chunk_filename(), init(), and set_segment_filename().

Check whether filename actually is a numbered sequence generator.

Parameters

filename possible numbered sequence string

Returns

1 if a valid numbered sequence string, 0 otherwise

Definition at line 125 of file utils.c.

Referenced by av_guess_format(), avformat_open_input(), img_read_probe(), and open_output_file().

Generate an SDP for an RTP session.

Note, this overwrites the id values of AVStreams in the muxer contexts for getting unique dynamic payload types.

Parameters

ac array of AVFormatContexts describing the RTP streams. If the array is composed by only one context, such context can contain multiple AVStreams (one AVStream per RTP stream). Otherwise, all the contexts in the array (an AVCodecContext per RTP stream) must contain only one AVStream.

n_files number of AVCodecContexts contained in ac

buf buffer where the SDP will be stored (must be allocated by the caller)

size the size of the buffer

Returns

0 if OK, AVERROR_xxx on error

Definition at line 910 of file sdp.c.

Referenced by ff_rtsp_setup_output_streams(), print_sdp(), and sap_write_header().

Return a positive value if the given filename has one of the given extensions, 0 otherwise.

Parameters

filename file name to check against the given extensions

extensions a comma-separated list of filename extensions

Definition at line 40 of file format.c.

Referenced by av_guess_format(), av_probe_input_format3(), avs3video_probe(), dash_init(), img_read_probe(), modplug_probe(), mov_find_codec_tag(), mpegts_init(), nsv_probe(), open_url(), pgm_probe(), pgmyuv_probe(), read_probe(), and seg_init().

Test if the given container can store a codec.

Parameters

ofmt container to check for compatibility

codec_id codec to potentially store in container

std_compliance standards compliance level, one of FF_COMPLIANCE_*

Returns

1 if codec with ID codec_id can be stored in ofmt, 0 if it cannot. A negative number if this information is not available.

Definition at line 40 of file mux_utils.c.

Referenced by open_output_file().

Guess the sample aspect ratio of a frame, based on both the stream and the frame aspect ratio.

Since the frame aspect ratio is set by the codec but the stream aspect ratio is set by the demuxer, these two may not be equal. This function tries to return the value that you should use if you would like to display the frame.

Basic logic is to use the stream aspect ratio if it is set to something sane otherwise use the frame aspect ratio. This way a container setting, which is usually easy to modify can override the coded value in the frames.

Parameters

format the format context which the stream is part of

stream the stream which the frame is part of

frame the frame with the aspect ratio to be determined

Returns

the guessed (valid) sample_aspect_ratio, 0/1 if no idea

Definition at line 589 of file avformat.c.

Referenced by get_video_frame(), read_thread(), show_frame(), and show_stream().

Guess the frame rate, based on both the container and codec information.

Parameters

ctx the format context which the stream is part of

stream the stream which the frame is part of

frame the frame for which the frame rate should be determined, may be NULL

Returns

the guessed (valid) frame rate, 0/1 if no idea

Definition at line 612 of file avformat.c.

Referenced by configure_input_video_filter(), open_input_file(), and video_thread().

Check if the stream st contained in s is matched by the stream specifier spec.

See the "stream specifiers" chapter in the documentation for the syntax of spec.

Returns

>0 if st is matched by spec; 0 if st is not matched by spec; AVERROR code if spec is invalid

Note

A stream specifier can match several streams in the format.

Definition at line 545 of file avformat.c.

Referenced by check_stream_specifier(), find_stream(), open_slave(), probe_file(), read_thread(), and select_reference_stream().

Definition at line 93 of file demux_utils.c.

Referenced by av_seek_frame(), avformat_open_input(), avformat_seek_file(), and hls_read_header().

Transfer internal timing information from one stream to another.

This function is useful when doing stream copy.

Parameters

ofmt target output format for ost

ost output stream which needs timings copy and adjustments

ist reference input stream to copy timings from

copy_tb define from where the stream codec timebase needs to be imported

Definition at line 633 of file avformat.c.

Referenced by init_output_stream_streamcopy().

Get the internal codec timebase from a stream.

Parameters

st input stream to extract the timebase from

Definition at line 691 of file avformat.c.

Referenced by init_output_stream_streamcopy().