avformat.h File Reference

Go to the source code of this file.

Classes

struct  AVPacket
struct  AVFrac
 the exact value of the fractional number is: 'val + num / den'. More...
struct  AVProbeData
 this structure contains the data a format has to probe a file More...
struct  AVFormatParameters
struct  AVOutputFormat
struct  AVInputFormat
struct  AVIndexEntry
struct  AVStream
struct  AVProgram
struct  AVFormatContext
struct  AVPacketList

Typedefs

typedef struct AVFrac attribute_deprecated

Enumerations

enum  AVStreamParseType { AVSTREAM_PARSE_NONE, AVSTREAM_PARSE_FULL, AVSTREAM_PARSE_HEADERS, AVSTREAM_PARSE_TIMESTAMPS }

Functions

void av_destruct_packet_nofree (AVPacket *pkt)
 Simply sets data pointer to null.
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)
static void av_free_packet (AVPacket *pkt)
 Free a packet.
enum CodecID av_guess_image2_codec (const char *filename)
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.
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.
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.
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.
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.
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 av_register_all (void)
 Initialize libavformat and register all the (de)muxers and protocols.
enum CodecID av_codec_get_id (const struct AVCodecTag **tags, unsigned int tag)
 codec tag <-> codec id
unsigned int av_codec_get_tag (const struct AVCodecTag **tags, enum CodecID id)
AVInputFormat * av_find_input_format (const char *short_name)
 finds AVInputFormat based on input format's short name.
AVInputFormat * av_probe_input_format (AVProbeData *pd, int is_opened)
 Guess file format.
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.
AVFormatContext * av_alloc_format_context (void)
 no av_open for output, so applications will need this:
int av_find_stream_info (AVFormatContext *ic)
 Read packets of a media file to get stream information.
int av_read_packet (AVFormatContext *s, AVPacket *pkt)
 Read a transport packet from a media file.
int av_read_frame (AVFormatContext *s, AVPacket *pkt)
 Return the next frame of a stream.
int av_seek_frame (AVFormatContext *s, int stream_index, int64_t timestamp, int flags)
 Seek to the key frame at timestamp.
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).
AVStream * av_new_stream (AVFormatContext *s, int id)
 Add a new stream to a media file.
AVProgram * av_new_program (AVFormatContext *s, int id)
void av_set_pts_info (AVStream *s, int pts_wrap_bits, int pts_num, int pts_den)
 Set the pts for a given stream.
void av_estimate_timings (AVFormatContext *ic, offset_t old_offset)
 Attempts to estimate timings using whatever means possible.
void av_read_frame_flush (AVFormatContext *s)
 Flush the frame reader.
AVStream * av_add_stream (AVFormatContext *s, AVStream *st, int id)
 Add a stream to an MPEG media stream.
void av_remove_stream (AVFormatContext *s, int id, int remove_ts)
 Remove a stream from a media stream.
int av_find_default_stream_index (AVFormatContext *s)
 Finds the index of the first video stream within the AVFormatContext.
int av_index_search_timestamp (AVStream *st, int64_t timestamp, int flags)
 Gets the index for a specific timestamp.
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_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().
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.
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().
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.
int av_write_frame (AVFormatContext *s, AVPacket *pkt)
 Write a packet to an output media file.
int av_interleaved_write_frame (AVFormatContext *s, AVPacket *pkt)
 Writes a packet to an output media file ensuring correct interleaving.
int av_interleave_packet_per_dts (AVFormatContext *s, AVPacket *out, AVPacket *pkt, int flush)
 Interleave a packet per DTS in an output media file.
int av_write_trailer (AVFormatContext *s)
 Write the stream trailer to an output media file and free the file private data.
void dump_format (AVFormatContext *ic, int index, const char *url, int is_output)
attribute_deprecated int parse_image_size (int *width_ptr, int *height_ptr, const char *str)
 parses width and height out of string str.
attribute_deprecated int parse_frame_rate (int *frame_rate, int *frame_rate_base, const char *arg)
 Converts frame rate from string to a fraction.
int64_t parse_date (const char *datestr, int duration)
 Parses datestr and returns a corresponding number of microseconds.
int64_t av_gettime (void)
 gets the current time in micro seconds.
offset_t ffm_read_write_index (int fd)
void ffm_write_write_index (int fd, offset_t pos)
void ffm_set_write_index (AVFormatContext *s, offset_t pos, offset_t file_size)
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.
int av_filename_number_test (const char *filename)
 Check whether filename actually is a numbered sequence generator.
int avf_sdp_create (AVFormatContext *ac[], int n_files, char *buff, int size)
 Generate an SDP for an RTP session.
void __dynarray_add (unsigned long **tab_ptr, int *nb_ptr, unsigned long elem)
time_t mktimegm (struct tm *tm)
struct tm * brktimegm (time_t secs, struct tm *tm)
const char * small_strptime (const char *p, const char *fmt, struct tm *dt)
int resolve_host (struct in_addr *sin_addr, const char *hostname)
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)
int match_ext (const char *filename, const char *extensions)
 Match an extension to a filename with extension.

Variables

AVInputFormat * first_iformat
 head of registered input format linked list.
AVOutputFormat * first_oformat
 head of registered output format linked list.

Typedef Documentation

typedef struct AVFrac attribute_deprecated

Enumeration Type Documentation

enum AVStreamParseType

Enumerator:
AVSTREAM_PARSE_NONE 
AVSTREAM_PARSE_FULL  full parsing and repack
AVSTREAM_PARSE_HEADERS  only parse headers, don't repack
AVSTREAM_PARSE_TIMESTAMPS  full parsing and interpolation of timestamps for frames not starting on packet boundary

Definition at line 257 of file avformat.h.

Function Documentation

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().

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  ) 

Initialize optional fields of a packet to default values.

Parameters:
pkt packet

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

Referenced by av_interleave_packet_per_dts(), av_new_packet(), av_read_frame_internal(), av_read_packet(), avi_write_packet(), MPEG2fixup::BuildKeyframeIndex(), dc1394_read_header(), dv_extract_audio_info(), dv_produce_packet(), MPEG2fixup::FindStart(), AvFormatDecoder::GetFrame(), getFrameCount(), ThumbFinder::getFrameImage(), MPEG2fixup::Start(), and v4l2_read_packet().

int av_new_packet ( AVPacket *  pkt,
int  size 
)

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

Parameters:
pkt packet
size wanted payload size
Returns:
0 if OK. AVERROR_xxx otherwise.

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

Referenced by amr_read_packet(), ape_read_packet(), asf_read_packet(), audio_read_packet(), av_get_packet(), avisynth_read_packet(), avs_read_video_packet(), cin_read_packet(), dxa_read_packet(), ff_rm_parse_packet(), ff_rm_retrieve_cache(), ffm_read_packet(), film_read_packet(), flic_read_packet(), fourxm_read_packet(), gif_read_packet(), grab_read_packet(), gxf_new_audio_packet(), h264_handle_packet(), img_read_packet(), ingenient_read_packet(), load_ipmovie_packet(), matroska_parse_block(), mm_read_packet(), mmf_read_packet(), mpc_read_packet(), mpegps_read_packet(), mpegts_push_data(), mpegts_push_section(), mpegts_raw_read_packet(), mxf_get_d10_aes3_packet(), nut_read_packet(), nuv_packet(), ogg_read_packet(), raw_read_partial_packet(), read_frame(), read_packet(), rm_assemble_video_frame(), rm_read_packet(), roq_read_packet(), rtp_parse_packet(), seq_read_packet(), siff_read_packet(), smacker_read_packet(), str_read_packet(), swf_read_packet(), v4l2_read_packet(), vmd_read_packet(), wsvqa_read_packet(), wv_read_packet(), and x11grab_read_packet().

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.

Parameters:
pkt packet
size wanted payload size
Returns:
>0 (read size) if OK. AVERROR_xxx otherwise.

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

Referenced by aiff_read_packet(), apc_read_packet(), au_read_packet(), avi_read_packet(), cdata_read_packet(), daud_packet(), decode_frame(), dxa_read_packet(), ea_read_packet(), ff_rm_parse_packet(), ff_rm_retrieve_cache(), film_read_packet(), flv_read_packet(), fourxm_read_packet(), gxf_packet(), idcin_read_packet(), load_ipmovie_packet(), mm_read_packet(), mov_read_packet(), mp3_read_packet(), mpc8_read_packet(), mtv_read_packet(), mxf_decrypt_triplet(), mxf_read_packet(), nsv_read_chunk(), nuv_packet(), PCMDEF(), raw_read_packet(), rm_read_packet(), roq_read_packet(), seq_read_packet(), siff_read_packet(), sol_read_packet(), swf_read_packet(), thp_read_packet(), tta_read_packet(), txd_read_packet(), vid_read_packet(), voc_get_packet(), wav_read_packet(), wc3_read_packet(), wsaud_read_packet(), and yuv4_read_packet().

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().

static void av_free_packet ( AVPacket *  pkt  )  [inline, static]

Free a packet.

Parameters:
pkt packet to free

Definition at line 95 of file avformat.h.

Referenced by amr_read_packet(), asf_read_packet(), asf_read_pts(), asf_reset_header(), audio_read_packet(), av_close_input_file(), av_estimate_timings_from_pts(), av_get_packet(), av_interleaved_write_frame(), av_read_frame_flush(), av_read_frame_internal(), av_seek_frame_generic(), av_write_trailer(), avs_read_video_packet(), MPEG2fixup::BuildKeyframeIndex(), dxa_read_packet(), ff_rm_parse_packet(), ffm_read_packet(), flic_read_packet(), flush_packet_queue(), fourxm_read_packet(), MPEG2fixup::GetFrame(), AvFormatDecoder::GetFrame(), getFrameCount(), ThumbFinder::getFrameImage(), grabThumbnail(), img_read_packet(), ingenient_read_packet(), load_ipmovie_packet(), matroska_read_close(), mmf_read_packet(), mpc_read_packet(), mpc_read_seek(), mpegts_raw_read_packet(), AvFormatDecoder::OpenFile(), raw_read_partial_packet(), read_packet(), avfDecoder::run(), AvFormatDecoder::SeekReset(), thp_read_packet(), vid_read_packet(), vmd_read_packet(), wsvqa_read_packet(), wv_read_packet(), wv_read_seek(), and AvFormatDecoder::~AvFormatDecoder().

enum CodecID av_guess_image2_codec ( const char *  filename  ) 

Definition at line 169 of file img2.c.

Referenced by av_guess_codec(), and guess_format().

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().

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.

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().

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.

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().

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

Initialize libavformat and register all the (de)muxers and protocols.

Definition at line 41 of file allformats.c.

Referenced by IvtvDecoder::CanHandle(), AvFormatDecoder::CanHandle(), getFileInfo(), grabThumbnail(), ThumbFinder::initAVCodec(), avfDecoder::initialize(), main(), MetaIOAVFComment::MetaIOAVFComment(), and MPEG2fixup::MPEG2fixup().

enum CodecID av_codec_get_id ( const struct AVCodecTag **  tags,
unsigned int  tag 
)

codec tag <-> codec id

unsigned int av_codec_get_tag ( const struct AVCodecTag **  tags,
enum CodecID  id 
)

Referenced by av_write_header().

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().

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().

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().

AVFormatContext* av_alloc_format_context ( void   ) 

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_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_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().

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().

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().

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  ) 

Close a media file (but not its codecs).

Parameters:
s media file handle

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

Referenced by MPEG2fixup::BuildKeyframeIndex(), ThumbFinder::closeAVCodec(), AvFormatDecoder::CloseContext(), avfDecoder::deinit(), getFileInfo(), MetaIOAVFComment::getTrackLength(), grabThumbnail(), MPEG2fixup::InitAV(), ThumbFinder::initAVCodec(), AvFormatDecoder::OpenFile(), MetaIOAVFComment::read(), MPEG2fixup::Start(), and MPEG2fixup::~MPEG2fixup().

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().

AVProgram* av_new_program ( AVFormatContext *  s,
int  id 
)

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

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().

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().

void av_read_frame_flush ( AVFormatContext *  s  ) 

Flush the frame reader.

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

Referenced by av_find_stream_info(), av_seek_frame(), av_seek_frame_generic(), pmt_cb(), AvFormatDecoder::RemoveAudioStreams(), and AvFormatDecoder::SeekReset().

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().

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_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().

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_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.

Parameters:
timestamp timestamp in the timebase of the given stream

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

Referenced by ape_read_header(), asf_build_simple_index(), asf_read_pts(), av_read_frame_internal(), avi_read_idx1(), avi_read_packet(), clean_index(), find_and_decode_index(), flv_read_packet(), gxf_read_index(), matroska_read_header(), mov_build_index(), mpc8_parse_seektable(), mpc_read_packet(), mpegps_read_pes_header(), read_braindead_odml_indx(), rm_read_dts(), rm_read_packet(), tta_read_header(), write_packet(), and wv_read_packet().

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().

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().

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().

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.

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_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_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().

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 dump_format ( AVFormatContext *  ic,
int  index,
const char *  url,
int  is_output 
)

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

Referenced by getFileInfo(), MPEG2fixup::InitAV(), ThumbFinder::initAVCodec(), and AvFormatDecoder::OpenFile().

attribute_deprecated 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.

attribute_deprecated 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 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().

int64_t av_gettime ( void   ) 

gets the current time in micro seconds.

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

Referenced by audio_read_packet(), bktr_getframe(), ffm_write_header(), grab_read_header(), grab_read_packet(), rtp_write_packet(), x11grab_read_header(), and x11grab_read_packet().

offset_t ffm_read_write_index ( int  fd  ) 

Definition at line 714 of file ffm.c.

void ffm_write_write_index ( int  fd,
offset_t  pos 
)

Definition at line 723 of file ffm.c.

void ffm_set_write_index ( AVFormatContext *  s,
offset_t  pos,
offset_t  file_size 
)

Definition at line 734 of file ffm.c.

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().

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().

int avf_sdp_create ( AVFormatContext *  ac[],
int  n_files,
char *  buff,
int  size 
)

Generate an SDP for an RTP session.

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
buff 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 if error.

Definition at line 262 of file sdp.c.

void __dynarray_add ( unsigned long **  tab_ptr,
int *  nb_ptr,
unsigned long  elem 
)

Definition at line 24 of file cutils.c.

time_t mktimegm ( struct tm *  tm  ) 

Definition at line 43 of file cutils.c.

Referenced by parse_date().

struct tm* brktimegm ( time_t  secs,
struct tm *  tm 
) [read]

Definition at line 67 of file cutils.c.

Referenced by dv_write_pack().

const char* small_strptime ( const char *  p,
const char *  fmt,
struct tm *  dt 
)

Definition at line 123 of file cutils.c.

Referenced by parse_date().

int resolve_host ( struct in_addr *  sin_addr,
const char *  hostname 
)

Definition at line 58 of file os_support.c.

Referenced by tcp_open(), and udp_set_url().

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 
)

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

Referenced by get_address(), http_open_cnx(), rtp_open(), rtp_set_remote_url(), rtsp_read_header(), sdp_parse_line(), tcp_open(), udp_open(), and udp_set_remote_url().

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().

Variable Documentation

AVInputFormat* first_iformat

head of registered input format linked list.

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

AVOutputFormat* first_oformat

head of registered output format linked list.

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

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