utils.c File Reference

Go to the source code of this file.

Functions

static void av_frac_init (AVFrac *f, int64_t val, int64_t num, int64_t den)
 f = val + (num / den) + 0.5.
static void av_frac_add (AVFrac *f, int64_t incr)
 Fractionnal addition to f: f = f + (incr / f->den).
void av_register_input_format (AVInputFormat *format)
 Add input format to linked list of registered input formats.
void av_register_output_format (AVOutputFormat *format)
 Add output format to linked list of registered input formats.
int match_ext (const char *filename, const char *extensions)
 Match an extension to a filename with extension.
AVOutputFormatguess_format (const char *short_name, const char *filename, const char *mime_type)
 Guesses video format based on file name, file extension, and mime type.
AVOutputFormatguess_stream_format (const char *short_name, const char *filename, const char *mime_type)
 Guesses video format based on input format short name, file name, file extension, and mime type.
enum CodecID av_guess_codec (AVOutputFormat *fmt, const char *short_name, const char *filename, const char *mime_type, enum CodecType type)
 Guesses the codec id based upon muxer and filename.
AVInputFormatav_find_input_format (const char *short_name)
 finds AVInputFormat based on input format's short name.
void av_destruct_packet (AVPacket *pkt)
 Default packet destructor.
void av_init_packet (AVPacket *pkt)
 Initialize optional fields of a packet to default values.
int av_new_packet (AVPacket *pkt, int size)
 Allocate the payload of a packet and initialize its fields to default values.
int av_get_packet (ByteIOContext *s, AVPacket *pkt, int size)
 Allocate and read the payload of a packet and initialize its fields to default values.
int av_dup_packet (AVPacket *pkt)
int av_filename_number_test (const char *filename)
 Check whether filename actually is a numbered sequence generator.
static AVInputFormatav_probe_input_format2 (AVProbeData *pd, int is_opened, int *score_max)
AVInputFormatav_probe_input_format (AVProbeData *pd, int is_opened)
 Guess file format.
static const char * format_to_name (void *ptr)
 Open a media file from an IO stream.
static void avformat_get_context_defaults (AVFormatContext *s)
AVFormatContextav_alloc_format_context (void)
 Allocates an AVFormatContext.
int av_open_input_stream (AVFormatContext **ic_ptr, ByteIOContext *pb, const char *filename, AVInputFormat *fmt, AVFormatParameters *ap)
 Allocates all the structures needed to read an input stream.
int av_open_input_file (AVFormatContext **ic_ptr, const char *filename, AVInputFormat *fmt, int buf_size, AVFormatParameters *ap)
 Open a media file as input.
int av_read_packet (AVFormatContext *s, AVPacket *pkt)
 Read a transport packet from a media file.
static int get_audio_frame_size (AVCodecContext *enc, int size)
 Get the number of samples of an audio frame.
static void compute_frame_duration (int *pnum, int *pden, AVStream *st, AVCodecParserContext *pc, AVPacket *pkt)
 Return the frame duration in seconds, return 0 if not available.
static int is_intra_only (AVCodecContext *enc)
static void update_initial_timestamps (AVFormatContext *s, int stream_index, int64_t dts, int64_t pts)
static void compute_pkt_fields (AVFormatContext *s, AVStream *st, AVCodecParserContext *pc, AVPacket *pkt)
void av_destruct_packet_nofree (AVPacket *pkt)
 Simply sets data pointer to null.
static int av_read_frame_internal (AVFormatContext *s, AVPacket *pkt)
static AVPacketadd_to_pktbuf (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)
 Finds the index of the first video stream within the AVFormatContext.
void av_read_frame_flush (AVFormatContext *s)
 Flush the frame reader.
void av_update_cur_dts (AVFormatContext *s, AVStream *ref_st, int64_t timestamp)
 Updates cur_dts of all streams based on given timestamp and AVStream.
int av_add_index_entry (AVStream *st, int64_t pos, int64_t timestamp, int size, int distance, int flags)
 Add a index entry into a sorted list updateing if it is already there.
int av_index_search_timestamp (AVStream *st, int64_t wanted_timestamp, int flags)
 Gets the index for a specific timestamp.
int av_seek_frame_binary (AVFormatContext *s, int stream_index, int64_t target_ts, int flags)
 Does a binary search using av_index_search_timestamp() and AVCodec.read_timestamp().
int64_t av_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))
 Does a binary search using read_timestamp().
static int av_seek_frame_byte (AVFormatContext *s, int stream_index, int64_t pos, int flags)
static int av_seek_frame_generic (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 key frame at timestamp.
static int av_has_duration (AVFormatContext *ic)
 Returns TRUE if the stream has accurate duration in any stream.
static void av_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 av_estimate_timings_from_bit_rate (AVFormatContext *ic)
static void av_estimate_timings_from_pts (AVFormatContext *ic, offset_t old_offset)
 Estimates timings using PTS stream.
void av_estimate_timings (AVFormatContext *ic, offset_t old_offset)
 Attempts to estimate timings using whatever means possible.
static int has_codec_parameters (AVCodecContext *enc)
static int try_decode_frame (AVStream *st, const uint8_t *data, int size)
static int set_codec_from_probe_data (AVStream *st, AVProbeData *pd, int score)
unsigned int codec_get_tag (const AVCodecTag *tags, int id)
enum CodecID codec_get_id (const AVCodecTag *tags, unsigned int tag)
unsigned int av_codec_get_tag (const AVCodecTag *tags[4], enum CodecID id)
enum CodecID av_codec_get_id (const AVCodecTag *tags[4], unsigned int tag)
static int get_std_framerate (int i)
int av_find_stream_info (AVFormatContext *ic)
 Read packets of a media file to get stream information.
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 av_close_input_file (AVFormatContext *s)
 Close a media file (but not its codecs).
AVStreamav_new_stream (AVFormatContext *s, int id)
 Add a new stream to a media file.
AVStreamav_add_stream (AVFormatContext *s, AVStream *st, int id)
 Add a stream to an MPEG media stream.
AVProgramav_new_program (AVFormatContext *ac, int id)
void av_set_program_name (AVProgram *program, char *provider_name, char *name)
void av_remove_stream (AVFormatContext *s, int id, int remove_ts)
 Remove a stream from a media stream.
int av_set_parameters (AVFormatContext *s, AVFormatParameters *ap)
 media file output
int av_write_header (AVFormatContext *s)
 Allocate the stream private data and write the stream header to an output media file.
static int compute_pkt_fields2 (AVStream *st, AVPacket *pkt)
static void truncate_ts (AVStream *st, AVPacket *pkt)
int av_write_frame (AVFormatContext *s, AVPacket *pkt)
 Write a packet to an output media file.
int av_interleave_packet_per_dts (AVFormatContext *s, AVPacket *out, AVPacket *pkt, int flush)
 Interleave a packet per DTS in an output media file.
static int av_interleave_packet (AVFormatContext *s, AVPacket *out, AVPacket *in, int flush)
 Interleaves a AVPacket correctly so it can be muxed.
int av_interleaved_write_frame (AVFormatContext *s, AVPacket *pkt)
 Writes a packet to an output media file ensuring correct interleaving.
int av_write_trailer (AVFormatContext *s)
 Write the stream trailer to an output media file and free the file private data.
void av_program_add_stream_index (AVFormatContext *ac, int progid, unsigned int idx)
static void dump_stream_format (AVFormatContext *ic, int i, int index, int is_output)
void dump_format (AVFormatContext *ic, int index, const char *url, int is_output)
int parse_image_size (int *width_ptr, int *height_ptr, const char *str)
 parses width and height out of string str.
int parse_frame_rate (int *frame_rate_num, int *frame_rate_den, const char *arg)
 Converts frame rate from string to a fraction.
int64_t av_gettime (void)
 gets the current time in micro seconds.
int64_t parse_date (const char *datestr, int duration)
 Parses datestr and returns a corresponding number of microseconds.
int find_info_tag (char *arg, int arg_size, const char *tag1, const char *info)
 Attempts to find a specific tag in a URL.
int av_get_frame_filename (char *buf, int buf_size, const char *path, int number)
 Returns in 'buf' the path with 'd' replaced by number.
static void hex_dump_internal (void *avcl, FILE *f, int level, uint8_t *buf, int size)
void av_hex_dump (FILE *f, 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, 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)
void av_pkt_dump (FILE *f, AVPacket *pkt, int dump_payload)
 Send a nice dump of a packet to the specified file stream.
void av_pkt_dump_log (void *avcl, int level, AVPacket *pkt, int dump_payload)
 Send a nice dump of a packet to the log.
void 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)
void av_set_pts_info (AVStream *s, int pts_wrap_bits, int pts_num, int pts_den)
 Set the pts for a given stream.

Variables

AVInputFormatfirst_iformat = NULL
 head of registered input format linked list.
AVOutputFormatfirst_oformat = NULL
 head of registered output format linked list.
static const AVOption options []
static const AVClass av_format_context_class = { "AVFormatContext", format_to_name, options }


Function Documentation

static void av_frac_init ( AVFrac f,
int64_t  val,
int64_t  num,
int64_t  den 
) [static]

f = val + (num / den) + 0.5.

'num' is normalized so that it is such as 0 <= num < den.

Parameters:
f fractional number
val integer value
num must be >= 0
den must be >= 1

Definition at line 3199 of file libavformat/utils.c.

Referenced by av_write_header().

static void av_frac_add ( AVFrac f,
int64_t  incr 
) [static]

Fractionnal addition to f: f = f + (incr / f->den).

Parameters:
f fractional number
incr increment, can be positive or negative

Definition at line 3217 of file libavformat/utils.c.

Referenced by compute_pkt_fields2().

void av_register_input_format ( AVInputFormat format  ) 

Add input format to linked list of registered input formats.

Parameters:
format Input format descriptor

Definition at line 54 of file libavformat/utils.c.

Referenced by audio_init().

void av_register_output_format ( AVOutputFormat format  ) 

Add output format to linked list of registered input formats.

Parameters:
format Output format descriptor

Definition at line 67 of file libavformat/utils.c.

Referenced by audio_init().

int match_ext ( const char *  filename,
const char *  extensions 
)

Match an extension to a filename with extension.

Parameters:
filename File name to match to an extension
extensions File extension to look for

Definition at line 81 of file libavformat/utils.c.

Referenced by av_probe_input_format2(), guess_format(), mpegts_probe(), nsv_probe(), and pgmyuv_probe().

AVOutputFormat* guess_format ( const char *  short_name,
const char *  filename,
const char *  mime_type 
)

Guesses video format based on file name, file extension, and mime type.

Definition at line 112 of file libavformat/utils.c.

Referenced by guess_format(), guess_stream_format(), and avfDecoder::initialize().

AVOutputFormat* guess_stream_format ( const char *  short_name,
const char *  filename,
const char *  mime_type 
)

Guesses video format based on input format short name, file name, file extension, and mime type.

Definition at line 153 of file libavformat/utils.c.

enum CodecID av_guess_codec ( AVOutputFormat fmt,
const char *  short_name,
const char *  filename,
const char *  mime_type,
enum CodecType  type 
)

Guesses the codec id based upon muxer and filename.

Definition at line 172 of file libavformat/utils.c.

AVInputFormat* av_find_input_format ( const char *  short_name  ) 

finds AVInputFormat based on input format's short name.

Definition at line 191 of file libavformat/utils.c.

Referenced by getFileInfo(), and MPEG2fixup::InitAV().

void av_destruct_packet ( AVPacket pkt  ) 

Default packet destructor.

Definition at line 203 of file libavformat/utils.c.

Referenced by av_dup_packet(), av_interleave_packet_per_dts(), and av_new_packet().

void av_init_packet ( AVPacket pkt  ) 

int av_new_packet ( AVPacket pkt,
int  size 
)

int av_get_packet ( ByteIOContext s,
AVPacket pkt,
int  size 
)

int av_dup_packet ( AVPacket pkt  ) 

Warning:
This is a hack - the packet memory allocation stuff is broken. The packet is allocated if it was not really allocated

Definition at line 256 of file libavformat/utils.c.

Referenced by av_find_stream_info(), av_interleave_packet_per_dts(), av_read_frame(), and AvFormatDecoder::GetFrame().

int av_filename_number_test ( const char *  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 276 of file libavformat/utils.c.

Referenced by av_open_input_file(), guess_format(), and image_probe().

static AVInputFormat* av_probe_input_format2 ( AVProbeData pd,
int  is_opened,
int *  score_max 
) [static]

AVInputFormat* av_probe_input_format ( AVProbeData pd,
int  is_opened 
)

Guess file format.

Parameters:
is_opened whether the file is already opened, determines whether demuxers with or without AVFMT_NOFILE are probed

Definition at line 307 of file libavformat/utils.c.

Referenced by av_open_input_file(), IvtvDecoder::CanHandle(), AvFormatDecoder::CanHandle(), and AvFormatDecoder::OpenFile().

static const char* format_to_name ( void *  ptr  )  [static]

Open a media file from an IO stream.

'fmt' must be specified.

Definition at line 318 of file libavformat/utils.c.

static void avformat_get_context_defaults ( AVFormatContext s  )  [static]

Definition at line 351 of file libavformat/utils.c.

Referenced by av_alloc_format_context().

AVFormatContext* av_alloc_format_context ( void   ) 

Allocates an AVFormatContext.

no av_open for output, so applications will need this:

Definition at line 363 of file libavformat/utils.c.

Referenced by av_open_input_stream(), mov_read_stsd(), AvFormatDecoder::OpenFile(), and AvFormatDecoder::Reset().

int av_open_input_stream ( AVFormatContext **  ic_ptr,
ByteIOContext pb,
const char *  filename,
AVInputFormat fmt,
AVFormatParameters ap 
)

Allocates all the structures needed to read an input stream.

This does not open the needed codecs for decoding the stream[s].

Definition at line 373 of file libavformat/utils.c.

Referenced by av_open_input_file().

int av_open_input_file ( AVFormatContext **  ic_ptr,
const char *  filename,
AVInputFormat fmt,
int  buf_size,
AVFormatParameters ap 
)

Open a media file as input.

The codecs are not opened. Only the file header (if present) is read.

Parameters:
ic_ptr the opened media file handle is put here
filename filename to open.
fmt if non NULL, force the file format to use
buf_size optional buffer size (zero if default is OK)
ap additional parameters needed when opening the file (NULL if default)
Returns:
0 if OK. AVERROR_xxx otherwise.

Definition at line 439 of file libavformat/utils.c.

Referenced by getFileInfo(), MetaIOAVFComment::getTrackLength(), grabThumbnail(), MPEG2fixup::InitAV(), ThumbFinder::initAVCodec(), avfDecoder::initialize(), AvFormatDecoder::OpenFile(), MetaIOAVFComment::read(), redir_open(), and AvFormatDecoder::Reset().

int av_read_packet ( AVFormatContext s,
AVPacket pkt 
)

Read a transport packet from a media file.

This function is obsolete and should never be used. Use av_read_frame() instead.

Parameters:
s media file handle
pkt is filled
Returns:
0 if OK. AVERROR_xxx if error.

Definition at line 536 of file libavformat/utils.c.

Referenced by av_estimate_timings_from_pts(), and av_read_frame_internal().

static int get_audio_frame_size ( AVCodecContext enc,
int  size 
) [static]

Get the number of samples of an audio frame.

Return (-1) if error.

Definition at line 549 of file libavformat/utils.c.

Referenced by compute_frame_duration(), and compute_pkt_fields2().

static void compute_frame_duration ( int *  pnum,
int *  pden,
AVStream st,
AVCodecParserContext pc,
AVPacket pkt 
) [static]

Return the frame duration in seconds, return 0 if not available.

Definition at line 576 of file libavformat/utils.c.

Referenced by compute_pkt_fields(), and compute_pkt_fields2().

static int is_intra_only ( AVCodecContext enc  )  [static]

Definition at line 613 of file libavformat/utils.c.

Referenced by compute_pkt_fields().

static void update_initial_timestamps ( AVFormatContext s,
int  stream_index,
int64_t  dts,
int64_t  pts 
) [static]

Definition at line 635 of file libavformat/utils.c.

Referenced by compute_pkt_fields().

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

Definition at line 664 of file libavformat/utils.c.

Referenced by av_read_frame_internal().

void av_destruct_packet_nofree ( AVPacket pkt  ) 

Simply sets data pointer to null.

This will leak memory if no one else frees the memory used by the packet.

Definition at line 783 of file libavformat/utils.c.

Referenced by av_init_packet(), and av_read_frame_internal().

static int av_read_frame_internal ( AVFormatContext s,
AVPacket pkt 
) [static]

Definition at line 788 of file libavformat/utils.c.

Referenced by av_find_stream_info(), and av_read_frame().

static AVPacket* add_to_pktbuf ( AVFormatContext s,
AVPacket pkt 
) [static]

Definition at line 909 of file libavformat/utils.c.

Referenced by av_find_stream_info(), and av_read_frame().

int av_read_frame ( AVFormatContext s,
AVPacket pkt 
)

Return the next frame of a stream.

The returned packet is valid until the next av_read_frame() or until av_close_input_file() and must be freed with av_free_packet. For video, the packet contains exactly one frame. For audio, it contains an integer number of frames if each frame has a known fixed size (e.g. PCM or ADPCM data). If the audio frames have a variable size (e.g. MPEG audio), then it contains one frame.

pkt->pts, pkt->dts and pkt->duration are always set to correct values in AVStream.timebase units (and guessed if the format cannot provided them). pkt->pts can be AV_NOPTS_VALUE if the video format has B frames, so it is better to rely on pkt->dts if you do not decompress the payload.

Returns:
0 if OK, < 0 if error or end of file.

Definition at line 925 of file libavformat/utils.c.

Referenced by asf_read_pts(), av_seek_frame_generic(), MPEG2fixup::BuildKeyframeIndex(), MPEG2fixup::GetFrame(), AvFormatDecoder::GetFrame(), getFrameCount(), ThumbFinder::getFrameImage(), grabThumbnail(), mpc_read_seek(), AvFormatDecoder::OpenFile(), avfDecoder::run(), and wv_read_seek().

static void flush_packet_queue ( AVFormatContext s  )  [static]

int av_find_default_stream_index ( AVFormatContext s  ) 

Finds the index of the first video stream within the AVFormatContext.

Definition at line 999 of file libavformat/utils.c.

Referenced by av_seek_frame().

void av_read_frame_flush ( AVFormatContext s  ) 

void av_update_cur_dts ( AVFormatContext s,
AVStream ref_st,
int64_t  timestamp 
)

Updates cur_dts of all streams based on given timestamp and AVStream.

Stream ref_st unchanged, others set cur_dts in their native timebase 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 1049 of file libavformat/utils.c.

Referenced by av_seek_frame_binary(), av_seek_frame_byte(), av_seek_frame_generic(), AvFormatDecoder::DoFastForward(), and mxf_read_seek().

int av_add_index_entry ( AVStream st,
int64_t  pos,
int64_t  timestamp,
int  size,
int  distance,
int  flags 
)

int av_index_search_timestamp ( AVStream st,
int64_t  timestamp,
int  flags 
)

Gets the index for a specific timestamp.

Parameters:
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 1105 of file libavformat/utils.c.

Referenced by ape_read_seek(), asf_read_seek(), av_add_index_entry(), av_seek_frame_binary(), av_seek_frame_generic(), avi_read_packet(), avi_read_seek(), flv_read_seek(), gxf_seek(), matroska_read_seek(), mov_seek_stream(), mpc8_read_seek(), mpc_read_seek(), read_seek(), tta_read_seek(), write_packet(), and wv_read_seek().

int av_seek_frame_binary ( AVFormatContext s,
int  stream_index,
int64_t  target_ts,
int  flags 
)

Does a binary search using av_index_search_timestamp() and AVCodec.read_timestamp().

This is not supposed to be called directly by a user application, but by demuxers.

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

Definition at line 1140 of file libavformat/utils.c.

Referenced by asf_read_seek(), av_seek_frame(), and read_seek().

int64_t av_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 
)

Does a binary search using read_timestamp().

This is not supposed to be called directly by a user application, but by demuxers.

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

Definition at line 1204 of file libavformat/utils.c.

Referenced by av_seek_frame_binary(), and read_seek().

static int av_seek_frame_byte ( AVFormatContext s,
int  stream_index,
int64_t  pos,
int  flags 
) [static]

Definition at line 1316 of file libavformat/utils.c.

Referenced by av_seek_frame().

static int av_seek_frame_generic ( AVFormatContext s,
int  stream_index,
int64_t  timestamp,
int  flags 
) [static]

Definition at line 1341 of file libavformat/utils.c.

Referenced by av_seek_frame().

int av_seek_frame ( AVFormatContext s,
int  stream_index,
int64_t  timestamp,
int  flags 
)

Seek to the key frame at timestamp.

'timestamp' in 'stream_index'.

Parameters:
stream_index If stream_index is (-1), a default stream is selected, and timestamp is automatically converted from AV_TIME_BASE units to the stream specific time_base.
timestamp timestamp in AVStream.time_base units or if there is no stream specified then in AV_TIME_BASE units
flags flags which select direction and seeking mode
Returns:
>= 0 on success

Definition at line 1391 of file libavformat/utils.c.

Referenced by av_find_stream_info(), AvFormatDecoder::DoFastForward(), MPEG2fixup::InitAV(), avfDecoder::run(), and ThumbFinder::seekToFrame().

static int av_has_duration ( AVFormatContext ic  )  [static]

Returns 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 1434 of file libavformat/utils.c.

Referenced by av_estimate_timings().

static void av_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 1452 of file libavformat/utils.c.

Referenced by av_estimate_timings(), and fill_all_stream_timings().

static void fill_all_stream_timings ( AVFormatContext ic  )  [static]

Definition at line 1498 of file libavformat/utils.c.

Referenced by av_estimate_timings(), and av_estimate_timings_from_pts().

static void av_estimate_timings_from_bit_rate ( AVFormatContext ic  )  [static]

Definition at line 1515 of file libavformat/utils.c.

Referenced by av_estimate_timings().

static void av_estimate_timings_from_pts ( AVFormatContext ic,
offset_t  old_offset 
) [static]

Estimates timings using PTS stream.

Only usable for MPEG-PS streams.

Definition at line 1555 of file libavformat/utils.c.

Referenced by av_estimate_timings().

void av_estimate_timings ( AVFormatContext ic,
offset_t  old_offset 
)

Attempts to estimate timings using whatever means possible.

First, if the stream is an MPEG-PS stream we try to find the PTS stream. Then we try to get the timings form one of the A/V streams. Finally, we just guess at the timings based on the estimated bit rate.

Definition at line 1661 of file libavformat/utils.c.

Referenced by av_find_stream_info(), getFileInfo(), MetaIOAVFComment::getTrackLength(), ThumbFinder::initAVCodec(), and AvFormatDecoder::OpenFile().

static int has_codec_parameters ( AVCodecContext enc  )  [static]

Definition at line 1708 of file libavformat/utils.c.

Referenced by av_find_stream_info(), and try_decode_frame().

static int try_decode_frame ( AVStream st,
const uint8_t *  data,
int  size 
) [static]

Definition at line 1725 of file libavformat/utils.c.

Referenced by av_find_stream_info().

static int set_codec_from_probe_data ( AVStream st,
AVProbeData pd,
int  score 
) [static]

Definition at line 1764 of file libavformat/utils.c.

Referenced by av_find_stream_info().

unsigned int codec_get_tag ( const AVCodecTag tags,
int  id 
)

enum CodecID codec_get_id ( const AVCodecTag tags,
unsigned int  tag 
)

unsigned int av_codec_get_tag ( const AVCodecTag tags[4],
enum CodecID  id 
)

Definition at line 1805 of file libavformat/utils.c.

enum CodecID av_codec_get_id ( const AVCodecTag tags[4],
unsigned int  tag 
)

Definition at line 1815 of file libavformat/utils.c.

static int get_std_framerate ( int  i  )  [static]

Definition at line 1832 of file libavformat/utils.c.

Referenced by av_find_stream_info().

int av_find_stream_info ( AVFormatContext ic  ) 

Read packets of a media file to get stream information.

This is useful for file formats with no headers such as MPEG. This function also computes the real frame rate in case of mpeg2 repeat frame mode. The logical file position is not changed by this function; examined packets may be buffered for later processing.

Parameters:
ic media file handle
Returns:
>=0 if OK. AVERROR_xxx if error.
Todo:
Let user decide somehow what information is needed so we do not waste time getting stuff the user does not need.

Definition at line 1837 of file libavformat/utils.c.

Referenced by getFileInfo(), MetaIOAVFComment::getTrackLength(), grabThumbnail(), MPEG2fixup::InitAV(), ThumbFinder::initAVCodec(), avfDecoder::initialize(), AvFormatDecoder::OpenFile(), and MetaIOAVFComment::read().

int av_read_play ( AVFormatContext s  ) 

start playing a network based stream (e.g.

RTSP stream) at the current position

Definition at line 2124 of file libavformat/utils.c.

Referenced by avfDecoder::run().

int av_read_pause ( AVFormatContext s  ) 

Pause a network based stream (e.g.

RTSP stream).

Use av_read_play() to resume it.

Definition at line 2131 of file libavformat/utils.c.

void av_close_input_file ( AVFormatContext s  ) 

AVStream* av_new_stream ( AVFormatContext s,
int  id 
)

Add a new stream to a media file.

Can only be called in the read_header() function. If the flag AVFMTCTX_NOHEADER is in the format context, then new streams can be added in read_packet too.

Parameters:
s media file handle
id file format dependent stream id

Definition at line 2181 of file libavformat/utils.c.

Referenced by aac_read_header(), ac3_read_header(), aiff_read_header(), amr_read_header(), apc_read_header(), ape_read_header(), asf_read_header(), au_read_header(), audio_read_header(), avi_read_header(), avisynth_read_header(), avs_read_packet(), cdata_read_header(), cin_read_header(), create_audio_stream(), create_stream(), daud_header(), dc1394_read_header(), decode_main_header(), dts_read_header(), dv_extract_audio_info(), dv_init_demux(), dxa_read_header(), ea_read_header(), ffm_read_header(), film_read_header(), flac_read_header(), flic_read_header(), fourxm_read_header(), get_sindex(), gif_read_header(), grab_read_header(), idcin_read_header(), img_read_header(), avfDecoder::initialize(), ipmovie_read_header(), matroska_read_header(), mm_read_header(), mmf_read_header(), mov_read_trak(), mp3_read_header(), mpc8_read_header(), mpc_read_header(), mpegps_read_packet(), mpegts_read_header(), mtv_read_header(), mxf_parse_structural_metadata(), nsv_parse_NSVs_header(), nut_read_header(), nuv_header(), ogg_new_stream(), raw_read_header(), read_header(), read_packet(), rm_read_header(), rm_read_header_old(), roq_read_header(), sdp_parse_line(), seq_read_header(), shorten_read_header(), siff_parse_vbv1(), smacker_read_header(), sol_read_header(), str_read_header(), swf_read_packet(), thp_read_header(), tta_read_header(), txd_read_header(), v4l2_read_header(), vid_read_header(), video_read_header(), vmd_read_header(), voc_read_header(), wav_read_header(), wc3_read_header(), wsaud_read_header(), wsvqa_read_header(), wv_read_header(), x11grab_read_header(), and yuv4_read_header().

AVStream* av_add_stream ( AVFormatContext s,
AVStream st,
int  id 
)

Add a stream to an MPEG media stream.

This is used by mpegts instead of av_new_stream, so we can track new streams as indicated by the PMT.

Parameters:
s MPEG media stream handle
st new media stream
id file format dependent stream id

Definition at line 2225 of file libavformat/utils.c.

Referenced by new_pes_av_stream(), and new_section_av_stream().

AVProgram* av_new_program ( AVFormatContext ac,
int  id 
)

Definition at line 2264 of file libavformat/utils.c.

void av_set_program_name ( AVProgram program,
char *  provider_name,
char *  name 
)

Definition at line 2289 of file libavformat/utils.c.

void av_remove_stream ( AVFormatContext s,
int  id,
int  remove_ts 
)

Remove a stream from a media stream.

This is used by mpegts, so we can track streams as indicated by the PMT.

Parameters:
s MPEG media stream handle
id stream id of stream to remove
remove_ts if true, remove any matching MPEG-TS filter as well

Definition at line 2309 of file libavformat/utils.c.

Referenced by av_add_stream(), pmt_cb(), and AvFormatDecoder::RemoveAudioStreams().

int av_set_parameters ( AVFormatContext s,
AVFormatParameters ap 
)

media file output

Definition at line 2373 of file libavformat/utils.c.

Referenced by avfDecoder::initialize().

int av_write_header ( AVFormatContext s  ) 

Allocate the stream private data and write the stream header to an output media file.

Parameters:
s media file handle
Returns:
0 if OK. AVERROR_xxx if error.

Definition at line 2392 of file libavformat/utils.c.

static int compute_pkt_fields2 ( AVStream st,
AVPacket pkt 
) [static]

Definition at line 2469 of file libavformat/utils.c.

Referenced by av_interleaved_write_frame(), and av_write_frame().

static void truncate_ts ( AVStream st,
AVPacket pkt 
) [static]

int av_write_frame ( AVFormatContext s,
AVPacket pkt 
)

Write a packet to an output media file.

The packet shall contain one audio or video frame. The packet must be correctly interleaved according to the container specification, if not then av_interleaved_write_frame must be used

Parameters:
s media file handle
pkt the packet, which contains the stream_index, buf/buf_size, dts/pts, ...
Returns:
< 0 if error, = 0 if OK, 1 if end of stream wanted.

Definition at line 2549 of file libavformat/utils.c.

int av_interleave_packet_per_dts ( AVFormatContext s,
AVPacket out,
AVPacket pkt,
int  flush 
)

Interleave a packet per DTS in an output media file.

Packets with pkt->destruct == av_destruct_packet will be freed inside this function, so they cannot be used after it, note calling av_free_packet() on them is still safe.

Parameters:
s media file handle
out the interleaved packet will be output here
in the input packet
flush 1 if no further packets are available as input and all remaining packets should be output
Returns:
1 if a packet was output, 0 if no packet could be output, < 0 if an error occured

Definition at line 2565 of file libavformat/utils.c.

Referenced by av_interleave_packet(), and gxf_interleave_packet().

static int av_interleave_packet ( AVFormatContext s,
AVPacket out,
AVPacket in,
int  flush 
) [static]

Interleaves a AVPacket correctly so it can be muxed.

Parameters:
out the interleaved packet will be output here
in the input packet
flush 1 if no further packets are available as input and all remaining packets should be output
Returns:
1 if a packet was output, 0 if no packet could be output, < 0 if an error occured

Definition at line 2628 of file libavformat/utils.c.

Referenced by av_interleaved_write_frame(), and av_write_trailer().

int av_interleaved_write_frame ( AVFormatContext s,
AVPacket pkt 
)

Writes a packet to an output media file ensuring correct interleaving.

The packet must contain one audio or video frame. If the packets are already correctly interleaved the application should call av_write_frame() instead as it is slightly faster. It is also important to keep in mind that completely non-interleaved input will need huge amounts of memory to interleave with this, so it is preferable to interleave at the demuxer level.

Parameters:
s media file handle
pkt the packet, which contains the stream_index, buf/buf_size, dts/pts, ...
Returns:
< 0 if error, = 0 if OK, 1 if end of stream wanted.

Definition at line 2635 of file libavformat/utils.c.

int av_write_trailer ( AVFormatContext s  ) 

Write the stream trailer to an output media file and free the file private data.

Parameters:
s media file handle
Returns:
0 if OK. AVERROR_xxx if error.

Definition at line 2668 of file libavformat/utils.c.

void av_program_add_stream_index ( AVFormatContext ac,
int  progid,
unsigned int  idx 
)

Definition at line 2702 of file libavformat/utils.c.

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

Definition at line 2726 of file libavformat/utils.c.

Referenced by dump_format().

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

int parse_image_size ( int *  width_ptr,
int *  height_ptr,
const char *  str 
)

parses width and height out of string str.

Deprecated:
Use av_parse_video_frame_size instead.

Definition at line 2809 of file libavformat/utils.c.

int parse_frame_rate ( int *  frame_rate,
int *  frame_rate_base,
const char *  arg 
)

Converts frame rate from string to a fraction.

Deprecated:
Use av_parse_video_frame_rate instead.

Definition at line 2814 of file libavformat/utils.c.

int64_t av_gettime ( void   ) 

int64_t parse_date ( const char *  datestr,
int  duration 
)

Parses datestr and returns a corresponding number of microseconds.

Parameters:
datestr String representing a date or a duration.
  • If a date the syntax is:
      [{YYYY-MM-DD|YYYYMMDD}]{T| }{HH[:MM[:SS[.m...]]][Z]|HH[MM[SS[.m...]]][Z]}
    
    Time is localtime unless Z is appended, in which case it is interpreted as UTC. If the year-month-day part isn't specified it takes the current year-month-day. Returns the number of microseconds since 1st of January, 1970 up to the time of the parsed date or INT64_MIN if datestr cannot be successfully parsed.
  • If a duration the syntax is:
      [-]HH[:MM[:SS[.m...]]]
      [-]S+[.m...]
    
    Returns the number of microseconds contained in a time interval with the specified duration or INT64_MIN if datestr cannot be succesfully parsed.
duration Flag which tells how to interpret datestr, if not zero datestr is interpreted as a duration, otherwise as a date.

Definition at line 2833 of file libavformat/utils.c.

Referenced by rtsp_parse_range_npt().

int find_info_tag ( char *  arg,
int  arg_size,
const char *  tag1,
const char *  info 
)

Attempts to find a specific tag in a URL.

syntax: '?tag1=val1&tag2=val2...'. Little URL decoding is done. Return 1 if found.

Definition at line 2950 of file libavformat/utils.c.

Referenced by get_address(), rtp_open(), and udp_open().

int av_get_frame_filename ( char *  buf,
int  buf_size,
const char *  path,
int  number 
)

Returns in 'buf' the path with 'd' replaced by 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
Returns:
0 if OK, -1 if format error.

Definition at line 2989 of file libavformat/utils.c.

Referenced by av_filename_number_test(), find_image_range(), img_read_packet(), and img_write_packet().

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

Definition at line 3044 of file libavformat/utils.c.

Referenced by av_hex_dump(), and av_hex_dump_log().

void av_hex_dump ( FILE *  f,
uint8_t *  buf,
int  size 
)

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_dump, av_pkt_dump_log

Definition at line 3072 of file libavformat/utils.c.

Referenced by pkt_dump_internal().

void av_hex_dump_log ( void *  avcl,
int  level,
uint8_t *  buf,
int  size 
)

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_dump, av_pkt_dump_log

Definition at line 3077 of file libavformat/utils.c.

Referenced by mpegts_push_data(), pat_cb(), pat_scan_cb(), pmt_cb(), and sdt_cb().

static void pkt_dump_internal ( void *  avcl,
FILE *  f,
int  level,
AVPacket pkt,
int  dump_payload 
) [static]

Definition at line 3083 of file libavformat/utils.c.

Referenced by av_pkt_dump(), and av_pkt_dump_log().

void av_pkt_dump ( FILE *  f,
AVPacket pkt,
int  dump_payload 
)

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

Definition at line 3108 of file libavformat/utils.c.

void av_pkt_dump_log ( void *  avcl,
int  level,
AVPacket pkt,
int  dump_payload 
)

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

Definition at line 3113 of file libavformat/utils.c.

void 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 
)

void av_set_pts_info ( AVStream s,
int  pts_wrap_bits,
int  pts_num,
int  pts_den 
)

Set the pts for a given stream.

Parameters:
s stream
pts_wrap_bits number of bits effectively used by the pts (used for wrap control, 33 is the value for MPEG)
pts_num numerator to convert to seconds (MPEG: 1)
pts_den denominator to convert to seconds (MPEG: 90000)

Definition at line 3179 of file libavformat/utils.c.

Referenced by aiff_read_header(), aiff_write_header(), amr_read_header(), ape_read_header(), asf_read_header(), asf_write_header1(), au_read_header(), audio_read_header(), av_add_stream(), av_new_stream(), avi_read_header(), avi_write_header(), avisynth_read_header(), cdata_read_header(), cin_read_header(), create_audio_stream(), create_stream(), dc1394_read_header(), decode_stream_header(), dv_extract_audio_info(), dv_extract_video_info(), dxa_read_header(), ea_read_header(), ffm_read_header(), ffm_write_header(), film_read_header(), flic_read_header(), flv_write_header(), fourxm_read_header(), grab_read_header(), gxf_header(), gxf_write_header(), idcin_read_header(), img_read_header(), init_stream(), ipmovie_read_header(), matroska_read_header(), mkv_write_tracks(), mm_read_header(), mmf_read_header(), mmf_write_header(), mov_read_header(), mov_write_header(), mpc8_read_header(), mpc_read_header(), mpeg_mux_init(), mpegts_read_header(), mtv_read_header(), mxf_parse_structural_metadata(), nsv_parse_NSVs_header(), nut_read_header(), nut_write_header(), nuv_header(), ogg_new_stream(), ogg_write_header(), parse_h264_sdp_line(), raw_read_header(), rm_read_header(), roq_read_header(), rtp_write_header(), seq_read_header(), siff_parse_vbv1(), smacker_read_header(), sol_read_header(), str_read_header(), swf_read_packet(), thp_read_header(), tta_read_header(), v4l2_read_header(), vid_read_header(), video_read_header(), vmd_read_header(), wav_read_header(), wav_write_header(), wc3_read_header(), write_header(), wsaud_read_header(), wsvqa_read_header(), wv_read_header(), x11grab_read_header(), and yuv4_read_header().


Variable Documentation

head of registered input format linked list.

Definition at line 46 of file libavformat/utils.c.

head of registered output format linked list.

Definition at line 48 of file libavformat/utils.c.

const AVOption options[] [static]

Initial value:

{
{"probesize", NULL, OFFSET(probesize), FF_OPT_TYPE_INT, 32000, 32, INT_MAX, D}, 
{"muxrate", "set mux rate", OFFSET(mux_rate), FF_OPT_TYPE_INT, DEFAULT, 0, INT_MAX, E},
{"packetsize", "set packet size", OFFSET(packet_size), FF_OPT_TYPE_INT, DEFAULT, 0, INT_MAX, E},
{"fflags", NULL, OFFSET(flags), FF_OPT_TYPE_FLAGS, DEFAULT, INT_MIN, INT_MAX, D|E, "fflags"},
{"ignidx", "ignore index", 0, FF_OPT_TYPE_CONST, AVFMT_FLAG_IGNIDX, INT_MIN, INT_MAX, D, "fflags"},
{"genpts", "generate pts", 0, FF_OPT_TYPE_CONST, AVFMT_FLAG_GENPTS, INT_MIN, INT_MAX, D, "fflags"},
{"track", " set the track number", OFFSET(track), FF_OPT_TYPE_INT, DEFAULT, 0, INT_MAX, E},
{"year", "set the year", OFFSET(year), FF_OPT_TYPE_INT, DEFAULT, INT_MIN, INT_MAX, E},
{"analyzeduration", "how many microseconds are analyzed to estimate duration", OFFSET(max_analyze_duration), FF_OPT_TYPE_INT, 3*AV_TIME_BASE, 0, INT_MAX, D},
{NULL},
}

Definition at line 332 of file libavformat/utils.c.

const AVClass av_format_context_class = { "AVFormatContext", format_to_name, options } [static]

Definition at line 349 of file libavformat/utils.c.


Generated on Sat Dec 18 05:15:56 2010 for MythTV by  doxygen 1.5.5