2008-08-27 23:43:28 +00:00
|
|
|
/*
|
|
|
|
* copyright (c) 2001 Fabrice Bellard
|
|
|
|
*
|
|
|
|
* This file is part of FFmpeg.
|
|
|
|
*
|
|
|
|
* FFmpeg is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* FFmpeg is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with FFmpeg; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
*/
|
|
|
|
|
2008-08-31 07:39:47 +00:00
|
|
|
#ifndef AVFORMAT_INTERNAL_H
|
|
|
|
#define AVFORMAT_INTERNAL_H
|
2008-08-27 23:43:28 +00:00
|
|
|
|
2008-10-04 11:20:02 +00:00
|
|
|
#include <stdint.h>
|
2016-03-31 20:49:02 +00:00
|
|
|
|
|
|
|
#include "libavutil/bprint.h"
|
2008-12-03 16:47:07 +00:00
|
|
|
#include "avformat.h"
|
2014-11-17 21:08:15 +00:00
|
|
|
#include "os_support.h"
|
2008-10-04 11:20:02 +00:00
|
|
|
|
2010-08-19 14:50:40 +00:00
|
|
|
#define MAX_URL_SIZE 4096
|
|
|
|
|
2013-08-25 22:54:30 +00:00
|
|
|
/** size of probe buffer, for guessing file type from file contents */
|
|
|
|
#define PROBE_BUF_MIN 2048
|
2014-01-26 22:35:38 +00:00
|
|
|
#define PROBE_BUF_MAX (1 << 20)
|
2013-08-25 22:54:30 +00:00
|
|
|
|
2011-05-27 18:34:01 +00:00
|
|
|
#ifdef DEBUG
|
|
|
|
# define hex_dump_debug(class, buf, size) av_hex_dump_log(class, AV_LOG_DEBUG, buf, size)
|
|
|
|
#else
|
2015-05-06 22:56:02 +00:00
|
|
|
# define hex_dump_debug(class, buf, size) do { if (0) av_hex_dump_log(class, AV_LOG_DEBUG, buf, size); } while(0)
|
2011-05-27 18:34:01 +00:00
|
|
|
#endif
|
|
|
|
|
2010-05-22 16:01:32 +00:00
|
|
|
typedef struct AVCodecTag {
|
2012-08-05 09:11:04 +00:00
|
|
|
enum AVCodecID id;
|
2010-05-22 16:01:32 +00:00
|
|
|
unsigned int tag;
|
|
|
|
} AVCodecTag;
|
|
|
|
|
2011-01-19 09:21:29 +00:00
|
|
|
typedef struct CodecMime{
|
|
|
|
char str[32];
|
2012-08-05 09:11:04 +00:00
|
|
|
enum AVCodecID id;
|
2011-01-19 09:21:29 +00:00
|
|
|
} CodecMime;
|
|
|
|
|
2015-08-17 14:30:16 +00:00
|
|
|
/*************************************************/
|
|
|
|
/* fractional numbers for exact pts handling */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The exact value of the fractional number is: 'val + num / den'.
|
|
|
|
* num is assumed to be 0 <= num < den.
|
|
|
|
*/
|
|
|
|
typedef struct FFFrac {
|
|
|
|
int64_t val, num, den;
|
|
|
|
} FFFrac;
|
|
|
|
|
|
|
|
|
2014-01-20 12:59:06 +00:00
|
|
|
struct AVFormatInternal {
|
|
|
|
/**
|
|
|
|
* Number of streams relevant for interleaving.
|
|
|
|
* Muxing only.
|
|
|
|
*/
|
|
|
|
int nb_interleaved_streams;
|
2014-04-13 17:20:17 +00:00
|
|
|
|
2015-02-06 13:53:40 +00:00
|
|
|
/**
|
|
|
|
* This buffer is only needed when packets were already buffered but
|
|
|
|
* not decoded, for example to get the codec parameters in MPEG
|
|
|
|
* streams.
|
|
|
|
*/
|
2021-03-05 14:26:24 +00:00
|
|
|
struct PacketList *packet_buffer;
|
|
|
|
struct PacketList *packet_buffer_end;
|
2015-02-06 13:53:40 +00:00
|
|
|
|
|
|
|
/* av_seek_frame() support */
|
|
|
|
int64_t data_offset; /**< offset of the first packet */
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Raw packets from the demuxer, prior to parsing and decoding.
|
|
|
|
* This buffer is used for buffering packets until the codec can
|
|
|
|
* be identified, as parsing cannot be done without knowing the
|
|
|
|
* codec.
|
|
|
|
*/
|
2021-03-05 14:26:24 +00:00
|
|
|
struct PacketList *raw_packet_buffer;
|
|
|
|
struct PacketList *raw_packet_buffer_end;
|
2015-02-06 13:53:40 +00:00
|
|
|
/**
|
|
|
|
* Packets split by the parser get queued here.
|
|
|
|
*/
|
2021-03-05 14:26:24 +00:00
|
|
|
struct PacketList *parse_queue;
|
|
|
|
struct PacketList *parse_queue_end;
|
2021-03-18 04:23:54 +00:00
|
|
|
/**
|
|
|
|
* The generic code uses this as a temporary packet
|
|
|
|
* to parse packets; it may also be used for other means
|
|
|
|
* for short periods that are guaranteed not to overlap
|
|
|
|
* with calls to av_read_frame() (or ff_read_packet())
|
|
|
|
* or with each other.
|
2021-03-18 05:04:17 +00:00
|
|
|
* It may be used by demuxers as a replacement for
|
|
|
|
* stack packets (unless they call one of the aforementioned
|
|
|
|
* functions with their own AVFormatContext).
|
2021-03-18 04:23:54 +00:00
|
|
|
* Every user has to ensure that this packet is blank
|
|
|
|
* after using it.
|
|
|
|
*/
|
|
|
|
AVPacket *parse_pkt;
|
2021-01-30 18:04:24 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Used to hold temporary packets.
|
|
|
|
*/
|
|
|
|
AVPacket *pkt;
|
2015-02-06 13:53:40 +00:00
|
|
|
/**
|
|
|
|
* Remaining size available for raw_packet_buffer, in bytes.
|
|
|
|
*/
|
|
|
|
#define RAW_PACKET_BUFFER_SIZE 2500000
|
|
|
|
int raw_packet_buffer_remaining_size;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Offset to remap timestamps to be non-negative.
|
|
|
|
* Expressed in timebase units.
|
2015-02-11 01:13:46 +00:00
|
|
|
* @see AVStream.mux_ts_offset
|
2015-02-06 13:53:40 +00:00
|
|
|
*/
|
|
|
|
int64_t offset;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Timebase for the timestamp offset.
|
|
|
|
*/
|
|
|
|
AVRational offset_timebase;
|
2014-01-20 12:59:06 +00:00
|
|
|
|
2015-10-07 13:51:11 +00:00
|
|
|
#if FF_API_COMPUTE_PKT_FIELDS2
|
|
|
|
int missing_ts_warning;
|
|
|
|
#endif
|
2015-11-11 13:37:48 +00:00
|
|
|
|
2014-04-13 17:20:17 +00:00
|
|
|
int inject_global_side_data;
|
2015-05-05 10:44:20 +00:00
|
|
|
|
|
|
|
int avoid_negative_ts_use_pts;
|
2015-10-08 02:32:14 +00:00
|
|
|
|
2016-08-12 19:28:08 +00:00
|
|
|
/**
|
|
|
|
* Timestamp of the end of the shortest stream.
|
|
|
|
*/
|
|
|
|
int64_t shortest_end;
|
2016-06-25 03:02:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Whether or not avformat_init_output has already been called
|
|
|
|
*/
|
|
|
|
int initialized;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Whether or not avformat_init_output fully initialized streams
|
|
|
|
*/
|
|
|
|
int streams_initialized;
|
2017-01-28 16:25:27 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* ID3v2 tag useful for MP3 demuxing
|
|
|
|
*/
|
|
|
|
AVDictionary *id3v2_meta;
|
2017-05-23 11:36:38 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Prefer the codec framerate for avg_frame_rate computation.
|
|
|
|
*/
|
|
|
|
int prefer_codec_framerate;
|
2021-01-06 22:24:49 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set if chapter ids are strictly monotonic.
|
|
|
|
*/
|
|
|
|
int chapter_ids_monotonic;
|
2014-01-20 12:59:06 +00:00
|
|
|
};
|
|
|
|
|
2015-10-07 13:51:11 +00:00
|
|
|
struct AVStreamInternal {
|
|
|
|
/**
|
|
|
|
* Set to 1 if the codec allows reordering, so pts can be different
|
|
|
|
* from dts.
|
|
|
|
*/
|
|
|
|
int reorder;
|
2015-10-08 02:32:14 +00:00
|
|
|
|
|
|
|
/**
|
2020-04-18 08:49:54 +00:00
|
|
|
* bitstream filter to run on stream
|
2015-10-08 02:32:14 +00:00
|
|
|
* - encoding: Set by muxer using ff_stream_add_bitstream_filter
|
|
|
|
* - decoding: unused
|
|
|
|
*/
|
2020-04-18 08:49:54 +00:00
|
|
|
AVBSFContext *bsfc;
|
2015-10-08 02:32:14 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Whether or not check_bitstream should still be run on each packet
|
|
|
|
*/
|
|
|
|
int bitstream_checked;
|
2016-04-10 19:58:15 +00:00
|
|
|
|
lavf: replace AVStream.codec with AVStream.codecpar
Currently, AVStream contains an embedded AVCodecContext instance, which
is used by demuxers to export stream parameters to the caller and by
muxers to receive stream parameters from the caller. It is also used
internally as the codec context that is passed to parsers.
In addition, it is also widely used by the callers as the decoding (when
demuxer) or encoding (when muxing) context, though this has been
officially discouraged since Libav 11.
There are multiple important problems with this approach:
- the fields in AVCodecContext are in general one of
* stream parameters
* codec options
* codec state
However, it's not clear which ones are which. It is consequently
unclear which fields are a demuxer allowed to set or a muxer allowed to
read. This leads to erratic behaviour depending on whether decoding or
encoding is being performed or not (and whether it uses the AVStream
embedded codec context).
- various synchronization issues arising from the fact that the same
context is used by several different APIs (muxers/demuxers,
parsers, bitstream filters and encoders/decoders) simultaneously, with
there being no clear rules for who can modify what and the different
processes being typically delayed with respect to each other.
- avformat_find_stream_info() making it necessary to support opening
and closing a single codec context multiple times, thus
complicating the semantics of freeing various allocated objects in the
codec context.
Those problems are resolved by replacing the AVStream embedded codec
context with a newly added AVCodecParameters instance, which stores only
the stream parameters exported by the demuxers or read by the muxers.
2014-06-18 18:42:52 +00:00
|
|
|
/**
|
|
|
|
* The codec context used by avformat_find_stream_info, the parser, etc.
|
|
|
|
*/
|
|
|
|
AVCodecContext *avctx;
|
|
|
|
/**
|
|
|
|
* 1 if avctx has been initialized with the values from the codec parameters
|
|
|
|
*/
|
|
|
|
int avctx_inited;
|
|
|
|
|
|
|
|
enum AVCodecID orig_codec_id;
|
|
|
|
|
2017-03-24 21:42:19 +00:00
|
|
|
/* the context for extracting extradata in find_stream_info()
|
|
|
|
* inited=1/bsf=NULL signals that extracting is not possible (codec not
|
|
|
|
* supported) */
|
|
|
|
struct {
|
|
|
|
AVBSFContext *bsf;
|
|
|
|
int inited;
|
|
|
|
} extract_extradata;
|
|
|
|
|
2016-04-10 19:58:15 +00:00
|
|
|
/**
|
|
|
|
* Whether the internal avctx needs to be updated from codecpar (after a late change to codecpar)
|
|
|
|
*/
|
|
|
|
int need_context_update;
|
2017-11-05 17:59:47 +00:00
|
|
|
|
avformat/mux: Set AV_PKT_FLAG_KEY for is_intra_only packet
The patch will make audio and subtitle packets be marked as AV_PKT_FLAG_KEY.
For audio, it'll caused the audio sample to be sync sample.
To verify ref/fate/movenc results:
1. Get the movenc test data
[lmwang@vpn ffmpeg]$ libavformat/tests/movenc -w && mkdir -p audio_old && mv *.mp4 audio_old_
After applied the patch:
[lmwang@vpn ffmpeg]$ make fate-movenc SAMPLES=../fate-suite
[lmwang@vpn ffmpeg]$ libavformat/tests/movenc -w && mkdir -p audio_key && mv *.mp4 audio_key
2. Get l-smash and build boxdumper
https://github.com/l-smash/l-smash.git
3. dump the box of crc change mp4 and diff -u
[lmwang@vpn ffmpeg]$ ../l-smash/cli/boxdumper --box audio_key/non-empty-moov-no-elst.mp4 > audio_key/non-empty-moov-no-elst.log
[lmwang@vpn ffmpeg]$ ../l-smash/cli/boxdumper --box audio_old/non-empty-moov-no-elst.mp4 > audio_old/non-empty-moov-no-elst.log
[lmwang@vpn ffmpeg]$ diff -u audio_key/non-empty-moov-no-elst.log audio_old/non-empty-moov-no-elst.log
- default_sample_flags = 0x02000000
- independent
- sync sample
+ default_sample_flags = 0x01010000
+ dependent
+ non-sync sample
4. have checked the change of crc are caused by default_sample_flags
non-empty-moov.mp4, non-empty-moov-elst.mp4,
non-empty-moov-no-elst.mp4, empty-moov.mp4, delay-moov-content.mp4,
empty-moov-second-frag.mp4, empty-moov-second-frag-discont.mp4,
delay-moov-second-frag-discont.mp4, delay-moov-elst-second-frag.mp4
etc
5 For subtitle, it'll effect for tests/ref/fate/binsub-movtextenc and
tests/ref/fate/sub2video, that's expecting result for the subtitle is
marked as keyframe. Below is the checking result of binsub-movtextenc:
[lmwang@vpn ffmpeg]$ ./ffmpeg -i ../fate-suite/sub/MovText_capability_tester.mp4 -map 0 -scodec mov_text -f mp4 -flags +bitexact -fflags +bitexact -movflags frag_keyframe+empty_moov audio_key/binsub-movtextenc.mp4
[lmwang@vpn ffmpeg]$ ./ffmpeg -i ../fate-suite/sub/MovText_capability_tester.mp4 -map 0 -scodec mov_text -f mp4 -flags +bitexact -fflags +bitexact -movflags frag_keyframe+empty_moov audio_old/binsub-movtextenc.mp4
[lmwang@vpn ffmpeg]$../l-smash/cli/boxdumper audio_key/binsub-movtextenc.mp4 > audio_key/binsub-movtextenc.log
[lmwang@vpn ffmpeg]$../l-smash/cli/boxdumper audio_old/binsub-movtextenc.mp4 > audio_old/binsub-movtextenc.log
[lmwang@vpn ffmpeg]$ diff -u audio_key/binsub-movtextenc.log audio_old/binsub-movtextenc.log
.... // the key difference is the flag for sync sample
- flags = 0x000701
+ flags = 0x000301
data-offset-present
sample-duration-present
sample-size-present
- sample-flags-present
sample_count = 6
- data_offset = 188
+ data_offset = 164
sample[0]
sample_duration = 1570000
sample_size = 21
- sample_flags = 0x02000000
- independent
- sync sample
- degradation_priority = 0
sample[1]
sample_duration = 510000
sample_size = 2
- sample_flags = 0x01010000
- dependent
- non-sync sample
- degradation_priority = 0
sample[2]
sample_duration = 1690000
sample_size = 9
- sample_flags = 0x02000000
- independent
- sync sample
- degradation_priority = 0
Suggested-by: Andreas Rheinhardt <andreas.rheinhardt@gmail.com>
Suggested-by: Nicolas George <george@nsup.org>
Signed-off-by: Limin Wang <lance.lmwang@gmail.com>
2020-04-21 15:35:24 +00:00
|
|
|
int is_intra_only;
|
|
|
|
|
2017-11-05 17:59:47 +00:00
|
|
|
FFFrac *priv_pts;
|
2020-10-09 06:15:27 +00:00
|
|
|
|
|
|
|
#define MAX_STD_TIMEBASES (30*12+30+3+6)
|
|
|
|
/**
|
|
|
|
* Stream information used internally by avformat_find_stream_info()
|
|
|
|
*/
|
|
|
|
struct {
|
|
|
|
int64_t last_dts;
|
|
|
|
int64_t duration_gcd;
|
|
|
|
int duration_count;
|
|
|
|
int64_t rfps_duration_sum;
|
|
|
|
double (*duration_error)[2][MAX_STD_TIMEBASES];
|
|
|
|
int64_t codec_info_duration;
|
|
|
|
int64_t codec_info_duration_fields;
|
|
|
|
int frame_delay_evidence;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* 0 -> decoder has not been searched for yet.
|
|
|
|
* >0 -> decoder found
|
|
|
|
* <0 -> decoder with codec_id == -found_decoder has not been found
|
|
|
|
*/
|
|
|
|
int found_decoder;
|
|
|
|
|
|
|
|
int64_t last_duration;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Those are used for average framerate estimation.
|
|
|
|
*/
|
|
|
|
int64_t fps_first_dts;
|
|
|
|
int fps_first_dts_idx;
|
|
|
|
int64_t fps_last_dts;
|
|
|
|
int fps_last_dts_idx;
|
|
|
|
|
|
|
|
} *info;
|
2020-10-09 07:22:36 +00:00
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
AVIndexEntry *index_entries; /**< Only used if the format does not
|
|
|
|
support seeking natively. */
|
|
|
|
int nb_index_entries;
|
|
|
|
unsigned int index_entries_allocated_size;
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
int64_t interleaver_chunk_size;
|
|
|
|
int64_t interleaver_chunk_duration;
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
/**
|
|
|
|
* stream probing state
|
|
|
|
* -1 -> probing finished
|
|
|
|
* 0 -> no probing requested
|
|
|
|
* rest -> perform probing with request_probe being the minimum score to accept.
|
|
|
|
*/
|
|
|
|
int request_probe;
|
|
|
|
/**
|
|
|
|
* Indicates that everything up to the next keyframe
|
|
|
|
* should be discarded.
|
|
|
|
*/
|
|
|
|
int skip_to_keyframe;
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
/**
|
|
|
|
* Number of samples to skip at the start of the frame decoded from the next packet.
|
|
|
|
*/
|
|
|
|
int skip_samples;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* If not 0, the number of samples that should be skipped from the start of
|
|
|
|
* the stream (the samples are removed from packets with pts==0, which also
|
|
|
|
* assumes negative timestamps do not happen).
|
|
|
|
* Intended for use with formats such as mp3 with ad-hoc gapless audio
|
|
|
|
* support.
|
|
|
|
*/
|
|
|
|
int64_t start_skip_samples;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* If not 0, the first audio sample that should be discarded from the stream.
|
|
|
|
* This is broken by design (needs global sample count), but can't be
|
|
|
|
* avoided for broken by design formats such as mp3 with ad-hoc gapless
|
|
|
|
* audio support.
|
|
|
|
*/
|
|
|
|
int64_t first_discard_sample;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The sample after last sample that is intended to be discarded after
|
|
|
|
* first_discard_sample. Works on frame boundaries only. Used to prevent
|
|
|
|
* early EOF if the gapless info is broken (considered concatenated mp3s).
|
|
|
|
*/
|
|
|
|
int64_t last_discard_sample;
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
/**
|
|
|
|
* Number of internally decoded frames, used internally in libavformat, do not access
|
|
|
|
* its lifetime differs from info which is why it is not in that structure.
|
|
|
|
*/
|
|
|
|
int nb_decoded_frames;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Timestamp offset added to timestamps before muxing
|
|
|
|
*/
|
|
|
|
int64_t mux_ts_offset;
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
/**
|
|
|
|
* Internal data to check for wrapping of the time stamp
|
|
|
|
*/
|
|
|
|
int64_t pts_wrap_reference;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Options for behavior, when a wrap is detected.
|
|
|
|
*
|
|
|
|
* Defined by AV_PTS_WRAP_ values.
|
|
|
|
*
|
|
|
|
* If correction is enabled, there are two possibilities:
|
|
|
|
* If the first time stamp is near the wrap point, the wrap offset
|
|
|
|
* will be subtracted, which will create negative time stamps.
|
|
|
|
* Otherwise the offset will be added.
|
|
|
|
*/
|
|
|
|
int pts_wrap_behavior;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Internal data to prevent doing update_initial_durations() twice
|
|
|
|
*/
|
|
|
|
int update_initial_durations_done;
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
#define MAX_REORDER_DELAY 16
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
/**
|
|
|
|
* Internal data to generate dts from pts
|
|
|
|
*/
|
|
|
|
int64_t pts_reorder_error[MAX_REORDER_DELAY+1];
|
|
|
|
uint8_t pts_reorder_error_count[MAX_REORDER_DELAY+1];
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
int64_t pts_buffer[MAX_REORDER_DELAY+1];
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
/**
|
|
|
|
* Internal data to analyze DTS and detect faulty mpeg streams
|
|
|
|
*/
|
|
|
|
int64_t last_dts_for_order_check;
|
|
|
|
uint8_t dts_ordered;
|
|
|
|
uint8_t dts_misordered;
|
|
|
|
|
2020-10-09 07:22:36 +00:00
|
|
|
/**
|
|
|
|
* Internal data to inject global side data
|
|
|
|
*/
|
|
|
|
int inject_global_side_data;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* display aspect ratio (0 if unknown)
|
|
|
|
* - encoding: unused
|
|
|
|
* - decoding: Set by libavformat to calculate sample_aspect_ratio internally
|
|
|
|
*/
|
|
|
|
AVRational display_aspect_ratio;
|
2020-10-09 07:22:36 +00:00
|
|
|
|
|
|
|
AVProbeData probe_data;
|
2020-10-09 07:22:36 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* last packet in packet_buffer for this stream when muxing.
|
|
|
|
*/
|
2021-03-05 14:26:24 +00:00
|
|
|
struct PacketList *last_in_packet_buffer;
|
2014-01-20 12:59:06 +00:00
|
|
|
};
|
|
|
|
|
2010-04-11 21:44:23 +00:00
|
|
|
#ifdef __GNUC__
|
|
|
|
#define dynarray_add(tab, nb_ptr, elem)\
|
|
|
|
do {\
|
|
|
|
__typeof__(tab) _tab = (tab);\
|
|
|
|
__typeof__(elem) _elem = (elem);\
|
|
|
|
(void)sizeof(**_tab == _elem); /* check that types are compatible */\
|
2011-04-29 15:33:38 +00:00
|
|
|
av_dynarray_add(_tab, nb_ptr, _elem);\
|
2010-04-11 21:44:23 +00:00
|
|
|
} while(0)
|
|
|
|
#else
|
|
|
|
#define dynarray_add(tab, nb_ptr, elem)\
|
|
|
|
do {\
|
2011-04-29 15:33:38 +00:00
|
|
|
av_dynarray_add((tab), nb_ptr, (elem));\
|
2010-04-11 21:44:23 +00:00
|
|
|
} while(0)
|
|
|
|
#endif
|
|
|
|
|
2018-09-22 14:10:09 +00:00
|
|
|
/**
|
|
|
|
* Automatically create sub-directories
|
|
|
|
*
|
|
|
|
* @param path will create sub-directories by path
|
|
|
|
* @return 0, or < 0 on error
|
|
|
|
*/
|
|
|
|
int ff_mkdir_p(const char *path);
|
2010-04-11 21:44:23 +00:00
|
|
|
|
2010-03-25 07:13:20 +00:00
|
|
|
char *ff_data_to_hex(char *buf, const uint8_t *src, int size, int lowercase);
|
2008-08-27 23:43:28 +00:00
|
|
|
|
2010-08-09 10:05:33 +00:00
|
|
|
/**
|
|
|
|
* Parse a string of hexadecimal strings. Any space between the hexadecimal
|
|
|
|
* digits is ignored.
|
|
|
|
*
|
|
|
|
* @param data if non-null, the parsed data is written to this pointer
|
|
|
|
* @param p the string to parse
|
|
|
|
* @return the number of bytes written (or to be written, if data is null)
|
|
|
|
*/
|
|
|
|
int ff_hex_to_data(uint8_t *data, const char *p);
|
|
|
|
|
2009-02-08 21:14:46 +00:00
|
|
|
/**
|
2020-04-11 11:37:24 +00:00
|
|
|
* Add packet to an AVFormatContext's packet_buffer list, determining its
|
2009-02-08 21:14:46 +00:00
|
|
|
* interleaved position using compare() function argument.
|
2020-04-11 11:37:24 +00:00
|
|
|
* @return 0 on success, < 0 on error. pkt will always be blank on return.
|
2009-02-08 21:14:46 +00:00
|
|
|
*/
|
2011-11-08 09:35:14 +00:00
|
|
|
int ff_interleave_add_packet(AVFormatContext *s, AVPacket *pkt,
|
2019-08-13 02:47:16 +00:00
|
|
|
int (*compare)(AVFormatContext *, const AVPacket *, const AVPacket *));
|
2009-02-08 21:14:46 +00:00
|
|
|
|
2010-03-15 23:15:24 +00:00
|
|
|
void ff_read_frame_flush(AVFormatContext *s);
|
2010-03-06 23:19:05 +00:00
|
|
|
|
2010-03-15 10:36:30 +00:00
|
|
|
#define NTP_OFFSET 2208988800ULL
|
|
|
|
#define NTP_OFFSET_US (NTP_OFFSET * 1000000ULL)
|
|
|
|
|
2010-06-30 15:38:06 +00:00
|
|
|
/** Get the current time since NTP epoch in microseconds. */
|
2020-01-16 19:25:26 +00:00
|
|
|
uint64_t ff_ntp_time(void);
|
2010-03-10 22:21:39 +00:00
|
|
|
|
2018-05-07 09:57:36 +00:00
|
|
|
/**
|
|
|
|
* Get the NTP time stamp formatted as per the RFC-5905.
|
|
|
|
*
|
|
|
|
* @param ntp_time NTP time in micro seconds (since NTP epoch)
|
|
|
|
* @return the formatted NTP time stamp
|
|
|
|
*/
|
|
|
|
uint64_t ff_get_formatted_ntp_time(uint64_t ntp_time_us);
|
|
|
|
|
2021-03-23 21:29:48 +00:00
|
|
|
/**
|
|
|
|
* Parse the NTP time in micro seconds (since NTP epoch).
|
|
|
|
*
|
|
|
|
* @param ntp_ts NTP time stamp formatted as per the RFC-5905.
|
|
|
|
* @return the time in micro seconds (since NTP epoch)
|
|
|
|
*/
|
|
|
|
uint64_t ff_parse_ntp_time(uint64_t ntp_ts);
|
|
|
|
|
2010-05-18 19:32:59 +00:00
|
|
|
/**
|
2010-06-30 15:38:06 +00:00
|
|
|
* Append the media-specific SDP fragment for the media stream c
|
2010-05-18 19:32:59 +00:00
|
|
|
* to the buffer buff.
|
|
|
|
*
|
|
|
|
* Note, the buffer needs to be initialized, since it is appended to
|
|
|
|
* existing content.
|
|
|
|
*
|
|
|
|
* @param buff the buffer to append the SDP fragment to
|
|
|
|
* @param size the size of the buff buffer
|
2012-11-11 19:44:28 +00:00
|
|
|
* @param st the AVStream of the media to describe
|
|
|
|
* @param idx the global stream index
|
2010-05-18 19:32:59 +00:00
|
|
|
* @param dest_addr the destination address of the media stream, may be NULL
|
2010-08-25 12:29:32 +00:00
|
|
|
* @param dest_type the destination address type, may be NULL
|
2010-05-18 19:32:59 +00:00
|
|
|
* @param port the destination port of the media stream, 0 if unknown
|
|
|
|
* @param ttl the time to live of the stream, 0 if not multicast
|
2011-05-18 12:41:06 +00:00
|
|
|
* @param fmt the AVFormatContext, which might contain options modifying
|
|
|
|
* the generated SDP
|
2010-05-18 19:32:59 +00:00
|
|
|
*/
|
2012-11-11 19:44:28 +00:00
|
|
|
void ff_sdp_write_media(char *buff, int size, AVStream *st, int idx,
|
2010-08-25 12:29:32 +00:00
|
|
|
const char *dest_addr, const char *dest_type,
|
2011-05-18 12:41:06 +00:00
|
|
|
int port, int ttl, AVFormatContext *fmt);
|
2010-05-18 19:32:59 +00:00
|
|
|
|
2010-05-21 07:07:57 +00:00
|
|
|
/**
|
|
|
|
* Write a packet to another muxer than the one the user originally
|
|
|
|
* intended. Useful when chaining muxers, where one muxer internally
|
|
|
|
* writes a received packet to another muxer.
|
|
|
|
*
|
|
|
|
* @param dst the muxer to write the packet to
|
|
|
|
* @param dst_stream the stream index within dst to write the packet to
|
|
|
|
* @param pkt the packet to be written
|
|
|
|
* @param src the muxer the packet originally was intended for
|
2015-02-08 16:09:01 +00:00
|
|
|
* @param interleave 0->use av_write_frame, 1->av_interleaved_write_frame
|
2010-05-21 07:07:57 +00:00
|
|
|
* @return the value av_write_frame returned
|
|
|
|
*/
|
|
|
|
int ff_write_chained(AVFormatContext *dst, int dst_stream, AVPacket *pkt,
|
2014-07-24 20:39:22 +00:00
|
|
|
AVFormatContext *src, int interleave);
|
2010-05-21 07:07:57 +00:00
|
|
|
|
2010-07-21 21:40:50 +00:00
|
|
|
/**
|
2011-02-20 10:04:12 +00:00
|
|
|
* Read a whole line of text from AVIOContext. Stop reading after reaching
|
2011-07-03 14:33:25 +00:00
|
|
|
* either a \\n, a \\0 or EOF. The returned string is always \\0-terminated,
|
2010-07-21 21:40:50 +00:00
|
|
|
* and may be truncated if the buffer is too small.
|
|
|
|
*
|
2011-02-20 10:04:12 +00:00
|
|
|
* @param s the read-only AVIOContext
|
2010-07-21 21:40:50 +00:00
|
|
|
* @param buf buffer to store the read line
|
|
|
|
* @param maxlen size of the buffer
|
|
|
|
* @return the length of the string written in the buffer, not including the
|
2011-07-03 14:33:25 +00:00
|
|
|
* final \\0
|
2010-07-21 21:40:50 +00:00
|
|
|
*/
|
2011-02-20 10:04:12 +00:00
|
|
|
int ff_get_line(AVIOContext *s, char *buf, int maxlen);
|
2010-07-21 21:39:01 +00:00
|
|
|
|
2018-04-09 15:05:42 +00:00
|
|
|
/**
|
|
|
|
* Same as ff_get_line but strip the white-space characters in the text tail
|
|
|
|
*
|
|
|
|
* @param s the read-only AVIOContext
|
|
|
|
* @param buf buffer to store the read line
|
|
|
|
* @param maxlen size of the buffer
|
|
|
|
* @return the length of the string written in the buffer
|
|
|
|
*/
|
|
|
|
int ff_get_chomp_line(AVIOContext *s, char *buf, int maxlen);
|
|
|
|
|
2018-02-03 21:03:58 +00:00
|
|
|
/**
|
|
|
|
* Read a whole line of text from AVIOContext to an AVBPrint buffer. Stop
|
|
|
|
* reading after reaching a \\r, a \\n, a \\r\\n, a \\0 or EOF. The line
|
|
|
|
* ending characters are NOT included in the buffer, but they are skipped on
|
|
|
|
* the input.
|
|
|
|
*
|
|
|
|
* @param s the read-only AVIOContext
|
|
|
|
* @param bp the AVBPrint buffer
|
|
|
|
* @return the length of the read line, not including the line endings,
|
|
|
|
* negative on error.
|
|
|
|
*/
|
|
|
|
int64_t ff_read_line_to_bprint(AVIOContext *s, AVBPrint *bp);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Read a whole line of text from AVIOContext to an AVBPrint buffer overwriting
|
|
|
|
* its contents. Stop reading after reaching a \\r, a \\n, a \\r\\n, a \\0 or
|
|
|
|
* EOF. The line ending characters are NOT included in the buffer, but they
|
|
|
|
* are skipped on the input.
|
|
|
|
*
|
|
|
|
* @param s the read-only AVIOContext
|
|
|
|
* @param bp the AVBPrint buffer
|
|
|
|
* @return the length of the read line not including the line endings,
|
|
|
|
* negative on error, or if the buffer becomes truncated.
|
|
|
|
*/
|
|
|
|
int64_t ff_read_line_to_bprint_overwrite(AVIOContext *s, AVBPrint *bp);
|
|
|
|
|
2010-07-16 14:12:52 +00:00
|
|
|
#define SPACE_CHARS " \t\r\n"
|
|
|
|
|
2010-08-19 14:49:53 +00:00
|
|
|
/**
|
|
|
|
* Callback function type for ff_parse_key_value.
|
|
|
|
*
|
|
|
|
* @param key a pointer to the key
|
|
|
|
* @param key_len the number of bytes that belong to the key, including the '='
|
|
|
|
* char
|
|
|
|
* @param dest return the destination pointer for the value in *dest, may
|
|
|
|
* be null to ignore the value
|
|
|
|
* @param dest_len the length of the *dest buffer
|
|
|
|
*/
|
|
|
|
typedef void (*ff_parse_key_val_cb)(void *context, const char *key,
|
|
|
|
int key_len, char **dest, int *dest_len);
|
|
|
|
/**
|
|
|
|
* Parse a string with comma-separated key=value pairs. The value strings
|
|
|
|
* may be quoted and may contain escaped characters within quoted strings.
|
|
|
|
*
|
|
|
|
* @param str the string to parse
|
|
|
|
* @param callback_get_buf function that returns where to store the
|
|
|
|
* unescaped value string.
|
|
|
|
* @param context the opaque context pointer to pass to callback_get_buf
|
|
|
|
*/
|
|
|
|
void ff_parse_key_value(const char *str, ff_parse_key_val_cb callback_get_buf,
|
|
|
|
void *context);
|
|
|
|
|
2010-12-26 01:24:51 +00:00
|
|
|
/**
|
|
|
|
* Find stream index based on format-specific stream ID
|
|
|
|
* @return stream index, or < 0 on error
|
|
|
|
*/
|
|
|
|
int ff_find_stream_index(AVFormatContext *s, int id);
|
|
|
|
|
2011-01-22 09:03:22 +00:00
|
|
|
/**
|
|
|
|
* Internal version of av_index_search_timestamp
|
|
|
|
*/
|
|
|
|
int ff_index_search_timestamp(const AVIndexEntry *entries, int nb_entries,
|
|
|
|
int64_t wanted_timestamp, int flags);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Internal version of av_add_index_entry
|
|
|
|
*/
|
|
|
|
int ff_add_index_entry(AVIndexEntry **index_entries,
|
|
|
|
int *nb_index_entries,
|
|
|
|
unsigned int *index_entries_allocated_size,
|
|
|
|
int64_t pos, int64_t timestamp, int size, int distance, int flags);
|
|
|
|
|
2015-06-02 16:30:07 +00:00
|
|
|
void ff_configure_buffers_for_index(AVFormatContext *s, int64_t time_tolerance);
|
|
|
|
|
2011-02-06 14:38:55 +00:00
|
|
|
/**
|
|
|
|
* Add a new chapter.
|
|
|
|
*
|
|
|
|
* @param s media file handle
|
|
|
|
* @param id unique ID for this chapter
|
|
|
|
* @param start chapter start time in time_base units
|
|
|
|
* @param end chapter end time in time_base units
|
|
|
|
* @param title chapter title
|
|
|
|
*
|
|
|
|
* @return AVChapter or NULL on error
|
|
|
|
*/
|
2021-03-16 07:29:59 +00:00
|
|
|
#if FF_API_CHAPTER_ID_INT
|
2011-10-17 06:58:50 +00:00
|
|
|
AVChapter *avpriv_new_chapter(AVFormatContext *s, int id, AVRational time_base,
|
2021-03-16 07:29:59 +00:00
|
|
|
#else
|
|
|
|
AVChapter *avpriv_new_chapter(AVFormatContext *s, int64_t id, AVRational time_base,
|
|
|
|
#endif
|
2011-10-17 06:58:50 +00:00
|
|
|
int64_t start, int64_t end, const char *title);
|
2011-02-06 14:38:55 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Ensure the index uses less memory than the maximum specified in
|
|
|
|
* AVFormatContext.max_index_size by discarding entries if it grows
|
|
|
|
* too large.
|
|
|
|
*/
|
|
|
|
void ff_reduce_index(AVFormatContext *s, int stream_index);
|
|
|
|
|
2012-08-05 09:11:04 +00:00
|
|
|
enum AVCodecID ff_guess_image2_codec(const char *filename);
|
2011-04-05 11:13:53 +00:00
|
|
|
|
2011-10-16 13:03:30 +00:00
|
|
|
/**
|
|
|
|
* Perform a binary search using av_index_search_timestamp() and
|
|
|
|
* AVInputFormat.read_timestamp().
|
|
|
|
*
|
|
|
|
* @param target_ts target timestamp in the time base of the given stream
|
|
|
|
* @param stream_index stream number
|
|
|
|
*/
|
|
|
|
int ff_seek_frame_binary(AVFormatContext *s, int stream_index,
|
|
|
|
int64_t target_ts, int flags);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update cur_dts of all streams based on the given timestamp and AVStream.
|
|
|
|
*
|
|
|
|
* Stream ref_st unchanged, others set cur_dts in their native time base.
|
|
|
|
* Only needed for timestamp wrapping or if (dts not set and pts!=dts).
|
|
|
|
* @param timestamp new dts expressed in time_base of param ref_st
|
|
|
|
* @param ref_st reference stream giving time_base of param timestamp
|
|
|
|
*/
|
|
|
|
void ff_update_cur_dts(AVFormatContext *s, AVStream *ref_st, int64_t timestamp);
|
|
|
|
|
2013-07-06 19:52:07 +00:00
|
|
|
int ff_find_last_ts(AVFormatContext *s, int stream_index, int64_t *ts, int64_t *pos,
|
|
|
|
int64_t (*read_timestamp)(struct AVFormatContext *, int , int64_t *, int64_t ));
|
|
|
|
|
2011-10-16 13:03:30 +00:00
|
|
|
/**
|
|
|
|
* Perform a binary search using read_timestamp().
|
|
|
|
*
|
|
|
|
* @param target_ts target timestamp in the time base of the given stream
|
|
|
|
* @param stream_index stream number
|
|
|
|
*/
|
|
|
|
int64_t ff_gen_search(AVFormatContext *s, int stream_index,
|
|
|
|
int64_t target_ts, int64_t pos_min,
|
|
|
|
int64_t pos_max, int64_t pos_limit,
|
|
|
|
int64_t ts_min, int64_t ts_max,
|
|
|
|
int flags, int64_t *ts_ret,
|
|
|
|
int64_t (*read_timestamp)(struct AVFormatContext *, int , int64_t *, int64_t ));
|
|
|
|
|
2011-11-29 18:28:15 +00:00
|
|
|
/**
|
2012-12-16 20:29:12 +00:00
|
|
|
* Set the time base and wrapping info for a given stream. This will be used
|
|
|
|
* to interpret the stream's timestamps. If the new time base is invalid
|
|
|
|
* (numerator or denominator are non-positive), it leaves the stream
|
|
|
|
* unchanged.
|
2011-11-29 18:28:15 +00:00
|
|
|
*
|
|
|
|
* @param s stream
|
|
|
|
* @param pts_wrap_bits number of bits effectively used by the pts
|
2012-12-16 20:29:12 +00:00
|
|
|
* (used for wrap control)
|
|
|
|
* @param pts_num time base numerator
|
|
|
|
* @param pts_den time base denominator
|
2011-11-29 18:28:15 +00:00
|
|
|
*/
|
|
|
|
void avpriv_set_pts_info(AVStream *s, int pts_wrap_bits,
|
|
|
|
unsigned int pts_num, unsigned int pts_den);
|
|
|
|
|
2011-12-16 10:48:09 +00:00
|
|
|
/**
|
|
|
|
* Add side data to a packet for changing parameters to the given values.
|
|
|
|
* Parameters set to 0 aren't included in the change.
|
|
|
|
*/
|
|
|
|
int ff_add_param_change(AVPacket *pkt, int32_t channels,
|
|
|
|
uint64_t channel_layout, int32_t sample_rate,
|
|
|
|
int32_t width, int32_t height);
|
|
|
|
|
2012-02-02 13:20:43 +00:00
|
|
|
/**
|
|
|
|
* Set the timebase for each stream from the corresponding codec timebase and
|
|
|
|
* print it.
|
|
|
|
*/
|
2016-04-14 00:13:21 +00:00
|
|
|
int ff_framehash_write_header(AVFormatContext *s);
|
2012-02-02 13:20:43 +00:00
|
|
|
|
2012-03-04 20:41:59 +00:00
|
|
|
/**
|
|
|
|
* Read a transport packet from a media file.
|
|
|
|
*
|
|
|
|
* @param s media file handle
|
|
|
|
* @param pkt is filled
|
|
|
|
* @return 0 if OK, AVERROR_xxx on error
|
|
|
|
*/
|
|
|
|
int ff_read_packet(AVFormatContext *s, AVPacket *pkt);
|
|
|
|
|
2021-03-29 05:58:56 +00:00
|
|
|
/**
|
|
|
|
* Add an attached pic to an AVStream.
|
|
|
|
*
|
|
|
|
* @param st if set, the stream to add the attached pic to;
|
|
|
|
* if unset, a new stream will be added to s.
|
|
|
|
* @param pb AVIOContext to read data from if buf is unset.
|
|
|
|
* @param buf if set, it contains the data and size information to be used
|
|
|
|
* for the attached pic; if unset, data is read from pb.
|
|
|
|
* @param size the size of the data to read if buf is unset.
|
2021-03-29 06:50:18 +00:00
|
|
|
*
|
|
|
|
* @return 0 on success, < 0 on error. On error, this function removes
|
|
|
|
* the stream it has added (if any).
|
2021-03-29 05:58:56 +00:00
|
|
|
*/
|
|
|
|
int ff_add_attached_pic(AVFormatContext *s, AVStream *st, AVIOContext *pb,
|
|
|
|
AVBufferRef **buf, int size);
|
|
|
|
|
2012-03-15 12:37:43 +00:00
|
|
|
/**
|
2020-04-11 11:48:50 +00:00
|
|
|
* Interleave an AVPacket per dts so it can be muxed.
|
2012-03-15 12:37:43 +00:00
|
|
|
*
|
2020-04-11 11:48:50 +00:00
|
|
|
* @param s an AVFormatContext for output. pkt resp. out will be added to
|
|
|
|
* resp. taken from its packet buffer.
|
2012-03-15 12:37:43 +00:00
|
|
|
* @param out the interleaved packet will be output here
|
2020-04-11 11:48:50 +00:00
|
|
|
* @param pkt the input packet; will be blank on return if not NULL
|
2012-03-15 12:37:43 +00:00
|
|
|
* @param flush 1 if no further packets are available as input and all
|
|
|
|
* remaining packets should be output
|
2020-03-31 07:54:11 +00:00
|
|
|
* @return 1 if a packet was output, 0 if no packet could be output
|
|
|
|
* (in which case out may be uninitialized), < 0 if an error occurred
|
2012-03-15 12:37:43 +00:00
|
|
|
*/
|
|
|
|
int ff_interleave_packet_per_dts(AVFormatContext *s, AVPacket *out,
|
|
|
|
AVPacket *pkt, int flush);
|
|
|
|
|
2012-08-21 04:13:54 +00:00
|
|
|
void ff_free_stream(AVFormatContext *s, AVStream *st);
|
|
|
|
|
2012-09-30 22:49:16 +00:00
|
|
|
/**
|
|
|
|
* Return the frame duration in seconds. Return 0 if not available.
|
|
|
|
*/
|
2014-10-08 19:23:14 +00:00
|
|
|
void ff_compute_frame_duration(AVFormatContext *s, int *pnum, int *pden, AVStream *st,
|
2012-09-30 22:49:16 +00:00
|
|
|
AVCodecParserContext *pc, AVPacket *pkt);
|
|
|
|
|
2012-11-27 16:52:28 +00:00
|
|
|
unsigned int ff_codec_get_tag(const AVCodecTag *tags, enum AVCodecID id);
|
|
|
|
|
|
|
|
enum AVCodecID ff_codec_get_id(const AVCodecTag *tags, unsigned int tag);
|
2012-09-30 22:49:16 +00:00
|
|
|
|
2020-04-21 15:35:23 +00:00
|
|
|
int ff_is_intra_only(enum AVCodecID id);
|
|
|
|
|
2012-11-27 19:52:38 +00:00
|
|
|
/**
|
|
|
|
* Select a PCM codec based on the given parameters.
|
|
|
|
*
|
|
|
|
* @param bps bits-per-sample
|
|
|
|
* @param flt floating-point
|
|
|
|
* @param be big-endian
|
|
|
|
* @param sflags signed flags. each bit corresponds to one byte of bit depth.
|
|
|
|
* e.g. the 1st bit indicates if 8-bit should be signed or
|
|
|
|
* unsigned, the 2nd bit indicates if 16-bit should be signed or
|
|
|
|
* unsigned, etc... This is useful for formats such as WAVE where
|
|
|
|
* only 8-bit is unsigned and all other bit depths are signed.
|
|
|
|
* @return a PCM codec id or AV_CODEC_ID_NONE
|
|
|
|
*/
|
|
|
|
enum AVCodecID ff_get_pcm_codec_id(int bps, int flt, int be, int sflags);
|
|
|
|
|
2012-10-03 19:34:43 +00:00
|
|
|
/**
|
|
|
|
* Chooses a timebase for muxing the specified stream.
|
|
|
|
*
|
2014-04-14 20:35:25 +00:00
|
|
|
* The chosen timebase allows sample accurate timestamps based
|
2012-10-03 19:34:43 +00:00
|
|
|
* on the framerate or sample rate for audio streams. It also is
|
2014-04-14 20:35:25 +00:00
|
|
|
* at least as precise as 1/min_precision would be.
|
2012-10-03 19:34:43 +00:00
|
|
|
*/
|
2014-04-14 20:35:25 +00:00
|
|
|
AVRational ff_choose_timebase(AVFormatContext *s, AVStream *st, int min_precision);
|
2012-09-30 22:49:16 +00:00
|
|
|
|
2015-05-22 11:42:24 +00:00
|
|
|
/**
|
|
|
|
* Chooses a timebase for muxing the specified stream.
|
|
|
|
*/
|
|
|
|
enum AVChromaLocation ff_choose_chroma_location(AVFormatContext *s, AVStream *st);
|
|
|
|
|
2012-09-26 10:13:53 +00:00
|
|
|
/**
|
2012-09-26 10:13:53 +00:00
|
|
|
* Generate standard extradata for AVC-Intra based on width/height and field
|
|
|
|
* order.
|
2012-09-26 10:13:53 +00:00
|
|
|
*/
|
2012-09-26 10:13:53 +00:00
|
|
|
int ff_generate_avci_extradata(AVStream *st);
|
2012-09-26 10:13:53 +00:00
|
|
|
|
2015-10-08 02:10:08 +00:00
|
|
|
/**
|
|
|
|
* Add a bitstream filter to a stream.
|
|
|
|
*
|
|
|
|
* @param st output stream to add a filter to
|
|
|
|
* @param name the name of the filter to add
|
|
|
|
* @param args filter-specific argument string
|
|
|
|
* @return >0 on success;
|
|
|
|
* AVERROR code on failure
|
|
|
|
*/
|
|
|
|
int ff_stream_add_bitstream_filter(AVStream *st, const char *name, const char *args);
|
|
|
|
|
2016-07-13 15:00:11 +00:00
|
|
|
/**
|
|
|
|
* Copy encoding parameters from source to destination stream
|
|
|
|
*
|
|
|
|
* @param dst pointer to destination AVStream
|
|
|
|
* @param src pointer to source AVStream
|
|
|
|
* @return >=0 on success, AVERROR code on error
|
|
|
|
*/
|
|
|
|
int ff_stream_encode_params_copy(AVStream *dst, const AVStream *src);
|
|
|
|
|
2014-10-19 22:48:49 +00:00
|
|
|
/**
|
2020-01-05 15:32:51 +00:00
|
|
|
* Wrap avpriv_io_move and log if error happens.
|
2014-10-19 22:48:49 +00:00
|
|
|
*
|
2020-01-05 15:32:51 +00:00
|
|
|
* @param url_src source path
|
|
|
|
* @param url_dst destination path
|
2014-10-19 22:48:49 +00:00
|
|
|
* @return 0 or AVERROR on failure
|
|
|
|
*/
|
2020-01-05 15:32:51 +00:00
|
|
|
int ff_rename(const char *url_src, const char *url_dst, void *logctx);
|
2014-10-19 22:48:49 +00:00
|
|
|
|
2013-10-13 10:19:09 +00:00
|
|
|
/**
|
2015-07-27 20:53:16 +00:00
|
|
|
* Allocate extradata with additional AV_INPUT_BUFFER_PADDING_SIZE at end
|
2013-10-13 10:19:09 +00:00
|
|
|
* which is always set to 0.
|
|
|
|
*
|
2018-03-07 09:03:46 +00:00
|
|
|
* Previously allocated extradata in par will be freed.
|
|
|
|
*
|
2013-10-13 10:19:09 +00:00
|
|
|
* @param size size of extradata
|
|
|
|
* @return 0 if OK, AVERROR_xxx on error
|
|
|
|
*/
|
2016-04-10 19:58:15 +00:00
|
|
|
int ff_alloc_extradata(AVCodecParameters *par, int size);
|
2013-10-13 10:19:09 +00:00
|
|
|
|
2013-12-25 15:34:46 +00:00
|
|
|
/**
|
2015-07-27 20:53:16 +00:00
|
|
|
* Allocate extradata with additional AV_INPUT_BUFFER_PADDING_SIZE at end
|
2013-12-25 15:34:46 +00:00
|
|
|
* which is always set to 0 and fill it from pb.
|
|
|
|
*
|
|
|
|
* @param size size of extradata
|
|
|
|
* @return >= 0 if OK, AVERROR_xxx on error
|
|
|
|
*/
|
2016-04-14 16:21:08 +00:00
|
|
|
int ff_get_extradata(AVFormatContext *s, AVCodecParameters *par, AVIOContext *pb, int size);
|
2013-12-25 15:34:46 +00:00
|
|
|
|
2013-12-05 15:56:17 +00:00
|
|
|
/**
|
|
|
|
* add frame for rfps calculation.
|
|
|
|
*
|
|
|
|
* @param dts timestamp of the i-th frame
|
|
|
|
* @return 0 if OK, AVERROR_xxx on error
|
|
|
|
*/
|
|
|
|
int ff_rfps_add_frame(AVFormatContext *ic, AVStream *st, int64_t dts);
|
|
|
|
|
|
|
|
void ff_rfps_calculate(AVFormatContext *ic);
|
|
|
|
|
2013-12-31 13:09:48 +00:00
|
|
|
/**
|
|
|
|
* Flags for AVFormatContext.write_uncoded_frame()
|
|
|
|
*/
|
|
|
|
enum AVWriteUncodedFrameFlags {
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Query whether the feature is possible on this stream.
|
|
|
|
* The frame argument is ignored.
|
|
|
|
*/
|
|
|
|
AV_WRITE_UNCODED_FRAME_QUERY = 0x0001,
|
|
|
|
|
|
|
|
};
|
|
|
|
|
2014-10-24 17:23:23 +00:00
|
|
|
/**
|
|
|
|
* Copies the whilelists from one context to the other
|
|
|
|
*/
|
2016-06-27 09:25:23 +00:00
|
|
|
int ff_copy_whiteblacklists(AVFormatContext *dst, const AVFormatContext *src);
|
2013-12-31 13:09:48 +00:00
|
|
|
|
2015-11-27 17:57:27 +00:00
|
|
|
/**
|
|
|
|
* Returned by demuxers to indicate that data was consumed but discarded
|
|
|
|
* (ignored streams or junk data). The framework will re-call the demuxer.
|
|
|
|
*/
|
|
|
|
#define FFERROR_REDO FFERRTAG('R','E','D','O')
|
|
|
|
|
2016-07-04 14:45:13 +00:00
|
|
|
/**
|
|
|
|
* Utility function to open IO stream of output format.
|
|
|
|
*
|
|
|
|
* @param s AVFormatContext
|
|
|
|
* @param url URL or file name to open for writing
|
|
|
|
* @options optional options which will be passed to io_open callback
|
|
|
|
* @return >=0 on success, negative AVERROR in case of failure
|
|
|
|
*/
|
|
|
|
int ff_format_output_open(AVFormatContext *s, const char *url, AVDictionary **options);
|
|
|
|
|
2016-02-10 14:40:32 +00:00
|
|
|
/*
|
2016-01-16 16:53:43 +00:00
|
|
|
* A wrapper around AVFormatContext.io_close that should be used
|
2016-04-27 17:45:23 +00:00
|
|
|
* instead of calling the pointer directly.
|
2016-01-16 16:53:43 +00:00
|
|
|
*/
|
|
|
|
void ff_format_io_close(AVFormatContext *s, AVIOContext **pb);
|
|
|
|
|
2017-12-29 10:11:09 +00:00
|
|
|
/**
|
|
|
|
* Utility function to check if the file uses http or https protocol
|
|
|
|
*
|
|
|
|
* @param s AVFormatContext
|
|
|
|
* @param filename URL or file name to open for writing
|
|
|
|
*/
|
|
|
|
int ff_is_http_proto(char *filename);
|
|
|
|
|
2016-02-04 02:28:19 +00:00
|
|
|
/**
|
|
|
|
* Parse creation_time in AVFormatContext metadata if exists and warn if the
|
|
|
|
* parsing fails.
|
|
|
|
*
|
|
|
|
* @param s AVFormatContext
|
|
|
|
* @param timestamp parsed timestamp in microseconds, only set on successful parsing
|
|
|
|
* @param return_seconds set this to get the number of seconds in timestamp instead of microseconds
|
|
|
|
* @return 1 if OK, 0 if the metadata was not present, AVERROR(EINVAL) on parse error
|
|
|
|
*/
|
|
|
|
int ff_parse_creation_time_metadata(AVFormatContext *s, int64_t *timestamp, int return_seconds);
|
|
|
|
|
2016-02-22 02:13:20 +00:00
|
|
|
/**
|
|
|
|
* Standardize creation_time metadata in AVFormatContext to an ISO-8601
|
|
|
|
* timestamp string.
|
|
|
|
*
|
|
|
|
* @param s AVFormatContext
|
|
|
|
* @return <0 on error
|
|
|
|
*/
|
|
|
|
int ff_standardize_creation_time(AVFormatContext *s);
|
2016-02-18 19:57:32 +00:00
|
|
|
|
|
|
|
#define CONTAINS_PAL 2
|
2016-02-17 13:02:19 +00:00
|
|
|
/**
|
|
|
|
* Reshuffles the lines to use the user specified stride.
|
|
|
|
*
|
|
|
|
* @param ppkt input and output packet
|
2016-02-18 19:57:32 +00:00
|
|
|
* @return negative error code or
|
|
|
|
* 0 if no new packet was allocated
|
|
|
|
* non-zero if a new packet was allocated and ppkt has to be freed
|
|
|
|
* CONTAINS_PAL if in addition to a new packet the old contained a palette
|
2016-02-17 13:02:19 +00:00
|
|
|
*/
|
2016-04-10 19:58:15 +00:00
|
|
|
int ff_reshuffle_raw_rgb(AVFormatContext *s, AVPacket **ppkt, AVCodecParameters *par, int expected_stride);
|
2016-02-17 13:02:19 +00:00
|
|
|
|
2016-03-02 02:14:05 +00:00
|
|
|
/**
|
|
|
|
* Retrieves the palette from a packet, either from side data, or
|
|
|
|
* appended to the video data in the packet itself (raw video only).
|
|
|
|
* It is commonly used after a call to ff_reshuffle_raw_rgb().
|
|
|
|
*
|
|
|
|
* Use 0 for the ret parameter to check for side data only.
|
|
|
|
*
|
2016-03-03 07:25:58 +00:00
|
|
|
* @param pkt pointer to packet before calling ff_reshuffle_raw_rgb()
|
2016-03-02 02:14:05 +00:00
|
|
|
* @param ret return value from ff_reshuffle_raw_rgb(), or 0
|
2016-03-03 07:25:58 +00:00
|
|
|
* @param palette pointer to palette buffer
|
|
|
|
* @return negative error code or
|
|
|
|
* 1 if the packet has a palette, else 0
|
2016-03-02 02:14:05 +00:00
|
|
|
*/
|
2016-03-03 07:25:58 +00:00
|
|
|
int ff_get_packet_palette(AVFormatContext *s, AVPacket *pkt, int ret, uint32_t *palette);
|
2016-03-02 02:14:05 +00:00
|
|
|
|
2016-03-31 20:49:02 +00:00
|
|
|
/**
|
|
|
|
* Finalize buf into extradata and set its size appropriately.
|
|
|
|
*/
|
|
|
|
int ff_bprint_to_codecpar_extradata(AVCodecParameters *par, struct AVBPrint *buf);
|
|
|
|
|
2016-04-20 20:10:37 +00:00
|
|
|
/**
|
|
|
|
* Find the next packet in the interleaving queue for the given stream.
|
|
|
|
*
|
2021-02-08 22:04:05 +00:00
|
|
|
* @return a pointer to a packet if one was found, NULL otherwise.
|
2016-04-20 20:10:37 +00:00
|
|
|
*/
|
2021-02-08 22:04:05 +00:00
|
|
|
const AVPacket *ff_interleaved_peek(AVFormatContext *s, int stream);
|
2016-04-20 20:10:37 +00:00
|
|
|
|
2021-02-08 21:30:47 +00:00
|
|
|
int ff_get_muxer_ts_offset(AVFormatContext *s, int stream_index, int64_t *offset);
|
2017-12-21 21:54:06 +00:00
|
|
|
|
|
|
|
int ff_lock_avformat(void);
|
|
|
|
int ff_unlock_avformat(void);
|
|
|
|
|
2017-12-29 00:01:37 +00:00
|
|
|
/**
|
|
|
|
* Set AVFormatContext url field to the provided pointer. The pointer must
|
|
|
|
* point to a valid string. The existing url field is freed if necessary. Also
|
|
|
|
* set the legacy filename field to the same string which was provided in url.
|
|
|
|
*/
|
|
|
|
void ff_format_set_url(AVFormatContext *s, char *url);
|
|
|
|
|
2018-03-31 23:20:59 +00:00
|
|
|
void avpriv_register_devices(const AVOutputFormat * const o[], const AVInputFormat * const i[]);
|
2018-03-27 22:48:18 +00:00
|
|
|
|
2008-08-31 07:39:47 +00:00
|
|
|
#endif /* AVFORMAT_INTERNAL_H */
|