FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
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"
29 
30 #define MOV_FRAG_INFO_ALLOC_INCREMENT 64
31 #define MOV_INDEX_CLUSTER_SIZE 1024
32 #define MOV_TIMESCALE 1000
33 
34 #define RTP_MAX_PACKET_SIZE 1450
35 
36 #define MODE_MP4 0x01
37 #define MODE_MOV 0x02
38 #define MODE_3GP 0x04
39 #define MODE_PSP 0x08 // example working PSP command line:
40 // ffmpeg -i testinput.avi -f psp -r 14.985 -s 320x240 -b 768 -ar 24000 -ab 32 M4V00001.MP4
41 #define MODE_3G2 0x10
42 #define MODE_IPOD 0x20
43 #define MODE_ISM 0x40
44 #define MODE_F4V 0x80
45 
46 typedef struct MOVIentry {
47  uint64_t pos;
48  int64_t dts;
49  unsigned int size;
50  unsigned int samples_in_chunk;
51  unsigned int chunkNum; ///< Chunk number if the current entry is a chunk start otherwise 0
52  unsigned int entries;
53  int cts;
54 #define MOV_SYNC_SAMPLE 0x0001
55 #define MOV_PARTIAL_SYNC_SAMPLE 0x0002
56  uint32_t flags;
57 } MOVIentry;
58 
59 typedef struct HintSample {
61  int size;
63  int offset;
64  int own_data;
65 } HintSample;
66 
67 typedef struct HintSampleQueue {
68  int size;
69  int len;
72 
73 typedef struct MOVFragmentInfo {
74  int64_t offset;
75  int64_t time;
76  int64_t duration;
77  int64_t tfrf_offset;
78  int size;
80 
81 typedef struct MOVTrack {
82  int mode;
83  int entry;
84  unsigned timescale;
85  uint64_t time;
86  int64_t track_duration;
90  long chunkCount;
92 #define MOV_TRACK_CTTS 0x0001
93 #define MOV_TRACK_STPS 0x0002
94 #define MOV_TRACK_ENABLED 0x0004
95  uint32_t flags;
96 #define MOV_TIMECODE_FLAG_DROPFRAME 0x0001
97 #define MOV_TIMECODE_FLAG_24HOURSMAX 0x0002
98 #define MOV_TIMECODE_FLAG_ALLOWNEGATIVE 0x0004
99  uint32_t timecode_flags;
100  int language;
101  int track_id;
102  int tag; ///< stsd fourcc
106 
107  int vos_len;
112  int height; ///< active picture (w/o VBI) height for D-10/IMX
113  uint32_t tref_tag;
114  int tref_id; ///< trackID of the referenced track
115  int64_t start_dts;
116  int64_t start_cts;
117  int64_t end_pts;
119 
120  int hint_track; ///< the track that hints this track, -1 if no hint track is set
121  int src_track; ///< the track that this hint (or tmcd) track describes
122  AVFormatContext *rtp_ctx; ///< the format context for the hinting rtp muxer
123  uint32_t prev_rtp_ts;
125  uint32_t max_packet_size;
126 
129  uint32_t default_size;
130 
132 
134  int64_t data_offset;
135  int64_t frag_start;
138 
142 
143  struct {
150  int slices;
151  } vc1_info;
152 
153  void *eac3_priv;
154 
156 
158  int pal_done;
159 
161 } MOVTrack;
162 
163 typedef enum {
167 
168 typedef struct MOVMuxContext {
170  int mode;
171  int64_t time;
173  int nb_meta_tmcd; ///< number of new created tmcd track based on metadata (aka not data copy)
174  int chapter_track; ///< qt chapter track number
175  int64_t mdat_pos;
176  uint64_t mdat_size;
178 
179  int flags;
181 
185 
194 
196 
197  int reserved_moov_size; ///< 0 for disabled, -1 for automatic, size otherwise
199 
200  char *major_brand;
201 
204 
206  float gamma;
207 
210 
217 
218 } MOVMuxContext;
219 
220 #define FF_MOV_FLAG_RTP_HINT (1 << 0)
221 #define FF_MOV_FLAG_FRAGMENT (1 << 1)
222 #define FF_MOV_FLAG_EMPTY_MOOV (1 << 2)
223 #define FF_MOV_FLAG_FRAG_KEYFRAME (1 << 3)
224 #define FF_MOV_FLAG_SEPARATE_MOOF (1 << 4)
225 #define FF_MOV_FLAG_FRAG_CUSTOM (1 << 5)
226 #define FF_MOV_FLAG_ISML (1 << 6)
227 #define FF_MOV_FLAG_FASTSTART (1 << 7)
228 #define FF_MOV_FLAG_OMIT_TFHD_OFFSET (1 << 8)
229 #define FF_MOV_FLAG_DISABLE_CHPL (1 << 9)
230 #define FF_MOV_FLAG_DEFAULT_BASE_MOOF (1 << 10)
231 #define FF_MOV_FLAG_DASH (1 << 11)
232 #define FF_MOV_FLAG_FRAG_DISCONT (1 << 12)
233 #define FF_MOV_FLAG_DELAY_MOOV (1 << 13)
234 #define FF_MOV_FLAG_GLOBAL_SIDX (1 << 14)
235 #define FF_MOV_FLAG_WRITE_COLR (1 << 15)
236 #define FF_MOV_FLAG_WRITE_GAMA (1 << 16)
237 #define FF_MOV_FLAG_USE_MDTA (1 << 17)
238 
240 
241 int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index);
243  int track_index, int sample,
244  uint8_t *sample_data, int sample_size);
245 void ff_mov_close_hinting(MOVTrack *track);
246 
247 #endif /* AVFORMAT_MOVENC_H */
uint8_t * data
Definition: movenc.h:60
const char * s
Definition: avisynth_c.h:631
Bytestream IO Context.
Definition: avio.h:147
int packet_entry
Definition: movenc.h:149
long chunkCount
Definition: movenc.h:90
int use_editlist
Definition: movenc.h:205
int tag
stsd fourcc
Definition: movenc.h:102
int language
Definition: movenc.h:100
unsigned int entries
Definition: movenc.h:52
AVIOContext * mdat_buf
Definition: movenc.h:192
int nb_frag_info
Definition: movenc.h:139
int max_fragment_size
Definition: movenc.h:190
MOVEncryptionScheme
Definition: movenc.h:163
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:401
long sample_count
Definition: movenc.h:88
int end_reliable
Definition: movenc.h:118
int rtp_flags
Definition: movenc.h:180
char * encryption_scheme_str
Definition: movenc.h:211
static AVPacket pkt
AVStream * st
Definition: movenc.h:103
#define sample
This struct describes the properties of an encoded stream.
Definition: avcodec.h:3914
AVCodecParameters * par
Definition: movenc.h:104
int64_t track_duration
Definition: movenc.h:86
int encryption_kid_len
Definition: movenc.h:216
int last_sample_is_subtitle_end
Definition: movenc.h:87
int entries_flushed
Definition: movenc.h:137
Format I/O context.
Definition: avformat.h:1325
int64_t frag_start
Definition: movenc.h:135
HintSampleQueue sample_queue
Definition: movenc.h:131
int first_trun
Definition: movenc.h:193
int offset
Definition: movenc.h:63
int64_t default_duration
Definition: movenc.h:127
uint32_t flags
Definition: movenc.h:95
uint8_t
const AVClass * av_class
Definition: movenc.h:169
unsigned frag_info_capacity
Definition: movenc.h:141
int missing_duration_warned
Definition: movenc.h:209
uint64_t mdat_size
Definition: movenc.h:176
unsigned int samples_in_chunk
Definition: movenc.h:50
int frag_interleave
Definition: movenc.h:208
int encryption_key_len
Definition: movenc.h:214
int pal_done
Definition: movenc.h:158
uint8_t * encryption_key
Definition: movenc.h:213
int chapter_track
qt chapter track number
Definition: movenc.h:174
int own_data
Definition: movenc.h:64
int64_t time
Definition: movenc.h:75
int fragments
Definition: movenc.h:187
int iods_audio_profile
Definition: movenc.h:184
int max_fragment_duration
Definition: movenc.h:188
int64_t mdat_pos
Definition: movenc.h:175
void ff_mov_close_hinting(MOVTrack *track)
Definition: movenchint.c:459
unsigned int size
Definition: movenc.h:49
int ism_lookahead
Definition: movenc.h:191
int sample_number
Definition: movenc.h:62
uint32_t tref_tag
Definition: movenc.h:113
uint32_t flags
Definition: movenc.h:56
int64_t tfrf_offset
Definition: movenc.h:77
HintSample * samples
Definition: movenc.h:70
int64_t duration
Definition: movenc.h:76
uint32_t prev_rtp_ts
Definition: movenc.h:123
int video_track_timescale
Definition: movenc.h:195
int height
active picture (w/o VBI) height for D-10/IMX
Definition: movenc.h:112
int is_unaligned_qt_rgb
Definition: movenc.h:160
MOVEncryptionScheme encryption_scheme
Definition: movenc.h:212
int mode
Definition: movenc.h:82
int vos_len
Definition: movenc.h:107
int iods_skip
Definition: movenc.h:182
uint64_t pos
Definition: movenc.h:47
int first_frag_written
Definition: movenc.h:147
MOVMuxCencContext cenc
Definition: movenc.h:155
int64_t dts
Definition: movenc.h:48
int per_stream_grouping
Definition: movenc.h:202
int64_t data_offset
Definition: movenc.h:134
int nb_meta_tmcd
number of new created tmcd track based on metadata (aka not data copy)
Definition: movenc.h:173
int audio_vbr
Definition: movenc.h:111
int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index)
Definition: movenchint.c:29
long sample_size
Definition: movenc.h:89
int frag_discont
Definition: movenc.h:136
int reserved_moov_size
0 for disabled, -1 for automatic, size otherwise
Definition: movenc.h:197
int size
Definition: movenc.h:61
struct MOVTrack::@196 vc1_info
int iods_video_profile
Definition: movenc.h:183
Stream structure.
Definition: avformat.h:876
int64_t end_pts
Definition: movenc.h:117
int cts
Definition: movenc.h:53
uint32_t timecode_flags
Definition: movenc.h:99
int hint_track
the track that hints this track, -1 if no hint track is set
Definition: movenc.h:120
int slices
Definition: movenc.h:150
uint32_t default_size
Definition: movenc.h:129
float gamma
Definition: movenc.h:206
Describe the class of an AVClass context structure.
Definition: log.h:67
AVFormatContext * fc
Definition: movenc.h:203
int index
Definition: gxfenc.c:89
unsigned int chunkNum
Chunk number if the current entry is a chunk start otherwise 0.
Definition: movenc.h:51
uint64_t time
Definition: movenc.h:85
int first_packet_seq
Definition: movenc.h:144
int64_t time
Definition: movenc.h:171
int has_keyframes
Definition: movenc.h:91
int entry
Definition: movenc.h:83
MOVFragmentInfo * frag_info
Definition: movenc.h:140
char * major_brand
Definition: movenc.h:200
int64_t start_cts
Definition: movenc.h:116
uint8_t * vos_data
Definition: movenc.h:108
int first_packet_entry
Definition: movenc.h:145
uint32_t palette[AVPALETTE_COUNT]
Definition: movenc.h:157
#define AVPALETTE_COUNT
Definition: pixfmt.h:33
AVFormatContext * rtp_ctx
the format context for the hinting rtp muxer
Definition: movenc.h:122
int track_id
Definition: movenc.h:101
Main libavformat public API header.
int ff_mov_write_packet(AVFormatContext *s, AVPacket *pkt)
Definition: movenc.c:4595
int packet_seq
Definition: movenc.h:148
uint32_t max_packet_size
Definition: movenc.h:125
int src_track
the track that this hint (or tmcd) track describes
Definition: movenc.h:121
int multichannel_as_mono
Definition: movenc.h:105
MOVIentry * cluster
Definition: movenc.h:109
uint32_t default_sample_flags
Definition: movenc.h:128
unsigned timescale
Definition: movenc.h:84
int64_t reserved_header_pos
Definition: movenc.h:198
int64_t start_dts
Definition: movenc.h:115
int tref_id
trackID of the referenced track
Definition: movenc.h:114
int first_packet_seen
Definition: movenc.h:146
int moov_written
Definition: movenc.h:186
unsigned cluster_capacity
Definition: movenc.h:110
void * eac3_priv
Definition: movenc.h:153
This structure stores compressed data.
Definition: avcodec.h:1557
int64_t offset
Definition: movenc.h:74
int min_fragment_duration
Definition: movenc.h:189
MOVTrack * tracks
Definition: movenc.h:177
int64_t cur_rtp_ts_unwrapped
Definition: movenc.h:124
AVIOContext * mdat_buf
Definition: movenc.h:133
int nb_streams
Definition: movenc.h:172
uint8_t * encryption_kid
Definition: movenc.h:215