21#ifndef AVFORMAT_AVFORMAT_H
22#define AVFORMAT_AVFORMAT_H
321#ifndef HAVE_AV_CONFIG_H
459#define AVPROBE_SCORE_RETRY (AVPROBE_SCORE_MAX/4)
460#define AVPROBE_SCORE_STREAM_RETRY (AVPROBE_SCORE_MAX/4-1)
462#define AVPROBE_SCORE_EXTENSION 50
463#define AVPROBE_SCORE_MIME 75
464#define AVPROBE_SCORE_MAX 100
466#define AVPROBE_PADDING_SIZE 32
469#define AVFMT_NOFILE 0x0001
470#define AVFMT_NEEDNUMBER 0x0002
477#define AVFMT_EXPERIMENTAL 0x0004
478#define AVFMT_SHOW_IDS 0x0008
479#define AVFMT_GLOBALHEADER 0x0040
480#define AVFMT_NOTIMESTAMPS 0x0080
481#define AVFMT_GENERIC_INDEX 0x0100
482#define AVFMT_TS_DISCONT 0x0200
483#define AVFMT_VARIABLE_FPS 0x0400
484#define AVFMT_NODIMENSIONS 0x0800
485#define AVFMT_NOSTREAMS 0x1000
486#define AVFMT_NOBINSEARCH 0x2000
487#define AVFMT_NOGENSEARCH 0x4000
488#define AVFMT_NO_BYTE_SEEK 0x8000
489#if FF_API_ALLOW_FLUSH
490#define AVFMT_ALLOW_FLUSH 0x10000
492#define AVFMT_TS_NONSTRICT 0x20000
495#define AVFMT_TS_NEGATIVE 0x40000
504#define AVFMT_SEEK_TO_PTS 0x4000000
649 int stream_index, int64_t timestamp,
int flags);
656 int64_t *pos, int64_t pos_limit);
708#define AVINDEX_KEYFRAME 0x0001
709#define AVINDEX_DISCARD_FRAME 0x0002
721#define AV_DISPOSITION_DEFAULT (1 << 0)
729#define AV_DISPOSITION_DUB (1 << 1)
735#define AV_DISPOSITION_ORIGINAL (1 << 2)
739#define AV_DISPOSITION_COMMENT (1 << 3)
743#define AV_DISPOSITION_LYRICS (1 << 4)
747#define AV_DISPOSITION_KARAOKE (1 << 5)
754#define AV_DISPOSITION_FORCED (1 << 6)
758#define AV_DISPOSITION_HEARING_IMPAIRED (1 << 7)
762#define AV_DISPOSITION_VISUAL_IMPAIRED (1 << 8)
766#define AV_DISPOSITION_CLEAN_EFFECTS (1 << 9)
774#define AV_DISPOSITION_ATTACHED_PIC (1 << 10)
779#define AV_DISPOSITION_TIMED_THUMBNAILS (1 << 11)
786#define AV_DISPOSITION_NON_DIEGETIC (1 << 12)
792#define AV_DISPOSITION_CAPTIONS (1 << 16)
798#define AV_DISPOSITION_DESCRIPTIONS (1 << 17)
803#define AV_DISPOSITION_METADATA (1 << 18)
809#define AV_DISPOSITION_DEPENDENT (1 << 19)
813#define AV_DISPOSITION_STILL_IMAGE (1 << 20)
832#define AV_PTS_WRAP_IGNORE 0
833#define AV_PTS_WRAP_ADD_OFFSET 1
834#define AV_PTS_WRAP_SUB_OFFSET -1
943#if FF_API_AVSTREAM_SIDE_DATA
993#define AVSTREAM_EVENT_FLAG_METADATA_UPDATED 0x0001
999#define AVSTREAM_EVENT_FLAG_NEW_PACKETS (1 << 1)
1023#if FF_API_GET_END_PTS
1033#define AV_PROGRAM_RUNNING 1
1068#define AVFMTCTX_NOHEADER 0x0001
1070#define AVFMTCTX_UNSEEKABLE 0x0002
1088 void *data,
size_t data_size);
1236#define AVFMT_FLAG_GENPTS 0x0001
1237#define AVFMT_FLAG_IGNIDX 0x0002
1238#define AVFMT_FLAG_NONBLOCK 0x0004
1239#define AVFMT_FLAG_IGNDTS 0x0008
1240#define AVFMT_FLAG_NOFILLIN 0x0010
1241#define AVFMT_FLAG_NOPARSE 0x0020
1242#define AVFMT_FLAG_NOBUFFER 0x0040
1243#define AVFMT_FLAG_CUSTOM_IO 0x0080
1244#define AVFMT_FLAG_DISCARD_CORRUPT 0x0100
1245#define AVFMT_FLAG_FLUSH_PACKETS 0x0200
1252#define AVFMT_FLAG_BITEXACT 0x0400
1253#define AVFMT_FLAG_SORT_DTS 0x10000
1254#define AVFMT_FLAG_FAST_SEEK 0x80000
1255#if FF_API_LAVF_SHORTEST
1256#define AVFMT_FLAG_SHORTEST 0x100000
1258#define AVFMT_FLAG_AUTO_BSF 0x200000
1389#define FF_FDEBUG_TS 0x0001
1433#define AVFMT_EVENT_FLAG_METADATA_UPDATED 0x0001
1449#define AVFMT_AVOID_NEG_TS_AUTO -1
1450#define AVFMT_AVOID_NEG_TS_DISABLED 0
1451#define AVFMT_AVOID_NEG_TS_MAKE_NON_NEGATIVE 1
1452#define AVFMT_AVOID_NEG_TS_MAKE_ZERO 2
1679#if FF_API_AVFORMAT_IO_CLOSE
1866#if FF_API_AVSTREAM_SIDE_DATA
1884 uint8_t *data,
size_t size);
1942 const char *format_name,
const char *filename);
1976 int is_opened,
int *score_max);
1986 int is_opened,
int *score_ret);
2006 const char *
url,
void *logctx,
2007 unsigned int offset,
unsigned int max_probe_size);
2013 const char *
url,
void *logctx,
2014 unsigned int offset,
unsigned int max_probe_size);
2107 int wanted_stream_nb,
2109 const struct AVCodec **decoder_ret,
2226#define AVSEEK_FLAG_BACKWARD 1
2227#define AVSEEK_FLAG_BYTE 2
2228#define AVSEEK_FLAG_ANY 4
2229#define AVSEEK_FLAG_FRAME 8
2236#define AVSTREAM_INIT_IN_WRITE_HEADER 0
2237#define AVSTREAM_INIT_IN_INIT_OUTPUT 1
2438 const char *filename,
2439 const char *mime_type);
2445 const char *filename,
const char *mime_type,
2466 int64_t *dts, int64_t *wall);
2492void av_hex_dump(FILE *f,
const uint8_t *buf,
int size);
2506void av_hex_dump_log(
void *avcl,
int level,
const uint8_t *buf,
int size);
2617 int64_t wanted_timestamp,
2626 int size,
int distance,
int flags);
2649 char *authorization,
int authorization_size,
2650 char *hostname,
int hostname_size,
2652 char *path,
int path_size,
2672#define AV_FRAME_FILENAME_FLAGS_MULTIPLE 1
2688 const char *path,
int number,
int flags);
2691 const char *path,
int number);
2727int av_match_ext(
const char *filename,
const char *extensions);
2740 int std_compliance);
2828#if FF_API_R_FRAME_RATE
#define av_warn_unused_result
#define attribute_deprecated
Misc types and constants that do not belong anywhere else.
reference-counted frame API
AVCodecID
Identify the syntax and semantics of the bitstream.
attribute_deprecated int av_stream_add_side_data(AVStream *st, enum AVPacketSideDataType type, uint8_t *data, size_t size)
Wrap an existing array as stream side data.
int avformat_network_deinit(void)
Undo the initialization done by avformat_network_init.
const char * avformat_configuration(void)
Return the libavformat build-time configuration.
AVProgram * av_new_program(AVFormatContext *s, int id)
AVStream * avformat_new_stream(AVFormatContext *s, const struct AVCodec *c)
Add a new stream to a media file.
const AVClass * av_stream_get_class(void)
Get the AVClass for AVStream.
attribute_deprecated uint8_t * av_stream_get_side_data(const AVStream *stream, enum AVPacketSideDataType type, size_t *size)
Get side information from stream.
attribute_deprecated uint8_t * av_stream_new_side_data(AVStream *stream, enum AVPacketSideDataType type, size_t size)
Allocate new information from stream.
const AVOutputFormat * av_muxer_iterate(void **opaque)
Iterate over all registered muxers.
int avformat_network_init(void)
Do global initialization of network libraries.
const char * avformat_license(void)
Return the libavformat license.
AVFormatContext * avformat_alloc_context(void)
Allocate an AVFormatContext.
const AVInputFormat * av_demuxer_iterate(void **opaque)
Iterate over all registered demuxers.
void avformat_free_context(AVFormatContext *s)
Free an AVFormatContext and all its streams.
const AVClass * avformat_get_class(void)
Get the AVClass for AVFormatContext.
unsigned avformat_version(void)
Return the LIBAVFORMAT_VERSION_INT constant.
const AVInputFormat * av_find_input_format(const char *short_name)
Find AVInputFormat based on the short name of the input format.
AVProgram * av_find_program_from_stream(AVFormatContext *ic, AVProgram *last, int s)
Find the programs which belong to a given stream.
const AVInputFormat * av_probe_input_format3(const AVProbeData *pd, int is_opened, int *score_ret)
Guess the file format.
int av_read_pause(AVFormatContext *s)
Pause a network-based stream (e.g.
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.
int av_read_frame(AVFormatContext *s, AVPacket *pkt)
Return the next frame of a stream.
int av_read_play(AVFormatContext *s)
Start playing a network-based stream (e.g.
int av_find_best_stream(AVFormatContext *ic, enum AVMediaType type, int wanted_stream_nb, int related_stream, const struct AVCodec **decoder_ret, int flags)
Find the "best" stream in the file.
int av_probe_input_buffer(AVIOContext *pb, const AVInputFormat **fmt, const char *url, void *logctx, unsigned int offset, unsigned int max_probe_size)
Like av_probe_input_buffer2() but returns 0 on success.
int avformat_flush(AVFormatContext *s)
Discard all internally buffered data.
int av_seek_frame(AVFormatContext *s, int stream_index, int64_t timestamp, int flags)
Seek to the keyframe at timestamp.
void av_program_add_stream_index(AVFormatContext *ac, int progid, unsigned int idx)
int av_probe_input_buffer2(AVIOContext *pb, const AVInputFormat **fmt, const char *url, void *logctx, unsigned int offset, unsigned int max_probe_size)
Probe a bytestream to determine the input format.
int avformat_open_input(AVFormatContext **ps, const char *url, const AVInputFormat *fmt, AVDictionary **options)
Open an input stream and read the header.
const AVInputFormat * av_probe_input_format(const AVProbeData *pd, int is_opened)
Guess the file format.
const AVInputFormat * av_probe_input_format2(const AVProbeData *pd, int is_opened, int *score_max)
Guess the file format.
int avformat_find_stream_info(AVFormatContext *ic, AVDictionary **options)
Read packets of a media file to get stream information.
void avformat_close_input(AVFormatContext **s)
Close an opened input AVFormatContext.
enum AVCodecID av_guess_codec(const AVOutputFormat *fmt, const char *short_name, const char *filename, const char *mime_type, enum AVMediaType type)
Guess the codec ID based upon muxer and filename.
av_warn_unused_result int avformat_init_output(AVFormatContext *s, AVDictionary **options)
Allocate the stream private data and initialize the codec, but do not write the header.
av_warn_unused_result int avformat_write_header(AVFormatContext *s, AVDictionary **options)
Allocate the stream private data and write the stream header to an output media file.
int av_interleaved_write_frame(AVFormatContext *s, AVPacket *pkt)
Write a packet to an output media file ensuring correct interleaving.
int av_interleaved_write_uncoded_frame(AVFormatContext *s, int stream_index, struct AVFrame *frame)
Write an uncoded frame to an output media file.
int av_write_uncoded_frame(AVFormatContext *s, int stream_index, struct AVFrame *frame)
Write an uncoded frame to an output media file.
int av_write_uncoded_frame_query(AVFormatContext *s, int stream_index)
Test whether a muxer supports uncoded frame.
int av_get_output_timestamp(struct AVFormatContext *s, int stream, int64_t *dts, int64_t *wall)
Get timing information for the data currently output.
int av_write_trailer(AVFormatContext *s)
Write the stream trailer to an output media file and free the file private data.
const AVOutputFormat * av_guess_format(const char *short_name, const char *filename, const char *mime_type)
Return the output format in the list of registered output formats which best matches the provided par...
int av_write_frame(AVFormatContext *s, AVPacket *pkt)
Write a packet to an output media file.
int av_get_frame_filename2(char *buf, int buf_size, const char *path, int number, int flags)
Return in 'buf' the path with 'd' replaced by a number.
unsigned int av_codec_get_tag(const struct AVCodecTag *const *tags, enum AVCodecID id)
Get the codec tag for the given codec id id.
enum AVCodecID av_codec_get_id(const struct AVCodecTag *const *tags, unsigned int tag)
Get the AVCodecID for the given codec tag tag.
int avformat_index_get_entries_count(const AVStream *st)
Get the index entry count for the given AVStream.
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.
void av_pkt_dump2(FILE *f, const AVPacket *pkt, int dump_payload, const AVStream *st)
Send a nice dump of a packet to the specified file stream.
int avformat_queue_attached_pictures(AVFormatContext *s)
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.
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.
AVRational av_stream_get_codec_timebase(const AVStream *st)
Get the internal codec timebase from a stream.
const AVIndexEntry * avformat_index_get_entry(AVStream *st, int idx)
Get the AVIndexEntry corresponding to the given index.
AVRational av_guess_frame_rate(AVFormatContext *ctx, AVStream *stream, struct 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.
int av_match_ext(const char *filename, const char *extensions)
Return a positive value if the given filename has one of the given extensions, 0 otherwise.
int av_get_frame_filename(char *buf, int buf_size, const char *path, int number)
int av_sdp_create(AVFormatContext *ac[], int n_files, char *buf, int size)
Generate an SDP for an RTP session.
int avformat_query_codec(const AVOutputFormat *ofmt, enum AVCodecID codec_id, int std_compliance)
Test if the given container can store a codec.
void av_pkt_dump_log2(void *avcl, int level, const AVPacket *pkt, int dump_payload, const AVStream *st)
Send a nice dump of a packet to the log.
int av_find_default_stream_index(AVFormatContext *s)
const AVIndexEntry * avformat_index_get_entry_from_timestamp(AVStream *st, int64_t wanted_timestamp, int flags)
Get the AVIndexEntry corresponding to the given timestamp.
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.
int av_codec_get_tag2(const struct AVCodecTag *const *tags, enum AVCodecID id, unsigned int *tag)
Get the codec tag for the given codec id.
int av_filename_number_test(const char *filename)
Check whether filename actually is a numbered sequence generator.
int av_index_search_timestamp(AVStream *st, int64_t timestamp, int flags)
Get the index for a specific timestamp.
void av_dump_format(AVFormatContext *ic, int index, const char *url, int is_output)
Print detailed information about the input or output format, such as duration, bitrate,...
int avformat_transfer_internal_stream_timing_info(const AVOutputFormat *ofmt, AVStream *ost, const AVStream *ist, enum AVTimebaseSource copy_tb)
Transfer internal timing information from one stream to another.
AVRational av_guess_sample_aspect_ratio(AVFormatContext *format, AVStream *stream, struct AVFrame *frame)
Guess the sample aspect ratio of a frame, based on both the stream and the frame aspect ratio.
struct AVDictionary AVDictionary
const struct AVCodecTag * avformat_get_mov_audio_tags(void)
const struct AVCodecTag * avformat_get_riff_audio_tags(void)
const struct AVCodecTag * avformat_get_mov_video_tags(void)
const struct AVCodecTag * avformat_get_riff_video_tags(void)
int64_t id
unique ID to identify the chapter
int64_t end
chapter start/end time in time_base units
AVRational time_base
time base in which the start/end timestamps are specified
Describe the class of an AVClass context structure.
This struct describes the properties of an encoded stream.
int64_t max_interleave_delta
Maximum buffering duration for interleaving.
int event_flags
Flags indicating events happening on the file, a combination of AVFMT_EVENT_FLAG_*.
int avoid_negative_ts
Avoid negative timestamps during muxing.
unsigned int nb_streams
Number of elements in AVFormatContext.streams.
const AVClass * av_class
A class for logging and AVOptions.
int max_streams
The maximum number of streams.
int(* io_close2)(struct AVFormatContext *s, AVIOContext *pb)
A callback for closing the streams opened with AVFormatContext.io_open().
enum AVCodecID audio_codec_id
Forced audio codec_id.
AVIOContext * pb
I/O context.
int flush_packets
Flush the I/O context after each packet.
enum AVCodecID data_codec_id
Forced Data codec_id.
int64_t start_time
Position of the first frame of the component, in AV_TIME_BASE fractional seconds.
const struct AVCodec * data_codec
Forced data codec.
AVDictionary * metadata
Metadata that applies to the whole file.
int flags
Flags modifying the (de)muxer behaviour.
const struct AVOutputFormat * oformat
The output container format.
int max_chunk_size
Max chunk size in bytes Note, not all formats support this and unpredictable things may happen if it ...
int seek2any
Force seeking to any (also non key) frames.
int io_repositioned
IO repositioned flag.
int64_t max_analyze_duration
Maximum duration (in AV_TIME_BASE units) of the data read from input in avformat_find_stream_info().
int ctx_flags
Flags signalling stream properties.
int strict_std_compliance
Allow non-standard and experimental extension.
int fps_probe_size
The number of frames used for determining the framerate in avformat_find_stream_info().
const struct AVCodec * audio_codec
Forced audio codec.
AVIOInterruptCB interrupt_callback
Custom interrupt callbacks for the I/O layer.
int ts_id
Transport stream id.
int avio_flags
avio flags, used to force AVIO_FLAG_DIRECT.
char * url
input or output URL.
int probe_score
format probing score.
const struct AVInputFormat * iformat
The input container format.
unsigned int nb_chapters
Number of chapters in AVChapter array.
int metadata_header_padding
Number of bytes to be written as padding in a metadata header.
int64_t output_ts_offset
Output timestamp offset, in microseconds.
int format_probesize
Maximum number of bytes read from input in order to identify the input format.
int use_wallclock_as_timestamps
forces the use of wallclock timestamps as pts/dts of packets This has undefined results in the presen...
enum AVDurationEstimationMethod duration_estimation_method
The duration field can be estimated through various ways, and this field can be used to know how the ...
int64_t bit_rate
Total stream bitrate in bit/s, 0 if not available.
char * codec_whitelist
',' separated list of allowed decoders.
int64_t start_time_realtime
Start time of the stream in real world time, in microseconds since the Unix epoch (00:00 1st January ...
attribute_deprecated void(* io_close)(struct AVFormatContext *s, AVIOContext *pb)
A callback for closing the streams opened with AVFormatContext.io_open().
unsigned int max_index_size
Maximum amount of memory in bytes to use for the index of each stream.
enum AVCodecID video_codec_id
Forced video codec_id.
int debug
Flags to enable debugging.
av_format_control_message control_message_cb
Callback used by devices to communicate with application.
char * format_whitelist
',' separated list of allowed demuxers.
int audio_preload
Audio preload in microseconds.
void * priv_data
Format private data.
int64_t probesize
Maximum number of bytes read from input in order to determine stream properties.
enum AVCodecID subtitle_codec_id
Forced subtitle codec_id.
AVStream ** streams
A list of all streams in the file.
int64_t duration
Duration of the stream, in AV_TIME_BASE fractional seconds.
int max_ts_probe
Maximum number of packets to read while waiting for the first timestamp.
int64_t skip_initial_bytes
Skip initial bytes when opening stream.
const struct AVCodec * subtitle_codec
Forced subtitle codec.
char * protocol_whitelist
',' separated list of allowed protocols.
char * protocol_blacklist
',' separated list of disallowed protocols.
unsigned int max_picture_buffer
Maximum amount of memory in bytes to use for buffering frames obtained from realtime capture devices.
int max_chunk_duration
Max chunk time in microseconds.
const struct AVCodec * video_codec
Forced video codec.
int skip_estimate_duration_from_pts
Skip duration calcuation in estimate_timings_from_pts.
int error_recognition
Error recognition; higher values will detect more errors but may misdetect some more or less valid pa...
int(* io_open)(struct AVFormatContext *s, AVIOContext **pb, const char *url, int flags, AVDictionary **options)
A callback for opening new IO streams.
int max_probe_packets
Maximum number of packets that can be probed.
unsigned int correct_ts_overflow
Correct single timestamp overflows.
uint8_t * dump_separator
dump format separator.
This structure describes decoded (raw) audio or video data.
Callback for checking whether to abort blocking functions.
int min_distance
Minimum distance between this and the previous keyframe, used to avoid unneeded searching.
int64_t timestamp
Timestamp in AVStream.time_base units, preferably the time from which on correctly decoded frames are...
This structure stores auxiliary information for decoding, presenting, or otherwise processing the cod...
This structure stores compressed data.
This structure contains the data a format has to probe a file.
const char * mime_type
mime_type, when known.
int buf_size
Size of buf except extra allocated bytes.
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
New fields can be added to the end with minor version bumps.
unsigned int nb_stream_indexes
unsigned int * stream_index
int64_t pts_wrap_reference
reference dts for wrap detection
enum AVDiscard discard
selects which program to discard and which to feed to the caller
int pts_wrap_behavior
behavior on wrap detection
Rational number (pair of numerator and denominator).
AVCodecParameters * codecpar
Codec parameters associated with this stream.
attribute_deprecated AVPacketSideData * side_data
An array of side data that applies to the whole stream (i.e.
AVRational sample_aspect_ratio
sample aspect ratio (0 if unknown)
int64_t nb_frames
number of frames in this stream if known or 0
const AVClass * av_class
A class for AVOptions.
enum AVDiscard discard
Selects which packets can be discarded at will and do not need to be demuxed.
int64_t duration
Decoding: duration of the stream, in stream time base.
int id
Format-specific stream ID.
int index
stream index in AVFormatContext
int pts_wrap_bits
Number of bits in timestamps.
attribute_deprecated int nb_side_data
The number of elements in the AVStream.side_data array.
int64_t start_time
Decoding: pts of the first frame of the stream in presentation order, in stream time base.
AVPacket attached_pic
For streams with AV_DISPOSITION_ATTACHED_PIC disposition, this packet will contain the attached pictu...
AVRational avg_frame_rate
Average framerate.
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented.
int event_flags
Flags indicating events happening on the stream, a combination of AVSTREAM_EVENT_FLAG_*.
AVRational r_frame_rate
Real base framerate of the stream.
int disposition
Stream disposition - a combination of AV_DISPOSITION_* flags.