FFmpeg
movenc.h
Go to the documentation of this file.
1 /*
2  * MOV, 3GP, MP4 muxer
3  * Copyright (c) 2003 Thomas Raivio
4  * Copyright (c) 2004 Gildas Bazin <gbazin at videolan dot org>
5  * Copyright (c) 2009 Baptiste Coudurier <baptiste dot coudurier at gmail dot com>
6  *
7  * This file is part of FFmpeg.
8  *
9  * FFmpeg is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation; either
12  * version 2.1 of the License, or (at your option) any later version.
13  *
14  * FFmpeg is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with FFmpeg; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22  */
23 
24 #ifndef AVFORMAT_MOVENC_H
25 #define AVFORMAT_MOVENC_H
26 
27 #include "avformat.h"
28 #include "movenccenc.h"
30 
31 #define MOV_FRAG_INFO_ALLOC_INCREMENT 64
32 #define MOV_INDEX_CLUSTER_SIZE 1024
33 #define MOV_TIMESCALE 1000
34 
35 #define RTP_MAX_PACKET_SIZE 1450
36 
37 #define MODE_MP4 0x01
38 #define MODE_MOV 0x02
39 #define MODE_3GP 0x04
40 #define MODE_PSP 0x08 // example working PSP command line:
41 // ffmpeg -i testinput.avi -f psp -r 14.985 -s 320x240 -b 768 -ar 24000 -ab 32 M4V00001.MP4
42 #define MODE_3G2 0x10
43 #define MODE_IPOD 0x20
44 #define MODE_ISM 0x40
45 #define MODE_F4V 0x80
46 #define MODE_AVIF 0x100
47 
48 typedef struct MOVIentry {
49  uint64_t pos;
50  int64_t dts;
51  int64_t pts;
52  unsigned int size;
53  unsigned int samples_in_chunk;
54  unsigned int chunkNum; ///< Chunk number if the current entry is a chunk start otherwise 0
55  unsigned int entries;
56  int cts;
57 #define MOV_SYNC_SAMPLE 0x0001
58 #define MOV_PARTIAL_SYNC_SAMPLE 0x0002
59 #define MOV_DISPOSABLE_SAMPLE 0x0004
60  uint32_t flags;
62 } MOVIentry;
63 
64 typedef struct HintSample {
65  const uint8_t *data;
66  int size;
68  int offset;
69  int own_data;
70 } HintSample;
71 
72 typedef struct HintSampleQueue {
73  int size;
74  int len;
77 
78 typedef struct MOVFragmentInfo {
79  int64_t offset;
80  int64_t time;
81  int64_t duration;
82  int64_t tfrf_offset;
83  int size;
85 
86 typedef struct MOVTrack {
87  int mode;
88  int entry;
89  unsigned timescale;
90  uint64_t time;
91  int64_t track_duration;
95  long chunkCount;
98 #define MOV_TRACK_CTTS 0x0001
99 #define MOV_TRACK_STPS 0x0002
100 #define MOV_TRACK_ENABLED 0x0004
101  uint32_t flags;
102 #define MOV_TIMECODE_FLAG_DROPFRAME 0x0001
103 #define MOV_TIMECODE_FLAG_24HOURSMAX 0x0002
104 #define MOV_TIMECODE_FLAG_ALLOWNEGATIVE 0x0004
105  uint32_t timecode_flags;
106  int language;
107  int track_id;
108  int tag; ///< stsd fourcc
113 
114  int vos_len;
115  uint8_t *vos_data;
119  int height; ///< active picture (w/o VBI) height for D-10/IMX
120  uint32_t tref_tag;
121  int tref_id; ///< trackID of the referenced track
122  int64_t start_dts;
123  int64_t start_cts;
124  int64_t end_pts;
126  int64_t dts_shift;
127 
128  int hint_track; ///< the track that hints this track, -1 if no hint track is set
129  int src_track; ///< the track that this hint (or tmcd) track describes
130  AVFormatContext *rtp_ctx; ///< the format context for the hinting rtp muxer
131  uint32_t prev_rtp_ts;
133  uint32_t max_packet_size;
134 
137  uint32_t default_size;
138 
141 
143  int64_t data_offset;
146 
150 
151  struct {
158  int slices;
159  } vc1_info;
160 
161  void *eac3_priv;
162 
164 
166  int pal_done;
167 
169 
170  unsigned int squash_fragment_samples_to_one; //< flag to note formats where all samples for a fragment are to be squashed
171 
173 
174  struct IAMFContext *iamf;
178 } MOVTrack;
179 
180 typedef enum {
184 
185 typedef enum {
190 } MOVPrftBox;
191 
192 typedef struct MOVMuxContext {
194  int mode;
195  int64_t time;
198  int nb_meta_tmcd; ///< number of new created tmcd track based on metadata (aka not data copy)
199  int chapter_track; ///< qt chapter track number
200  int64_t mdat_pos;
201  uint64_t mdat_size;
203 
204  int flags;
206 
210 
219 
221 
222  int reserved_moov_size; ///< 0 for disabled, -1 for automatic, size otherwise
224 
225  char *major_brand;
226 
229 
231 
233  float gamma;
234 
237 
240  uint8_t *encryption_key;
242  uint8_t *encryption_kid;
244 
246 
254 
255  int64_t avif_extent_pos[2]; // index 0 is YUV and 1 is Alpha.
256  int avif_extent_length[2]; // index 0 is YUV and 1 is Alpha.
259 } MOVMuxContext;
260 
261 #define FF_MOV_FLAG_RTP_HINT (1 << 0)
262 #define FF_MOV_FLAG_FRAGMENT (1 << 1)
263 #define FF_MOV_FLAG_EMPTY_MOOV (1 << 2)
264 #define FF_MOV_FLAG_FRAG_KEYFRAME (1 << 3)
265 #define FF_MOV_FLAG_SEPARATE_MOOF (1 << 4)
266 #define FF_MOV_FLAG_FRAG_CUSTOM (1 << 5)
267 #define FF_MOV_FLAG_ISML (1 << 6)
268 #define FF_MOV_FLAG_FASTSTART (1 << 7)
269 #define FF_MOV_FLAG_OMIT_TFHD_OFFSET (1 << 8)
270 #define FF_MOV_FLAG_DISABLE_CHPL (1 << 9)
271 #define FF_MOV_FLAG_DEFAULT_BASE_MOOF (1 << 10)
272 #define FF_MOV_FLAG_DASH (1 << 11)
273 #define FF_MOV_FLAG_FRAG_DISCONT (1 << 12)
274 #define FF_MOV_FLAG_DELAY_MOOV (1 << 13)
275 #define FF_MOV_FLAG_GLOBAL_SIDX (1 << 14)
276 #define FF_MOV_FLAG_WRITE_COLR (1 << 15)
277 #define FF_MOV_FLAG_WRITE_GAMA (1 << 16)
278 #define FF_MOV_FLAG_USE_MDTA (1 << 17)
279 #define FF_MOV_FLAG_SKIP_TRAILER (1 << 18)
280 #define FF_MOV_FLAG_NEGATIVE_CTS_OFFSETS (1 << 19)
281 #define FF_MOV_FLAG_FRAG_EVERY_FRAME (1 << 20)
282 #define FF_MOV_FLAG_SKIP_SIDX (1 << 21)
283 #define FF_MOV_FLAG_CMAF (1 << 22)
284 #define FF_MOV_FLAG_PREFER_ICC (1 << 23)
285 
287 
288 int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index);
290  int track_index, int sample,
291  uint8_t *sample_data, int sample_size);
292 void ff_mov_close_hinting(MOVTrack *track);
293 
294 #endif /* AVFORMAT_MOVENC_H */
MOVTrack::height
int height
active picture (w/o VBI) height for D-10/IMX
Definition: movenc.h:119
MOVMuxContext::mdat_pos
int64_t mdat_pos
Definition: movenc.h:200
MOVMuxContext::nb_tracks
int nb_tracks
Definition: movenc.h:197
MOVMuxContext::fc
AVFormatContext * fc
Definition: movenc.h:228
MOVTrack::end_pts
int64_t end_pts
Definition: movenc.h:124
MOVMuxContext::iods_audio_profile
int iods_audio_profile
Definition: movenc.h:209
MOVTrack::chunkCount
long chunkCount
Definition: movenc.h:95
MOVFragmentInfo::tfrf_offset
int64_t tfrf_offset
Definition: movenc.h:82
MOVTrack::squash_fragment_samples_to_one
unsigned int squash_fragment_samples_to_one
Definition: movenc.h:170
MOVMuxContext::mode
int mode
Definition: movenc.h:194
MOVMuxContext::encryption_scheme
MOVEncryptionScheme encryption_scheme
Definition: movenc.h:239
AVCodecParameters
This struct describes the properties of an encoded stream.
Definition: codec_par.h:47
MOVTrack::mode
int mode
Definition: movenc.h:87
MOVIentry
Definition: movenc.h:48
MOVFragmentInfo::size
int size
Definition: movenc.h:83
MOVFragmentInfo
Definition: movenc.h:78
MOVTrack::last_iamf_idx
int last_iamf_idx
Definition: movenc.h:176
MOVTrack::vos_len
int vos_len
Definition: movenc.h:114
MOVTrack::iamf_buf
AVIOContext * iamf_buf
Definition: movenc.h:177
MOVMuxContext::min_fragment_duration
int min_fragment_duration
Definition: movenc.h:214
MOVMuxContext::avif_extent_length
int avif_extent_length[2]
Definition: movenc.h:256
MOVMuxContext::encryption_scheme_str
char * encryption_scheme_str
Definition: movenc.h:238
HintSample::data
const uint8_t * data
Definition: movenc.h:65
MOVFragmentInfo::duration
int64_t duration
Definition: movenc.h:81
PacketList
Definition: packet_internal.h:33
MOVTrack::flags
uint32_t flags
Definition: movenc.h:101
MOVTrack::tag
int tag
stsd fourcc
Definition: movenc.h:108
MOVTrack::pal_done
int pal_done
Definition: movenc.h:166
MOVIentry::dts
int64_t dts
Definition: movenc.h:50
MOVMuxContext::encryption_key
uint8_t * encryption_key
Definition: movenc.h:240
MOVIentry::flags
uint32_t flags
Definition: movenc.h:60
MOVTrack::track_id
int track_id
Definition: movenc.h:107
HintSampleQueue::size
int size
Definition: movenc.h:73
MOVTrack::vos_data
uint8_t * vos_data
Definition: movenc.h:115
ff_mov_init_hinting
int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index)
Definition: movenchint.c:29
MOVTrack::track_duration
int64_t track_duration
Definition: movenc.h:91
track_index
static int track_index(VividasDemuxContext *viv, AVFormatContext *s, const uint8_t *buf, unsigned size)
Definition: vividas.c:437
MOVTrack::dts_shift
int64_t dts_shift
Definition: movenc.h:126
MOVIentry::entries
unsigned int entries
Definition: movenc.h:55
MOVMuxContext::write_prft
MOVPrftBox write_prft
Definition: movenc.h:251
MOVTrack::first_frag_written
int first_frag_written
Definition: movenc.h:155
MOVMuxContext::mdat_size
uint64_t mdat_size
Definition: movenc.h:201
MOVMuxContext::write_tmcd
int write_tmcd
Definition: movenc.h:250
MOVTrack::frag_info
MOVFragmentInfo * frag_info
Definition: movenc.h:148
MOV_PRFT_SRC_PTS
@ MOV_PRFT_SRC_PTS
Definition: movenc.h:188
MOVTrack
Definition: movenc.h:86
MOVFragmentInfo::offset
int64_t offset
Definition: movenc.h:79
MOV_ENC_NONE
@ MOV_ENC_NONE
Definition: movenc.h:181
HintSample::own_data
int own_data
Definition: movenc.h:69
MOVMuxContext::use_editlist
int use_editlist
Definition: movenc.h:232
MOVTrack::frag_discont
int frag_discont
Definition: movenc.h:144
MOVTrack::first_packet_entry
int first_packet_entry
Definition: movenc.h:153
MOVTrack::cur_rtp_ts_unwrapped
int64_t cur_rtp_ts_unwrapped
Definition: movenc.h:132
MOVIentry::size
unsigned int size
Definition: movenc.h:52
MOVTrack::mdat_buf
AVIOContext * mdat_buf
Definition: movenc.h:142
MOVTrack::cluster
MOVIentry * cluster
Definition: movenc.h:116
HintSample::offset
int offset
Definition: movenc.h:68
MOVMuxContext::iods_video_profile
int iods_video_profile
Definition: movenc.h:208
MOV_PRFT_NB
@ MOV_PRFT_NB
Definition: movenc.h:189
MOVIentry::prft
AVProducerReferenceTime prft
Definition: movenc.h:61
MOVTrack::st
AVStream * st
Definition: movenc.h:109
MOVTrack::palette
uint32_t palette[AVPALETTE_COUNT]
Definition: movenc.h:165
pkt
AVPacket * pkt
Definition: movenc.c:59
MOVTrack::squashed_packet_queue
PacketList squashed_packet_queue
Definition: movenc.h:172
movenccenc.h
MOVTrack::mono_as_fc
int mono_as_fc
Definition: movenc.h:111
MOVMuxContext::encryption_kid_len
int encryption_kid_len
Definition: movenc.h:243
MOVMuxContext::pkt
AVPacket * pkt
Definition: movenc.h:230
MOVMuxContext::chapter_track
int chapter_track
qt chapter track number
Definition: movenc.h:199
s
#define s(width, name)
Definition: cbs_vp9.c:198
MOVMuxContext::movie_timescale
int movie_timescale
Definition: movenc.h:253
MOVTrack::sample_queue
HintSampleQueue sample_queue
Definition: movenc.h:139
MOVTrack::tref_tag
uint32_t tref_tag
Definition: movenc.h:120
MOVMuxContext::per_stream_grouping
int per_stream_grouping
Definition: movenc.h:227
MOVMuxContext::nb_meta_tmcd
int nb_meta_tmcd
number of new created tmcd track based on metadata (aka not data copy)
Definition: movenc.h:198
MOVTrack::timecode_flags
uint32_t timecode_flags
Definition: movenc.h:105
MOVIentry::pts
int64_t pts
Definition: movenc.h:51
MOVTrack::has_disposable
int has_disposable
Definition: movenc.h:97
HintSampleQueue
Definition: movenc.h:72
MOVMuxContext::encryption_kid
uint8_t * encryption_kid
Definition: movenc.h:242
MOVMuxContext::frag_interleave
int frag_interleave
Definition: movenc.h:235
MOVTrack::max_packet_size
uint32_t max_packet_size
Definition: movenc.h:133
MOVTrack::sample_size
long sample_size
Definition: movenc.h:94
HintSample::size
int size
Definition: movenc.h:66
MOVIentry::pos
uint64_t pos
Definition: movenc.h:49
MOV_PRFT_NONE
@ MOV_PRFT_NONE
Definition: movenc.h:186
MOVMuxContext::time
int64_t time
Definition: movenc.h:195
MOVTrack::packet_entry
int packet_entry
Definition: movenc.h:157
MOVMuxContext::use_stream_ids_as_track_ids
int use_stream_ids_as_track_ids
Definition: movenc.h:247
MOVTrack::sample_count
long sample_count
Definition: movenc.h:93
MOVTrack::start_dts
int64_t start_dts
Definition: movenc.h:122
AVFormatContext
Format I/O context.
Definition: avformat.h:1255
MOVMuxContext::iods_skip
int iods_skip
Definition: movenc.h:207
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
MOVTrack::src_track
int src_track
the track that this hint (or tmcd) track describes
Definition: movenc.h:129
MOVMuxContext::encryption_key_len
int encryption_key_len
Definition: movenc.h:241
MOVMuxContext::max_fragment_size
int max_fragment_size
Definition: movenc.h:215
MOVTrack::prev_rtp_ts
uint32_t prev_rtp_ts
Definition: movenc.h:131
MOVTrack::cenc
MOVMuxCencContext cenc
Definition: movenc.h:163
MOVTrack::last_sample_is_subtitle_end
int last_sample_is_subtitle_end
Definition: movenc.h:92
MOVMuxContext::av_class
const AVClass * av_class
Definition: movenc.h:193
MOVMuxContext
Definition: movenc.h:192
MOVMuxContext::missing_duration_warned
int missing_duration_warned
Definition: movenc.h:236
MOVTrack::data_offset
int64_t data_offset
Definition: movenc.h:143
ff_mov_close_hinting
void ff_mov_close_hinting(MOVTrack *track)
Definition: movenchint.c:459
MOVIentry::cts
int cts
Definition: movenc.h:56
HintSample::sample_number
int sample_number
Definition: movenc.h:67
AVProducerReferenceTime
This structure supplies correlation between a packet timestamp and a wall clock production time.
Definition: defs.h:318
MOVTrack::packet_seq
int packet_seq
Definition: movenc.h:156
MOVMuxContext::empty_hdlr_name
int empty_hdlr_name
Definition: movenc.h:252
index
int index
Definition: gxfenc.c:89
AVPALETTE_COUNT
#define AVPALETTE_COUNT
Definition: pixfmt.h:33
ff_mov_write_packet
int ff_mov_write_packet(AVFormatContext *s, AVPacket *pkt)
Definition: movenc.c:6176
AVIOContext
Bytestream IO Context.
Definition: avio.h:160
MOVTrack::cover_image
AVPacket * cover_image
Definition: movenc.h:140
MOVFragmentInfo::time
int64_t time
Definition: movenc.h:80
MOVTrack::language
int language
Definition: movenc.h:106
MOVMuxContext::first_trun
int first_trun
Definition: movenc.h:218
MOVMuxContext::ism_lookahead
int ism_lookahead
Definition: movenc.h:216
MOVTrack::default_sample_flags
uint32_t default_sample_flags
Definition: movenc.h:136
sample
#define sample
Definition: flacdsp_template.c:44
MOVMuxContext::avif_extent_pos
int64_t avif_extent_pos[2]
Definition: movenc.h:255
MOVMuxContext::need_rewrite_extradata
int need_rewrite_extradata
Definition: movenc.h:245
MOVMuxContext::reserved_header_pos
int64_t reserved_header_pos
Definition: movenc.h:223
MOVTrack::audio_vbr
int audio_vbr
Definition: movenc.h:118
IAMFContext
Definition: iamf.h:128
MOVTrack::end_reliable
int end_reliable
Definition: movenc.h:125
MOVTrack::slices
int slices
Definition: movenc.h:158
MOVTrack::first_packet_seen
int first_packet_seen
Definition: movenc.h:154
HintSampleQueue::len
int len
Definition: movenc.h:74
MOVTrack::start_cts
int64_t start_cts
Definition: movenc.h:123
MOVIentry::chunkNum
unsigned int chunkNum
Chunk number if the current entry is a chunk start otherwise 0.
Definition: movenc.h:54
MOVTrack::time
uint64_t time
Definition: movenc.h:90
MOVTrack::vc1_info
struct MOVTrack::@332 vc1_info
ff_mov_add_hinted_packet
int ff_mov_add_hinted_packet(AVFormatContext *s, AVPacket *pkt, int track_index, int sample, uint8_t *sample_data, int sample_size)
Definition: movenchint.c:400
MOVTrack::hint_track
int hint_track
the track that hints this track, -1 if no hint track is set
Definition: movenc.h:128
MOVTrack::has_keyframes
int has_keyframes
Definition: movenc.h:96
MOVTrack::entry
int entry
Definition: movenc.h:88
MOVMuxContext::nb_streams
int nb_streams
Definition: movenc.h:196
MOVMuxContext::fragments
int fragments
Definition: movenc.h:212
MOV_PRFT_SRC_WALLCLOCK
@ MOV_PRFT_SRC_WALLCLOCK
Definition: movenc.h:187
MOVTrack::first_packet_seq
int first_packet_seq
Definition: movenc.h:152
MOVPrftBox
MOVPrftBox
Definition: movenc.h:185
MOVMuxContext::video_track_timescale
int video_track_timescale
Definition: movenc.h:220
MOVMuxContext::max_fragment_duration
int max_fragment_duration
Definition: movenc.h:213
MOVTrack::rtp_ctx
AVFormatContext * rtp_ctx
the format context for the hinting rtp muxer
Definition: movenc.h:130
MOVEncryptionScheme
MOVEncryptionScheme
Definition: movenc.h:180
MOVTrack::iamf
struct IAMFContext * iamf
Definition: movenc.h:174
AVStream
Stream structure.
Definition: avformat.h:743
MOVMuxContext::track_ids_ok
int track_ids_ok
Definition: movenc.h:248
MOVTrack::entries_flushed
int entries_flushed
Definition: movenc.h:145
avformat.h
MOVMuxContext::is_animated_avif
int is_animated_avif
Definition: movenc.h:257
MOVTrack::par
AVCodecParameters * par
Definition: movenc.h:110
MOVMuxContext::flags
int flags
Definition: movenc.h:204
MOVMuxContext::reserved_moov_size
int reserved_moov_size
0 for disabled, -1 for automatic, size otherwise
Definition: movenc.h:222
HintSampleQueue::samples
HintSample * samples
Definition: movenc.h:75
MOVTrack::is_unaligned_qt_rgb
int is_unaligned_qt_rgb
Definition: movenc.h:168
MOVMuxContext::rtp_flags
int rtp_flags
Definition: movenc.h:205
MOVMuxContext::tracks
MOVTrack * tracks
Definition: movenc.h:202
MOVTrack::multichannel_as_mono
int multichannel_as_mono
Definition: movenc.h:112
MOVTrack::timescale
unsigned timescale
Definition: movenc.h:89
packet_internal.h
MOVMuxCencContext
Definition: movenccenc.h:33
MOVMuxContext::avif_loop_count
int avif_loop_count
Definition: movenc.h:258
HintSample
Definition: movenc.h:64
MOVMuxContext::major_brand
char * major_brand
Definition: movenc.h:225
MOVMuxContext::write_btrt
int write_btrt
Definition: movenc.h:249
MOVTrack::cluster_capacity
unsigned cluster_capacity
Definition: movenc.h:117
MOV_ENC_CENC_AES_CTR
@ MOV_ENC_CENC_AES_CTR
Definition: movenc.h:182
AVPacket
This structure stores compressed data.
Definition: packet.h:499
MOVTrack::eac3_priv
void * eac3_priv
Definition: movenc.h:161
MOVMuxContext::mdat_buf
AVIOContext * mdat_buf
Definition: movenc.h:217
MOVTrack::default_duration
int64_t default_duration
Definition: movenc.h:135
MOVTrack::frag_info_capacity
unsigned frag_info_capacity
Definition: movenc.h:149
MOVTrack::first_iamf_idx
int first_iamf_idx
Definition: movenc.h:175
MOVTrack::tref_id
int tref_id
trackID of the referenced track
Definition: movenc.h:121
MOVMuxContext::moov_written
int moov_written
Definition: movenc.h:211
MOVTrack::default_size
uint32_t default_size
Definition: movenc.h:137
MOVMuxContext::gamma
float gamma
Definition: movenc.h:233
MOVTrack::nb_frag_info
int nb_frag_info
Definition: movenc.h:147
MOVIentry::samples_in_chunk
unsigned int samples_in_chunk
Definition: movenc.h:53