various utility functions for use within FFmpeg More...

#include "avformat.h"
#include "avio_internal.h"
#include "internal.h"
#include "libavcodec/internal.h"
#include "libavcodec/raw.h"
#include "libavcodec/bytestream.h"
#include "libavutil/avassert.h"
#include "libavutil/opt.h"
#include "libavutil/dict.h"
#include "libavutil/pixdesc.h"
#include "metadata.h"
#include "id3v2.h"
#include "libavutil/avstring.h"
#include "libavutil/mathematics.h"
#include "libavutil/parseutils.h"
#include "libavutil/time.h"
#include "libavutil/timestamp.h"
#include "riff.h"
#include "audiointerleave.h"
#include "url.h"
#include <stdarg.h>
#include <assert.h>

Macros
#define	LICENSE_PREFIX "libavformat license: "

#define	RELATIVE_TS_BASE (INT64_MAX - (1LL<<48))

#define	MAKE_ACCESSORS(str, name, type, field)

#define	SANE_CHUNK_SIZE (50000000)

#define	PROBE_BUF_MIN 2048
	size of probe buffer, for guessing file type from file contents

#define	PROBE_BUF_MAX (1<<20)

#define	DURATION_MAX_READ_SIZE 250000LL

#define	DURATION_MAX_RETRY 4

#define	FAIL(errmsg)

#define	PRINT(...) do { if (!f) av_log(avcl, level, __VA_ARGS__); else fprintf(f, __VA_ARGS__); } while(0)

#define	PRINT(...) do { if (!f) av_log(avcl, level, __VA_ARGS__); else fprintf(f, __VA_ARGS__); } while(0)

Functions
unsigned	avformat_version (void)
	Return the LIBAVFORMAT_VERSION_INT constant.

const char *	avformat_configuration (void)
	Return the libavformat build-time configuration.

const char *	avformat_license (void)
	Return the libavformat license.

static int	is_relative (int64_t ts)

static int64_t	wrap_timestamp (AVStream *st, int64_t timestamp)
	Wrap a given time stamp, if there is an indication for an overflow.

int	ffio_limit (AVIOContext *s, int size)

static int	append_packet_chunked (AVIOContext s, AVPacket pkt, int size)

int	av_get_packet (AVIOContext s, AVPacket pkt, int size)
	Allocate and read the payload of a packet and initialize its fields with default values.

int	av_append_packet (AVIOContext s, AVPacket pkt, int size)
	Read data and append it to the current content of the AVPacket.

int	av_filename_number_test (const char *filename)
	Check whether filename actually is a numbered sequence generator.

AVInputFormat *	av_probe_input_format3 (AVProbeData pd, int is_opened, int score_ret)
	Guess the file format.

AVInputFormat *	av_probe_input_format2 (AVProbeData pd, int is_opened, int score_max)
	Guess the file format.

AVInputFormat *	av_probe_input_format (AVProbeData *pd, int is_opened)
	Guess the file format.

static int	set_codec_from_probe_data (AVFormatContext s, AVStream st, AVProbeData *pd)

int	av_demuxer_open (AVFormatContext *ic)

int	av_probe_input_buffer (AVIOContext pb, AVInputFormat fmt, const char filename, void *logctx, unsigned int offset, unsigned int max_probe_size)
	Probe a bytestream to determine the input format.

static int	init_input (AVFormatContext s, const char filename, AVDictionary **options)

static AVPacket *	add_to_pktbuf (AVPacketList *packet_buffer, AVPacket pkt, AVPacketList **plast_pktl)

int	avformat_queue_attached_pictures (AVFormatContext *s)

int	avformat_open_input (AVFormatContext *ps, const char filename, AVInputFormat fmt, AVDictionary *options)
	Open an input stream and read the header.

static void	force_codec_ids (AVFormatContext s, AVStream st)

static void	probe_codec (AVFormatContext s, AVStream st, const AVPacket *pkt)

int	ff_read_packet (AVFormatContext s, AVPacket pkt)
	Read a transport packet from a media file.

static int	determinable_frame_size (AVCodecContext *avctx)

int	ff_get_audio_frame_size (AVCodecContext *enc, int size, int mux)
	Get the number of samples of an audio frame.

void	ff_compute_frame_duration (int pnum, int pden, AVStream st, AVCodecParserContext pc, AVPacket *pkt)
	Return the frame duration in seconds.

static int	is_intra_only (AVCodecContext *enc)

static int	has_decode_delay_been_guessed (AVStream *st)

static AVPacketList *	get_next_pkt (AVFormatContext s, AVStream st, AVPacketList *pktl)

static int	update_wrap_reference (AVFormatContext s, AVStream st, int stream_index)

static void	update_initial_timestamps (AVFormatContext s, int stream_index, int64_t dts, int64_t pts, AVPacket pkt)

static void	update_initial_durations (AVFormatContext s, AVStream st, int stream_index, int duration)

static void	compute_pkt_fields (AVFormatContext s, AVStream st, AVCodecParserContext pc, AVPacket pkt)

static void	free_packet_buffer (AVPacketList pkt_buf, AVPacketList pkt_buf_end)

static int	parse_packet (AVFormatContext s, AVPacket pkt, int stream_index)
	Parse a packet, add all split parts to parse_queue.

static int	read_from_packet_buffer (AVPacketList pkt_buffer, AVPacketList pkt_buffer_end, AVPacket *pkt)

static int	read_frame_internal (AVFormatContext s, AVPacket pkt)

int	av_read_frame (AVFormatContext s, AVPacket pkt)
	Return the next frame of a stream.

static void	flush_packet_queue (AVFormatContext *s)

int	av_find_default_stream_index (AVFormatContext *s)

void	ff_read_frame_flush (AVFormatContext *s)
	Flush the frame reader.

void	ff_update_cur_dts (AVFormatContext s, AVStream ref_st, int64_t timestamp)
	Update cur_dts of all streams based on the given timestamp and AVStream.

void	ff_reduce_index (AVFormatContext *s, int stream_index)
	Ensure the index uses less memory than the maximum specified in AVFormatContext.max_index_size by discarding entries if it grows too large.

int	ff_add_index_entry (AVIndexEntry *index_entries, int nb_index_entries, unsigned int *index_entries_allocated_size, int64_t pos, int64_t timestamp, int size, int distance, int flags)
	Internal version of av_add_index_entry.

int	av_add_index_entry (AVStream *st, int64_t pos, int64_t timestamp, int size, int distance, int flags)
	Add an index entry into a sorted list.

int	ff_index_search_timestamp (const AVIndexEntry *entries, int nb_entries, int64_t wanted_timestamp, int flags)
	Internal version of av_index_search_timestamp.

int	av_index_search_timestamp (AVStream *st, int64_t wanted_timestamp, int flags)
	Get the index for a specific timestamp.

static int64_t	ff_read_timestamp (AVFormatContext s, int stream_index, int64_t ppos, int64_t pos_limit, int64_t(read_timestamp)(struct AVFormatContext , int, int64_t *, int64_t))

int	ff_seek_frame_binary (AVFormatContext *s, int stream_index, int64_t target_ts, int flags)
	Perform a binary search using av_index_search_timestamp() and AVInputFormat.read_timestamp().

int	ff_find_last_ts (AVFormatContext s, int stream_index, int64_t ts, int64_t pos, int64_t(read_timestamp)(struct AVFormatContext , int, int64_t , int64_t))

int64_t	ff_gen_search (AVFormatContext s, int stream_index, int64_t target_ts, int64_t pos_min, int64_t pos_max, int64_t pos_limit, int64_t ts_min, int64_t ts_max, int flags, int64_t ts_ret, int64_t(read_timestamp)(struct AVFormatContext , int, int64_t *, int64_t))
	Perform a binary search using read_timestamp().

static int	seek_frame_byte (AVFormatContext *s, int stream_index, int64_t pos, int flags)

static int	seek_frame_generic (AVFormatContext *s, int stream_index, int64_t timestamp, int flags)

static int	seek_frame_internal (AVFormatContext *s, int stream_index, int64_t timestamp, int flags)

int	av_seek_frame (AVFormatContext *s, int stream_index, int64_t timestamp, int flags)
	Seek to the keyframe at timestamp.

int	avformat_seek_file (AVFormatContext *s, int stream_index, int64_t min_ts, int64_t ts, int64_t max_ts, int flags)
	Seek to timestamp ts.

static int	has_duration (AVFormatContext *ic)
	Return TRUE if the stream has accurate duration in any stream.

static void	update_stream_timings (AVFormatContext *ic)
	Estimate the stream timings from the one of each components.

static void	fill_all_stream_timings (AVFormatContext *ic)

static void	estimate_timings_from_bit_rate (AVFormatContext *ic)

static void	estimate_timings_from_pts (AVFormatContext *ic, int64_t old_offset)

static void	estimate_timings (AVFormatContext *ic, int64_t old_offset)

static int	has_codec_parameters (AVStream st, const char *errmsg_ptr)

static int	try_decode_frame (AVStream st, AVPacket avpkt, AVDictionary **options)

unsigned int	ff_codec_get_tag (const AVCodecTag *tags, enum AVCodecID id)

enum AVCodecID	ff_codec_get_id (const AVCodecTag *tags, unsigned int tag)

enum AVCodecID	ff_get_pcm_codec_id (int bps, int flt, int be, int sflags)
	Select a PCM codec based on the given parameters.

unsigned int	av_codec_get_tag (const AVCodecTag const tags, enum AVCodecID id)

int	av_codec_get_tag2 (const AVCodecTag const tags, enum AVCodecID id, unsigned int *tag)

enum AVCodecID	av_codec_get_id (const AVCodecTag const tags, unsigned int tag)

static void	compute_chapters_end (AVFormatContext *s)

static int	get_std_framerate (int i)

static int	tb_unreliable (AVCodecContext *c)

int	avformat_find_stream_info (AVFormatContext ic, AVDictionary *options)
	Read packets of a media file to get stream information.

AVProgram *	av_find_program_from_stream (AVFormatContext ic, AVProgram last, int s)
	Find the programs which belong to a given stream.

int	av_find_best_stream (AVFormatContext ic, enum AVMediaType type, int wanted_stream_nb, int related_stream, AVCodec *decoder_ret, int flags)
	Find the "best" stream in the file.

int	av_read_play (AVFormatContext *s)
	Start playing a network-based stream (e.g.

int	av_read_pause (AVFormatContext *s)
	Pause a network-based stream (e.g.

void	ff_free_stream (AVFormatContext s, AVStream st)

void	avformat_free_context (AVFormatContext *s)
	Free an AVFormatContext and all its streams.

void	avformat_close_input (AVFormatContext **ps)
	Close an opened input AVFormatContext.

AVStream *	avformat_new_stream (AVFormatContext s, const AVCodec c)
	Add a new stream to a media file.

AVProgram *	av_new_program (AVFormatContext *ac, int id)

AVChapter *	avpriv_new_chapter (AVFormatContext s, int id, AVRational time_base, int64_t start, int64_t end, const char title)
	Add a new chapter.

void	ff_program_add_stream_index (AVFormatContext *ac, int progid, unsigned int idx)

static void	print_fps (double d, const char *postfix)

static void	dump_metadata (void ctx, AVDictionary m, const char *indent)

static void	dump_stream_format (AVFormatContext *ic, int i, int index, int is_output)

void	av_dump_format (AVFormatContext ic, int index, const char url, int is_output)

uint64_t	ff_ntp_time (void)
	Get the current time since NTP epoch in microseconds.

int	av_get_frame_filename (char buf, int buf_size, const char path, int number)
	Return in 'buf' the path with 'd' replaced by a number.

static void	hex_dump_internal (void avcl, FILE f, int level, const uint8_t *buf, int size)

void	av_hex_dump (FILE f, const uint8_t buf, int size)
	Send a nice hexadecimal dump of a buffer to the specified file stream.

void	av_hex_dump_log (void avcl, int level, const uint8_t buf, int size)
	Send a nice hexadecimal dump of a buffer to the log.

static void	pkt_dump_internal (void avcl, FILE f, int level, AVPacket *pkt, int dump_payload, AVRational time_base)

void	av_pkt_dump2 (FILE f, AVPacket pkt, int dump_payload, AVStream *st)
	Send a nice dump of a packet to the specified file stream.

void	av_pkt_dump_log2 (void avcl, int level, AVPacket pkt, int dump_payload, AVStream *st)
	Send a nice dump of a packet to the log.

void	av_url_split (char proto, int proto_size, char authorization, int authorization_size, char hostname, int hostname_size, int port_ptr, char path, int path_size, const char url)
	Split a URL string into components.

char *	ff_data_to_hex (char buff, const uint8_t src, int s, int lowercase)

int	ff_hex_to_data (uint8_t data, const char p)
	Parse a string of hexadecimal strings.

void	avpriv_set_pts_info (AVStream *s, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
	Set the time base and wrapping info for a given stream.

void	ff_parse_key_value (const char str, ff_parse_key_val_cb callback_get_buf, void context)
	Parse a string with comma-separated key=value pairs.

int	ff_find_stream_index (AVFormatContext *s, int id)
	Find stream index based on format-specific stream ID.

int64_t	ff_iso8601_to_unix_time (const char *datestr)
	Convert a date string in ISO8601 format to Unix timestamp.

int	avformat_query_codec (AVOutputFormat *ofmt, enum AVCodecID codec_id, int std_compliance)
	Test if the given container can store a codec.

int	avformat_network_init (void)
	Do global initialization of network components.

int	avformat_network_deinit (void)
	Undo the initialization done by avformat_network_init.

int	ff_add_param_change (AVPacket *pkt, int32_t channels, uint64_t channel_layout, int32_t sample_rate, int32_t width, int32_t height)
	Add side data to a packet for changing parameters to the given values.

AVRational	av_guess_sample_aspect_ratio (AVFormatContext format, AVStream stream, AVFrame *frame)
	Guess the sample aspect ratio of a frame, based on both the stream and the frame aspect ratio.

AVRational	av_guess_frame_rate (AVFormatContext format, AVStream st, AVFrame *frame)
	Guess the frame rate, based on both the container and codec information.

int	avformat_match_stream_specifier (AVFormatContext s, AVStream st, const char *spec)
	Check if the stream st contained in s is matched by the stream specifier spec.

void	ff_generate_avci_extradata (AVStream *st)
	Generate standard extradata for AVC-Intra based on width/height and field order.

Detailed Description

various utility functions for use within FFmpeg

Definition in file utils.c.

Macro Definition Documentation

#define LICENSE_PREFIX "libavformat license: "

#define RELATIVE_TS_BASE (INT64_MAX - (1LL<<48))

Definition at line 73 of file utils.c.

Referenced by av_read_frame(), avformat_find_stream_info(), avformat_new_stream(), ff_add_index_entry(), ff_read_frame_flush(), is_relative(), update_initial_durations(), and update_initial_timestamps().

#define MAKE_ACCESSORS	(	str,
		name,
		type,
		field
	)

Value:

type av_##name##_get_##field(const str *s) { return s->field; } \

void av_##name##_set_##field(str *s, type v) { s->field = v; }

Definition at line 100 of file utils.c.

#define SANE_CHUNK_SIZE (50000000)

Definition at line 107 of file utils.c.

Referenced by append_packet_chunked().

#define PROBE_BUF_MIN 2048

size of probe buffer, for guessing file type from file contents

Definition at line 316 of file utils.c.

Referenced by av_probe_input_buffer().

#define PROBE_BUF_MAX (1<<20)

Definition at line 317 of file utils.c.

Referenced by av_probe_input_buffer().

#define DURATION_MAX_READ_SIZE 250000LL

Definition at line 2238 of file utils.c.

Referenced by estimate_timings_from_pts().

#define DURATION_MAX_RETRY 4

Definition at line 2239 of file utils.c.

Referenced by estimate_timings_from_pts().

#define FAIL ( errmsg )

Value:

do {                                         \
        if (errmsg_ptr)                                           \
            *errmsg_ptr = errmsg;                                 \
        return 0;                                                 \
    } while (0)

#define PRINT ( ... ) do { if (!f) av_log(avcl, level, __VA_ARGS__); else fprintf(f, __VA_ARGS__); } while(0)

Function Documentation

static int is_relative ( int64_t ts )

static

Definition at line 75 of file utils.c.

Referenced by av_read_frame(), avformat_find_stream_info(), compute_pkt_fields(), ff_add_index_entry(), and update_initial_timestamps().

static int64_t wrap_timestamp	(	AVStream *	st,
		int64_t	timestamp
	)

static

Wrap a given time stamp, if there is an indication for an overflow.

Parameters

st	stream
timestamp	the time stamp to wrap

Returns: resulting time stamp

Definition at line 86 of file utils.c.

Referenced by av_add_index_entry(), ff_read_packet(), ff_read_timestamp(), and update_initial_timestamps().

int ffio_limit	(	AVIOContext *	s,
		int	size
	)

Definition at line 109 of file utils.c.

Referenced by append_packet_chunked(), asf_read_stream_properties(), cin_read_packet(), ebml_parse_elem(), film_read_packet(), rm_assemble_video_frame(), roq_read_packet(), siff_read_packet(), and vmd_read_packet().

static int append_packet_chunked	(	AVIOContext *	s,
		AVPacket *	pkt,
		int	size
	)

static

Definition at line 133 of file utils.c.

Referenced by av_append_packet(), and av_get_packet().

int av_get_packet	(	AVIOContext *	s,
		AVPacket *	pkt,
		int	size
	)

Allocate and read the payload of a packet and initialize its fields with default values.

Parameters

pkt	packet
size	desired payload size

Returns: >0 (read size) if OK, AVERROR_xxx otherwise

Definition at line 176 of file utils.c.

Referenced by adp_read_packet(), adx_read_packet(), aea_read_packet(), afc_read_packet(), aiff_read_packet(), apc_read_packet(), ape_tag_read_field(), asf_read_header(), asf_read_picture(), ast_read_packet(), av_append_packet(), bfi_read_packet(), cdata_read_packet(), cdxl_read_packet(), cin_read_packet(), daud_packet(), dfa_read_packet(), dxa_read_packet(), ea_read_packet(), ff_pcm_read_packet(), ff_rm_parse_packet(), ff_rm_retrieve_cache(), ff_voc_get_packet(), film_read_packet(), flv_data_packet(), flv_read_packet(), fourxm_read_packet(), frm_read_packet(), g729_read_packet(), get_attachment(), gif_read_packet(), gsm_read_packet(), gxf_packet(), idcin_read_packet(), iff_read_packet(), ingenient_read_packet(), iss_read_packet(), lmlm4_read_packet(), load_ipmovie_packet(), lvf_read_packet(), mmf_read_packet(), mov_read_covr(), mov_read_packet(), mp3_read_packet(), mpc8_read_packet(), mpegps_read_packet(), msnwc_tcp_read_packet(), mtv_read_packet(), mv_read_packet(), mxf_decrypt_triplet(), mxf_get_d10_aes3_packet(), mxf_read_packet(), mxf_read_packet_old(), nc_read_packet(), nsv_read_chunk(), nuv_packet(), oma_read_packet(), pmp_packet(), pva_read_packet(), qcp_read_packet(), r3d_read_reda(), r3d_read_redv(), raw_read_packet(), rawvideo_read_packet(), read_packet(), redspark_read_packet(), rl2_read_packet(), roq_read_packet(), rpl_read_packet(), rsd_read_packet(), seq_read_packet(), siff_read_packet(), smjpeg_read_packet(), smush_read_packet(), sol_read_packet(), swf_read_packet(), thp_read_packet(), tmv_read_packet(), tta_read_packet(), txd_read_packet(), vc1t_read_packet(), vid_read_packet(), vivo_read_packet(), wc3_read_packet(), wsaud_read_packet(), wsvqa_read_packet(), xa_read_packet(), xmv_fetch_audio_packet(), xmv_fetch_video_packet(), xwma_read_packet(), yop_read_packet(), and yuv4_read_packet().

int av_append_packet	(	AVIOContext *	s,
		AVPacket *	pkt,
		int	size
	)

Read data and append it to the current content of the AVPacket.

If pkt->size is 0 this is identical to av_get_packet. Note that this uses av_grow_packet and thus involves a realloc which is inefficient. Thus this function should only be used when there is no reasonable way to know (an upper bound of) the final size.

Parameters

pkt	packet
size	amount of data to read

Returns: >0 (read size) if OK, AVERROR_xxx otherwise, previous data will not be lost even if an error occurs.

Definition at line 186 of file utils.c.

Referenced by dfa_read_packet(), ea_read_packet(), read_packet(), vivo_read_packet(), wc3_read_header(), and wc3_read_packet().

static int set_codec_from_probe_data	(	AVFormatContext *	s,
		AVStream *	st,
		AVProbeData *	pd
	)

static

Definition at line 262 of file utils.c.

Referenced by probe_codec().

static int init_input	(	AVFormatContext *	s,
		const char *	filename,
		AVDictionary **	options
	)

static

Definition at line 401 of file utils.c.

Referenced by avformat_open_input().

static AVPacket* add_to_pktbuf	(	AVPacketList **	packet_buffer,
		AVPacket *	pkt,
		AVPacketList **	plast_pktl
	)

static

Definition at line 429 of file utils.c.

Referenced by av_read_frame(), avformat_find_stream_info(), avformat_queue_attached_pictures(), ff_read_packet(), and parse_packet().

static void force_codec_ids	(	AVFormatContext *	s,
		AVStream *	st
	)

static

Definition at line 558 of file utils.c.

Referenced by ff_read_packet(), and probe_codec().

static void probe_codec	(	AVFormatContext *	s,
		AVStream *	st,
		const AVPacket *	pkt
	)

static

Definition at line 573 of file utils.c.

Referenced by ff_read_packet().

int ff_read_packet	(	AVFormatContext *	s,
		AVPacket *	pkt
	)

Read a transport packet from a media file.

Parameters

s	media file handle
pkt	is filled

Returns: 0 if OK, AVERROR_xxx on error

Definition at line 618 of file utils.c.

Referenced by asfrtp_parse_packet(), estimate_timings_from_pts(), get_subtitle_pkt(), read_frame_internal(), read_gab2_sub(), and seek_subtitle().

static int determinable_frame_size ( AVCodecContext * avctx )

static

Definition at line 703 of file utils.c.

Referenced by has_codec_parameters().

int ff_get_audio_frame_size	(	AVCodecContext *	enc,
		int	size,
		int	mux
	)

Get the number of samples of an audio frame.

Return -1 on error.

Definition at line 717 of file utils.c.

Referenced by compute_pkt_fields2(), and ff_compute_frame_duration().

void ff_compute_frame_duration	(	int *	pnum,
		int *	pden,
		AVStream *	st,
		AVCodecParserContext *	pc,
		AVPacket *	pkt
	)

Return the frame duration in seconds.

Return 0 if not available.

Definition at line 746 of file utils.c.

Referenced by compute_pkt_fields(), and compute_pkt_fields2().

static int is_intra_only ( AVCodecContext * enc )

static

Definition at line 789 of file utils.c.

Referenced by compute_pkt_fields().

static int has_decode_delay_been_guessed ( AVStream * st )

static

Definition at line 805 of file utils.c.

Referenced by compute_pkt_fields(), try_decode_frame(), and update_initial_timestamps().

static AVPacketList* get_next_pkt	(	AVFormatContext *	s,
		AVStream *	st,
		AVPacketList *	pktl
	)

static

Definition at line 823 of file utils.c.

Referenced by update_initial_durations(), and update_initial_timestamps().

static int update_wrap_reference	(	AVFormatContext *	s,
		AVStream *	st,
		int	stream_index
	)

static

Definition at line 832 of file utils.c.

Referenced by update_initial_timestamps().

static void update_initial_timestamps	(	AVFormatContext *	s,
		int	stream_index,
		int64_t	dts,
		int64_t	pts,
		AVPacket *	pkt
	)

static

Definition at line 891 of file utils.c.

Referenced by compute_pkt_fields().

static void update_initial_durations	(	AVFormatContext *	s,
		AVStream *	st,
		int	stream_index,
		int	duration
	)

static

Definition at line 948 of file utils.c.

Referenced by compute_pkt_fields().

static void compute_pkt_fields	(	AVFormatContext *	s,
		AVStream *	st,
		AVCodecParserContext *	pc,
		AVPacket *	pkt
	)

static

Definition at line 994 of file utils.c.

Referenced by parse_packet(), and read_frame_internal().

static void free_packet_buffer	(	AVPacketList **	pkt_buf,
		AVPacketList **	pkt_buf_end
	)

static

Definition at line 1144 of file utils.c.

Referenced by flush_packet_queue().

static int parse_packet	(	AVFormatContext *	s,
		AVPacket *	pkt,
		int	stream_index
	)

static

Parse a packet, add all split parts to parse_queue.

Parameters

pkt	packet to parse, NULL when flushing the parser at end of stream

Definition at line 1160 of file utils.c.

Referenced by read_frame_internal().

static int read_from_packet_buffer	(	AVPacketList **	pkt_buffer,
		AVPacketList **	pkt_buffer_end,
		AVPacket *	pkt
	)

static

Definition at line 1268 of file utils.c.

Referenced by av_read_frame(), and read_frame_internal().

static int read_frame_internal	(	AVFormatContext *	s,
		AVPacket *	pkt
	)

static

Definition at line 1283 of file utils.c.

Referenced by av_read_frame(), and avformat_find_stream_info().

static void flush_packet_queue ( AVFormatContext * s )

static

Definition at line 1487 of file utils.c.

Referenced by avformat_close_input(), estimate_timings_from_pts(), and ff_read_frame_flush().

void ff_read_frame_flush ( AVFormatContext * s )

Flush the frame reader.

Definition at line 1522 of file utils.c.

Referenced by avformat_seek_file(), ff_restore_parser_state(), ff_seek_frame_binary(), mpegts_get_dts(), search_hi_lo_keyframes(), seek_frame_generic(), and seek_frame_internal().

void ff_update_cur_dts	(	AVFormatContext *	s,
		AVStream *	ref_st,
		int64_t	timestamp
	)

Update cur_dts of all streams based on the given timestamp and AVStream.

Stream ref_st unchanged, others set cur_dts in their native time base. Only needed for timestamp wrapping or if (dts not set and pts!=dts).

Parameters

timestamp	new dts expressed in time_base of param ref_st
ref_st	reference stream giving time_base of param timestamp

Definition at line 1549 of file utils.c.

Referenced by ff_seek_frame_binary(), idcin_read_seek(), matroska_read_seek(), mp3_seek(), mpc8_read_seek(), mxf_read_seek(), and seek_frame_generic().

void ff_reduce_index	(	AVFormatContext *	s,
		int	stream_index
	)

Ensure the index uses less memory than the maximum specified in AVFormatContext.max_index_size by discarding entries if it grows too large.

Definition at line 1562 of file utils.c.

Referenced by av_read_frame(), mpegps_read_pes_header(), mpegts_get_dts(), and read_frame_internal().

int ff_add_index_entry	(	AVIndexEntry **	index_entries,
		int *	nb_index_entries,
		unsigned int *	index_entries_allocated_size,
		int64_t	pos,
		int64_t	timestamp,
		int	size,
		int	distance,
		int	flags
	)

Internal version of av_add_index_entry.

Definition at line 1575 of file utils.c.

Referenced by av_add_index_entry(), and read_header().

int ff_index_search_timestamp	(	const AVIndexEntry *	entries,
		int	nb_entries,
		int64_t	wanted_timestamp,
		int	flags
	)

Internal version of av_index_search_timestamp.

Definition at line 1636 of file utils.c.

Referenced by av_index_search_timestamp(), ff_add_index_entry(), mxf_read_seek(), and read_seek().

static int64_t ff_read_timestamp	(	AVFormatContext *	s,
		int	stream_index,
		int64_t *	ppos,
		int64_t	pos_limit,
		int64_t()(struct AVFormatContext , int, int64_t *, int64_t)	read_timestamp
	)

static

Definition at line 1677 of file utils.c.

Referenced by ff_find_last_ts(), and ff_gen_search().

int ff_seek_frame_binary	(	AVFormatContext *	s,
		int	stream_index,
		int64_t	target_ts,
		int	flags
	)

Perform a binary search using av_index_search_timestamp() and AVInputFormat.read_timestamp().

Parameters

target_ts	target timestamp in the time base of the given stream
stream_index	stream number

Definition at line 1686 of file utils.c.

Referenced by asf_read_seek(), ogg_read_seek(), rm_read_seek(), and seek_frame_internal().

int ff_find_last_ts	(	AVFormatContext *	s,
		int	stream_index,
		int64_t *	ts,
		int64_t *	pos,
		int64_t()(struct AVFormatContext , int, int64_t *, int64_t)	read_timestamp
	)

Definition at line 1748 of file utils.c.

Referenced by ff_gen_search(), and find_duration().

int64_t ff_gen_search	(	AVFormatContext *	s,
		int	stream_index,
		int64_t	target_ts,
		int64_t	pos_min,
		int64_t	pos_max,
		int64_t	pos_limit,
		int64_t	ts_min,
		int64_t	ts_max,
		int	flags,
		int64_t *	ts_ret,
		int64_t()(struct AVFormatContext , int, int64_t *, int64_t)	read_timestamp
	)

Perform a binary search using read_timestamp().

Parameters

target_ts	target timestamp in the time base of the given stream
stream_index	stream number

Definition at line 1783 of file utils.c.

Referenced by ff_seek_frame_binary(), and read_seek().

static int seek_frame_byte	(	AVFormatContext *	s,
		int	stream_index,
		int64_t	pos,
		int	flags
	)

static

Definition at line 1888 of file utils.c.

Referenced by seek_frame_internal().

static int seek_frame_generic	(	AVFormatContext *	s,
		int	stream_index,
		int64_t	timestamp,
		int	flags
	)

static

Definition at line 1904 of file utils.c.

Referenced by seek_frame_internal().

static int seek_frame_internal	(	AVFormatContext *	s,
		int	stream_index,
		int64_t	timestamp,
		int	flags
	)

static

Definition at line 1968 of file utils.c.

Referenced by av_seek_frame().

static int has_duration ( AVFormatContext * ic )

static

Return TRUE if the stream has accurate duration in any stream.

Returns: TRUE if the stream has accurate duration for at least one component.

Definition at line 2095 of file utils.c.

Referenced by estimate_timings().

static void update_stream_timings ( AVFormatContext * ic )

static

Estimate the stream timings from the one of each components.

Also computes the global bitrate if possible.

Definition at line 2115 of file utils.c.

Referenced by estimate_timings(), and fill_all_stream_timings().

static void fill_all_stream_timings ( AVFormatContext * ic )

static

Definition at line 2184 of file utils.c.

Referenced by estimate_timings(), and estimate_timings_from_pts().

static void estimate_timings_from_bit_rate ( AVFormatContext * ic )

static

Definition at line 2201 of file utils.c.

Referenced by estimate_timings().

static void estimate_timings_from_pts	(	AVFormatContext *	ic,
		int64_t	old_offset
	)

static

Definition at line 2242 of file utils.c.

Referenced by estimate_timings().

static void estimate_timings	(	AVFormatContext *	ic,
		int64_t	old_offset
	)

static

Definition at line 2319 of file utils.c.

Referenced by avformat_find_stream_info().

static int has_codec_parameters	(	AVStream *	st,
		const char **	errmsg_ptr
	)

static

Definition at line 2365 of file utils.c.

Referenced by avformat_find_stream_info(), and try_decode_frame().

static int try_decode_frame	(	AVStream *	st,
		AVPacket *	avpkt,
		AVDictionary **	options
	)

static

Definition at line 2411 of file utils.c.

Referenced by avformat_find_stream_info().

unsigned int ff_codec_get_tag	(	const AVCodecTag *	tags,
		enum AVCodecID	id
	)

Definition at line 2493 of file utils.c.

Referenced by ast_write_header(), caf_write_header(), gxf_write_header(), ipod_get_codec_tag(), ircam_write_header(), mkv_write_codecprivate(), mkv_write_tracks(), mov_find_codec_tag(), mov_get_codec_tag(), mov_write_esds_tag(), mov_write_isml_manifest(), mp4_get_codec_tag(), smjpeg_write_header(), and swf_write_video().

enum AVCodecID ff_codec_get_id	(	const AVCodecTag *	tags,
		unsigned int	tag
	)

enum AVCodecID ff_get_pcm_codec_id	(	int	bps,
		int	flt,
		int	be,
		int	sflags
	)

Select a PCM codec based on the given parameters.

Parameters

bps	bits-per-sample
flt	floating-point
be	big-endian
sflags	signed flags. each bit corresponds to one byte of bit depth. e.g. the 1st bit indicates if 8-bit should be signed or unsigned, the 2nd bit indicates if 16-bit should be signed or unsigned, etc... This is useful for formats such as WAVE where only 8-bit is unsigned and all other bit depths are signed.

Returns: a PCM codec id or AV_CODEC_ID_NONE

Definition at line 2517 of file utils.c.

Referenced by ff_mov_get_lpcm_codec_id(), get_codec_data(), nist_read_header(), and pvf_read_header().

unsigned int av_codec_get_tag	(	const AVCodecTag const	tags,
		enum AVCodecID	id
	)

Definition at line 2548 of file utils.c.

int av_codec_get_tag2	(	const AVCodecTag const	tags,
		enum AVCodecID	id,
		unsigned int *	tag
	)

Definition at line 2556 of file utils.c.

enum AVCodecID av_codec_get_id	(	const AVCodecTag const	tags,
		unsigned int	tag
	)

Definition at line 2573 of file utils.c.

static void compute_chapters_end ( AVFormatContext * s )

static

Definition at line 2583 of file utils.c.

Referenced by avformat_find_stream_info().

static int get_std_framerate ( int i )

static

Definition at line 2604 of file utils.c.

Referenced by avformat_find_stream_info().

static int tb_unreliable ( AVCodecContext * c )

static

Definition at line 2617 of file utils.c.

Referenced by avformat_find_stream_info().

void ff_free_stream	(	AVFormatContext *	s,
		AVStream *	st
	)

Definition at line 3168 of file utils.c.

Referenced by avformat_free_context(), and ff_rm_read_mdpr_codecdata().

AVChapter* avpriv_new_chapter	(	AVFormatContext *	s,
		int	id,
		AVRational	time_base,
		int64_t	start,
		int64_t	end,
		const char *	title
	)

Add a new chapter.

Parameters

s	media file handle
id	unique ID for this chapter
start	chapter start time in time_base units
end	chapter end time in time_base units
title	chapter title

Returns: AVChapter or NULL on error

Definition at line 3348 of file utils.c.

Referenced by asf_read_marker(), decode_info_header(), flac_read_header(), matroska_read_header(), mov_read_chapters(), mov_read_chpl(), ogm_chapter(), read_chapter(), and read_header().

void ff_program_add_stream_index	(	AVFormatContext *	ac,
		int	progid,
		unsigned int	idx
	)

Definition at line 3372 of file utils.c.

Referenced by hls_read_header(), and pmt_cb().

static void print_fps	(	double	d,
		const char *	postfix
	)

static

Definition at line 3400 of file utils.c.

Referenced by dump_stream_format().

static void dump_metadata	(	void *	ctx,
		AVDictionary *	m,
		const char *	indent
	)

static

Definition at line 3407 of file utils.c.

Referenced by av_dump_format(), and dump_stream_format().

static void dump_stream_format	(	AVFormatContext *	ic,
		int	i,
		int	index,
		int	is_output
	)

static

Definition at line 3434 of file utils.c.

Referenced by av_dump_format().

uint64_t ff_ntp_time ( void )

Get the current time since NTP epoch in microseconds.

Definition at line 3578 of file utils.c.

Referenced by rtp_write_header(), and rtp_write_packet().

static void hex_dump_internal	(	void *	avcl,
		FILE *	f,
		int	level,
		const uint8_t *	buf,
		int	size
	)

static

Definition at line 3638 of file utils.c.

Referenced by av_hex_dump(), and av_hex_dump_log().

static void pkt_dump_internal	(	void *	avcl,
		FILE *	f,
		int	level,
		AVPacket *	pkt,
		int	dump_payload,
		AVRational	time_base
	)

static

Definition at line 3677 of file utils.c.

Referenced by av_pkt_dump2(), and av_pkt_dump_log2().

char* ff_data_to_hex	(	char *	buff,
		const uint8_t *	src,
		int	s,
		int	lowercase
	)

Definition at line 3794 of file utils.c.

Referenced by do_llnw_auth(), ff_rdt_calc_response_and_checksum(), hex_log(), make_digest_auth(), open_input(), and param_write_hex().

int ff_hex_to_data	(	uint8_t *	data,
		const char *	p
	)

Parse a string of hexadecimal strings.

Any space between the hexadecimal digits is ignored.

Parameters

data	if non-null, the parsed data is written to this pointer
p	the string to parse

Returns: the number of bytes written (or to be written, if data is null)

Definition at line 3815 of file utils.c.

Referenced by parse_fmtp_config(), and parse_playlist().

void avpriv_set_pts_info	(	AVStream *	s,
		int	pts_wrap_bits,
		unsigned int	pts_num,
		unsigned int	pts_den
	)

Set the time base and wrapping info for a given stream.

This will be used to interpret the stream's timestamps. If the new time base is invalid (numerator or denominator are non-positive), it leaves the stream unchanged.

Parameters

s	stream
pts_wrap_bits	number of bits effectively used by the pts (used for wrap control)
pts_num	time base numerator
pts_den	time base denominator

Definition at line 3851 of file utils.c.

Referenced by add_av_stream1(), adp_read_header(), adts_aac_read_header(), adx_read_header(), afc_read_header(), aiff_read_header(), aiff_write_header(), amr_read_header(), ape_read_header(), aqt_read_header(), asf_read_stream_properties(), asf_write_header1(), asfrtp_parse_sdp_line(), ass_read_header(), ast_read_header(), audio_read_header(), audio_write_header(), avformat_new_stream(), avi_read_header(), avi_write_header(), avr_read_header(), bfi_read_header(), bmv_read_header(), cdata_read_header(), cdxl_read_packet(), celt_header(), cin_read_header(), create_audio_stream(), create_new_audio_stream(), create_stream(), dc1394_read_common(), decode_stream_header(), dfa_read_header(), dirac_header(), dshow_add_device(), dv_extract_audio_info(), dv_extract_video_info(), dxa_read_header(), ea_read_header(), epaf_read_header(), fbdev_read_header(), ff_framehash_write_header(), ff_raw_video_read_header(), ff_rm_read_mdpr_codecdata(), ff_voc_get_packet(), ffm2_read_header(), ffm_read_header(), ffm_write_header(), film_read_header(), flac_header(), flac_read_header(), flv_write_header(), g722_read_header(), g723_1_init(), g729_read_header(), get_packet_header(), gif_read_header(), gif_write_header(), grab_read_header(), gsm_read_header(), gxf_header(), gxf_write_header(), hls_read_header(), idcin_read_header(), iff_read_header(), ilbc_read_header(), img_read_header(), init_stream(), ipmovie_read_header(), ircam_read_header(), iss_read_header(), jacosub_read_header(), lavfi_read_header(), libquvi_read_header(), lmlm4_read_header(), loas_read_header(), lvf_read_header(), lxf_read_header(), matroska_read_header(), microdvd_read_header(), microdvd_write_header(), mkv_write_tracks(), mmf_read_header(), modplug_read_header(), mov_read_trak(), mov_write_header(), mp3_read_header(), mpc8_read_header(), mpc_read_header(), mpeg_mux_init(), mpegts_read_header(), mpegts_set_stream_info(), mpegts_write_header(), mpl2_read_header(), mpsub_read_header(), msnwc_tcp_read_header(), mtv_read_header(), mv_read_header(), mxf_parse_structural_metadata(), mxf_write_header(), mxg_read_header(), nc_read_header(), new_stream(), nist_read_header(), nsv_parse_NSVs_header(), nut_read_header(), nut_write_header(), nuv_header(), ogg_new_stream(), ogg_write_header(), ogm_dshow_header(), ogm_header(), old_dirac_header(), oma_read_header(), opus_header(), parse_audio_var(), parse_strk(), parse_video_var(), parse_vtrk(), pcm_read_header(), pjs_read_header(), pmp_header(), pulse_read_header(), pva_read_header(), pvf_read_header(), qt_rtp_parse_packet(), r3d_read_red1(), rawvideo_read_header(), read_frame(), read_gab2_sub(), read_header(), read_header_gme(), read_sl_header(), realtext_read_header(), redspark_read_header(), rl2_read_header(), roq_read_packet(), rpl_read_header(), rsd_read_header(), rso_read_header(), sami_read_header(), sbg_read_header(), seq_read_header(), siff_parse_vbv1(), skeleton_header(), smacker_read_header(), smjpeg_read_header(), smjpeg_write_header(), smush_read_header(), sol_read_header(), sox_read_header(), speex_header(), srt_read_header(), srt_write_header(), str_read_packet(), subviewer1_read_header(), subviewer_read_header(), swf_read_packet(), tak_read_header(), tedcaptions_read_header(), theora_header(), thp_read_header(), tmv_read_header(), tta_read_header(), v4l2_read_header(), vc1t_read_header(), vc1test_write_header(), vfw_read_header(), vid_read_packet(), vivo_read_header(), vmd_read_header(), vorbis_header(), vplayer_read_header(), vqf_read_header(), wc3_read_header(), webvtt_read_header(), webvtt_write_header(), write_header(), write_stream_data(), wsaud_read_header(), wsvqa_read_header(), wsvqa_read_packet(), wv_read_header(), x11grab_read_header(), xa_read_header(), xmv_read_header(), xwma_read_header(), yop_read_header(), and yuv4_read_header().

void ff_parse_key_value	(	const char *	str,
		ff_parse_key_val_cb	callback_get_buf,
		void *	context
	)

Parse a string with comma-separated key=value pairs.

The value strings may be quoted and may contain escaped characters within quoted strings.

Parameters

str	the string to parse
callback_get_buf	function that returns where to store the unescaped value string.
context	the opaque context pointer to pass to callback_get_buf

Definition at line 3870 of file utils.c.

Referenced by ff_http_auth_handle_header(), and parse_playlist().