21 #ifndef AVFORMAT_AVFORMAT_H
22 #define AVFORMAT_AVFORMAT_H
210 #if FF_API_AV_GETTIME
344 #define AVPROBE_SCORE_MAX 100
345 #define AVPROBE_PADDING_SIZE 32
347 #define AVFMT_NOFILE 0x0001
349 #define AVFMT_NEEDNUMBER 0x0002
350 #define AVFMT_SHOW_IDS 0x0008
351 #define AVFMT_RAWPICTURE 0x0020
353 #define AVFMT_GLOBALHEADER 0x0040
354 #define AVFMT_NOTIMESTAMPS 0x0080
355 #define AVFMT_GENERIC_INDEX 0x0100
356 #define AVFMT_TS_DISCONT 0x0200
357 #define AVFMT_VARIABLE_FPS 0x0400
358 #define AVFMT_NODIMENSIONS 0x0800
359 #define AVFMT_NOSTREAMS 0x1000
360 #define AVFMT_NOBINSEARCH 0x2000
361 #define AVFMT_NOGENSEARCH 0x4000
362 #define AVFMT_NO_BYTE_SEEK 0x8000
363 #define AVFMT_ALLOW_FLUSH 0x10000
364 #define AVFMT_TS_NONSTRICT 0x20000
372 typedef struct AVOutputFormat {
379 const char *long_name;
380 const char *mime_type;
381 const char *extensions;
437 int (*query_codec)(
enum AVCodecID id,
int std_compliance);
538 int stream_index, int64_t timestamp,
int flags);
545 int64_t *pos, int64_t pos_limit);
582 #define AVINDEX_KEYFRAME 0x0001
588 #define AV_DISPOSITION_DEFAULT 0x0001
589 #define AV_DISPOSITION_DUB 0x0002
590 #define AV_DISPOSITION_ORIGINAL 0x0004
591 #define AV_DISPOSITION_COMMENT 0x0008
592 #define AV_DISPOSITION_LYRICS 0x0010
593 #define AV_DISPOSITION_KARAOKE 0x0020
600 #define AV_DISPOSITION_FORCED 0x0040
601 #define AV_DISPOSITION_HEARING_IMPAIRED 0x0080
602 #define AV_DISPOSITION_VISUAL_IMPAIRED 0x0100
603 #define AV_DISPOSITION_CLEAN_EFFECTS 0x0200
610 #define AV_DISPOSITION_ATTACHED_PIC 0x0400
639 #if FF_API_R_FRAME_RATE
723 #define MAX_STD_TIMEBASES (60*12+5)
725 #if FF_API_R_FRAME_RATE
727 int64_t duration_gcd;
763 #define MAX_PROBE_PACKETS 2500
780 #define MAX_REORDER_DELAY 16
789 #define AV_PROGRAM_RUNNING 1
806 #define AVFMTCTX_NOHEADER 0x0001
809 typedef struct AVChapter {
902 #define AVFMT_FLAG_GENPTS 0x0001
903 #define AVFMT_FLAG_IGNIDX 0x0002
904 #define AVFMT_FLAG_NONBLOCK 0x0004
905 #define AVFMT_FLAG_IGNDTS 0x0008
906 #define AVFMT_FLAG_NOFILLIN 0x0010
907 #define AVFMT_FLAG_NOPARSE 0x0020
908 #define AVFMT_FLAG_NOBUFFER 0x0040
909 #define AVFMT_FLAG_CUSTOM_IO 0x0080
910 #define AVFMT_FLAG_DISCARD_CORRUPT 0x0100
1007 #define FF_FDEBUG_TS 0x0001
1043 #define RAW_PACKET_BUFFER_SIZE 2500000
1212 const char *filename,
void *logctx,
1213 unsigned int offset,
unsigned int max_probe_size);
1285 int wanted_stream_nb,
1290 #if FF_API_READ_PACKET
1389 #if FF_API_CLOSE_INPUT_FILE
1409 #define AVSEEK_FLAG_BACKWARD 1
1410 #define AVSEEK_FLAG_BYTE 2
1411 #define AVSEEK_FLAG_ANY 4
1412 #define AVSEEK_FLAG_FRAME 8
1481 #if FF_API_INTERLEAVE_PACKET
1515 const char *filename,
1516 const char *mime_type);
1522 const char *filename,
const char *mime_type,
1649 char *authorization,
int authorization_size,
1650 char *hostname,
int hostname_size,
1652 char *path,
int path_size,
1674 const char *path,
int number);
1709 int av_match_ext(
const char *filename,
const char *extensions);
struct AVOutputFormat AVOutputFormat
unsigned int max_index_size
Maximum amount of memory in bytes to use for the index of each stream.
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.
struct AVInputFormat AVInputFormat
int64_t start_time_realtime
Start time of the stream in real world time, in microseconds since the unix epoch (00:00 1st January ...
int av_interleaved_write_frame(AVFormatContext *s, AVPacket *pkt)
Write a packet to an output media file ensuring correct interleaving.
AVIOInterruptCB interrupt_callback
Custom interrupt callbacks for the I/O layer.
int av_add_index_entry(AVStream *st, int64_t pos, int64_t timestamp, int size, int distance, int flags)
Add an index entry into a sorted list.
int avformat_write_header(AVFormatContext *s, AVDictionary **options)
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 avformat_open_input(AVFormatContext **ps, const char *filename, AVInputFormat *fmt, AVDictionary **options)
Open an input stream and read the header.
int avformat_query_codec(AVOutputFormat *ofmt, enum AVCodecID codec_id, int std_compliance)
Test if the given container can store a codec.
int64_t pts_buffer[MAX_REORDER_DELAY+1]
unsigned int max_picture_buffer
Maximum amount of memory in bytes to use for buffering frames obtained from realtime capture devices...
AVRational sample_aspect_ratio
sample aspect ratio (0 if unknown)
int index
stream index in AVFormatContext
AVIndexEntry * index_entries
Only used if the format does not support seeking natively.
void av_pkt_dump2(FILE *f, AVPacket *pkt, int dump_payload, AVStream *st)
Send a nice dump of a packet to the specified file stream.
int64_t data_offset
offset of the first packet
struct AVStream::@75 * info
int ctx_flags
Format-specific flags, see AVFMTCTX_xx.
enum AVCodecID subtitle_codec_id
Forced subtitle codec_id.
struct AVPacketList * packet_buffer
This buffer is only needed when packets were already buffered but not decoded, for example to get the...
unsigned int nb_stream_indexes
const struct AVCodecTag * avformat_get_riff_video_tags(void)
enum AVCodecID av_codec_get_id(const struct AVCodecTag *const *tags, unsigned int tag)
Get the AVCodecID for the given codec tag tag.
unsigned avformat_version(void)
Return the LIBAVFORMAT_VERSION_INT constant.
const char * avformat_license(void)
Return the libavformat license.
enum AVStreamParseType need_parsing
int id
Format-specific stream ID.
AVFormatContext * avformat_alloc_context(void)
Allocate an AVFormatContext.
const char * avformat_configuration(void)
Return the libavformat build-time configuration.
AVProgram * av_new_program(AVFormatContext *s, int id)
int avformat_network_init(void)
Do global initialization of network components.
const struct AVCodecTag * avformat_get_riff_audio_tags(void)
int fps_probe_size
decoding: number of frames used to probe fps
int av_sdp_create(AVFormatContext *ac[], int n_files, char *buf, int size)
Generate an SDP for an RTP session.
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.
const AVClass * avformat_get_class(void)
Get the AVClass for AVFormatContext.
enum AVDiscard discard
selects which program to discard and which to feed to the caller
static int interleave_packet(AVFormatContext *s, AVPacket *out, AVPacket *in, int flush)
Interleave an AVPacket correctly so it can be muxed.
unsigned int * stream_index
enum AVCodecID video_codec_id
Forced video codec_id.
struct AVOutputFormat * oformat
struct AVPacketList * raw_packet_buffer
Raw packets from the demuxer, prior to parsing and decoding.
void av_dump_format(AVFormatContext *ic, int index, const char *url, int is_output)
Callback for checking whether to abort blocking functions.
int av_find_best_stream(AVFormatContext *ic, enum AVMediaType type, int wanted_stream_nb, int related_stream, AVCodec **decoder_ret, int flags)
Find the "best" stream in the file.
AVCodecID
Identify the syntax and semantics of the bitstream.
int av_index_search_timestamp(AVStream *st, int64_t timestamp, int flags)
Get the index for a specific 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_read_play(AVFormatContext *s)
Start playing a network-based stream (e.g.
AVStream * avformat_new_stream(AVFormatContext *s, AVCodec *c)
Add a new stream to a media file.
AVRational avg_frame_rate
Average framerate.
New fields can be added to the end with minor version bumps.
AVInputFormat * av_probe_input_format2(AVProbeData *pd, int is_opened, int *score_max)
Guess the file format.
int min_distance
Minimum distance between this and the previous keyframe, used to avoid unneeded searching.
The exact value of the fractional number is: 'val + num / den'.
AVCodecContext * codec
Codec context associated with this stream.
static float distance(float x, float y, int band)
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.
unsigned int nb_streams
A list of all streams in the file.
int64_t fps_first_dts
Those are used for average framerate estimation.
int av_read_pause(AVFormatContext *s)
Pause a network-based stream (e.g.
AVInputFormat * av_find_input_format(const char *short_name)
Find AVInputFormat based on the short name of the input format.
char filename[1024]
input or output filename
enum AVCodecID audio_codec_id
Forced audio codec_id.
enum AVCodecID av_guess_codec(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.
int av_find_default_stream_index(AVFormatContext *s)
int av_probe_input_buffer(AVIOContext *pb, AVInputFormat **fmt, const char *filename, void *logctx, unsigned int offset, unsigned int max_probe_size)
Probe a bytestream to determine the input format.
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...
void av_register_input_format(AVInputFormat *format)
unsigned int probesize
decoding: size of data to probe; encoding: unused.
int av_get_frame_filename(char *buf, int buf_size, const char *path, int number)
Return in 'buf' the path with 'd' replaced by a number.
AVOutputFormat * av_oformat_next(AVOutputFormat *f)
If f is NULL, returns the first registered output format, if f is non-NULL, returns the next register...
int raw_packet_buffer_remaining_size
void av_register_output_format(AVOutputFormat *format)
int avformat_network_deinit(void)
Undo the initialization done by avformat_network_init.
int debug
Flags to enable debugging.
AVIOContext * pb
I/O context.
int64_t reference_dts
Timestamp corresponding to the last dts sync point.
main external API structure.
int av_filename_number_test(const char *filename)
Check whether filename actually is a numbered sequence generator.
Describe the class of an AVClass context structure.
rational number numerator/denominator
struct AVPacketList * packet_buffer_end
const AVClass * av_class
A class for logging and AVOptions.
void avformat_free_context(AVFormatContext *s)
Free an AVFormatContext and all its streams.
This structure contains the data a format has to probe a file.
int av_read_frame(AVFormatContext *s, AVPacket *pkt)
Return the next frame of a stream.
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.
struct AVPacketList * parse_queue_end
struct AVPacketList * parse_queue
Packets split by the parser get queued here.
int64_t start_time
Decoding: position of the first frame of the component, in AV_TIME_BASE fractional seconds...
int av_seek_frame(AVFormatContext *s, int stream_index, int64_t timestamp, int flags)
Seek to the keyframe at timestamp.
int64_t duration
Decoding: duration of the stream, in stream time base.
const OptionDef options[]
struct AVPacketList * next
int avformat_find_stream_info(AVFormatContext *ic, AVDictionary **options)
Read packets of a media file to get stream information.
static av_cold void flush(AVCodecContext *avctx)
Flush (reset) the frame ID after seeking.
int64_t start_time
Decoding: pts of the first frame of the stream, in stream time base.
int error_recognition
Error recognition; higher values will detect more errors but may misdetect some more or less valid pa...
int disposition
AV_DISPOSITION_* bit field.
int pts_wrap_bits
number of bits in pts (used for wrapping control)
int64_t nb_frames
number of frames in this stream if known or 0
int max_analyze_duration
decoding: maximum time (in AV_TIME_BASE units) during which the input should be analyzed in avformat_...
struct AVInputFormat * iformat
Can only be iformat or oformat, not both at the same time.
void avformat_close_input(AVFormatContext **s)
Close an opened input AVFormatContext.
AVInputFormat * av_iformat_next(AVInputFormat *f)
If f is NULL, returns the first registered input format, if f is non-NULL, returns the next registere...
unsigned int index_entries_allocated_size
struct AVCodecParserContext * parser
void * priv_data
Format private data.
int codec_info_nb_frames
Number of frames that have been demuxed during av_find_stream_info()
static void write_header(FFV1Context *f)
#define attribute_deprecated
int av_write_trailer(AVFormatContext *s)
Write the stream trailer to an output media file and free the file private data.
int bit_rate
Decoding: total stream bitrate in bit/s, 0 if not available.
int64_t duration
Decoding: duration of the stream, in AV_TIME_BASE fractional seconds.
void av_pkt_dump_log2(void *avcl, int level, AVPacket *pkt, int dump_payload, AVStream *st)
Send a nice dump of a packet to the log.
void av_hex_dump_log(void *avcl, int level, const uint8_t *buf, int size)
Send a nice hexadecimal dump of a buffer to the log.
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented...
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 AVDiscard discard
Selects which packets can be discarded at will and do not need to be demuxed.
AVInputFormat * av_probe_input_format(AVProbeData *pd, int is_opened)
Guess the file format.
struct AVPacketList * raw_packet_buffer_end
This structure stores compressed data.
void av_register_all(void)
Initialize libavformat and register all the muxers, demuxers and protocols.
AVPacket attached_pic
For streams with AV_DISPOSITION_ATTACHED_PIC disposition, this packet will contain the attached pictu...
struct AVPacketList * last_in_packet_buffer
last packet in packet_buffer for this stream when muxing.