ca2a9c97226b840445cd40d7ea17db5539d554e6
[ffmpeg.git] / libavformat / movenc.h
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 #define MOV_DISPOSABLE_SAMPLE   0x0004
57     uint32_t     flags;
58 } MOVIentry;
59
60 typedef struct HintSample {
61     uint8_t *data;
62     int size;
63     int sample_number;
64     int offset;
65     int own_data;
66 } HintSample;
67
68 typedef struct HintSampleQueue {
69     int size;
70     int len;
71     HintSample *samples;
72 } HintSampleQueue;
73
74 typedef struct MOVFragmentInfo {
75     int64_t offset;
76     int64_t time;
77     int64_t duration;
78     int64_t tfrf_offset;
79     int size;
80 } MOVFragmentInfo;
81
82 typedef struct MOVTrack {
83     int         mode;
84     int         entry;
85     unsigned    timescale;
86     uint64_t    time;
87     int64_t     track_duration;
88     int         last_sample_is_subtitle_end;
89     long        sample_count;
90     long        sample_size;
91     long        chunkCount;
92     int         has_keyframes;
93     int         has_disposable;
94 #define MOV_TRACK_CTTS         0x0001
95 #define MOV_TRACK_STPS         0x0002
96 #define MOV_TRACK_ENABLED      0x0004
97     uint32_t    flags;
98 #define MOV_TIMECODE_FLAG_DROPFRAME     0x0001
99 #define MOV_TIMECODE_FLAG_24HOURSMAX    0x0002
100 #define MOV_TIMECODE_FLAG_ALLOWNEGATIVE 0x0004
101     uint32_t    timecode_flags;
102     int         language;
103     int         track_id;
104     int         tag; ///< stsd fourcc
105     AVStream        *st;
106     AVCodecParameters *par;
107     int multichannel_as_mono;
108
109     int         vos_len;
110     uint8_t     *vos_data;
111     MOVIentry   *cluster;
112     unsigned    cluster_capacity;
113     int         audio_vbr;
114     int         height; ///< active picture (w/o VBI) height for D-10/IMX
115     uint32_t    tref_tag;
116     int         tref_id; ///< trackID of the referenced track
117     int64_t     start_dts;
118     int64_t     start_cts;
119     int64_t     end_pts;
120     int         end_reliable;
121     int64_t     dts_shift;
122
123     int         hint_track;   ///< the track that hints this track, -1 if no hint track is set
124     int         src_track;    ///< the track that this hint (or tmcd) track describes
125     AVFormatContext *rtp_ctx; ///< the format context for the hinting rtp muxer
126     uint32_t    prev_rtp_ts;
127     int64_t     cur_rtp_ts_unwrapped;
128     uint32_t    max_packet_size;
129
130     int64_t     default_duration;
131     uint32_t    default_sample_flags;
132     uint32_t    default_size;
133
134     HintSampleQueue sample_queue;
135
136     AVIOContext *mdat_buf;
137     int64_t     data_offset;
138     int64_t     frag_start;
139     int         frag_discont;
140     int         entries_flushed;
141
142     int         nb_frag_info;
143     MOVFragmentInfo *frag_info;
144     unsigned    frag_info_capacity;
145
146     struct {
147         int     first_packet_seq;
148         int     first_packet_entry;
149         int     first_packet_seen;
150         int     first_frag_written;
151         int     packet_seq;
152         int     packet_entry;
153         int     slices;
154     } vc1_info;
155
156     void       *eac3_priv;
157
158     MOVMuxCencContext cenc;
159
160     uint32_t palette[AVPALETTE_COUNT];
161     int pal_done;
162
163     int is_unaligned_qt_rgb;
164 } MOVTrack;
165
166 typedef enum {
167     MOV_ENC_NONE = 0,
168     MOV_ENC_CENC_AES_CTR,
169 } MOVEncryptionScheme;
170
171 typedef struct MOVMuxContext {
172     const AVClass *av_class;
173     int     mode;
174     int64_t time;
175     int     nb_streams;
176     int     nb_meta_tmcd;  ///< number of new created tmcd track based on metadata (aka not data copy)
177     int     chapter_track; ///< qt chapter track number
178     int64_t mdat_pos;
179     uint64_t mdat_size;
180     MOVTrack *tracks;
181
182     int flags;
183     int rtp_flags;
184
185     int iods_skip;
186     int iods_video_profile;
187     int iods_audio_profile;
188
189     int moov_written;
190     int fragments;
191     int max_fragment_duration;
192     int min_fragment_duration;
193     int max_fragment_size;
194     int ism_lookahead;
195     AVIOContext *mdat_buf;
196     int first_trun;
197
198     int video_track_timescale;
199
200     int reserved_moov_size; ///< 0 for disabled, -1 for automatic, size otherwise
201     int64_t reserved_header_pos;
202
203     char *major_brand;
204
205     int per_stream_grouping;
206     AVFormatContext *fc;
207
208     int use_editlist;
209     float gamma;
210
211     int frag_interleave;
212     int missing_duration_warned;
213
214     char *encryption_scheme_str;
215     MOVEncryptionScheme encryption_scheme;
216     uint8_t *encryption_key;
217     int encryption_key_len;
218     uint8_t *encryption_kid;
219     int encryption_kid_len;
220
221     int need_rewrite_extradata;
222
223     int use_stream_ids_as_track_ids;
224     int track_ids_ok;
225     int write_tmcd;
226 } MOVMuxContext;
227
228 #define FF_MOV_FLAG_RTP_HINT              (1 <<  0)
229 #define FF_MOV_FLAG_FRAGMENT              (1 <<  1)
230 #define FF_MOV_FLAG_EMPTY_MOOV            (1 <<  2)
231 #define FF_MOV_FLAG_FRAG_KEYFRAME         (1 <<  3)
232 #define FF_MOV_FLAG_SEPARATE_MOOF         (1 <<  4)
233 #define FF_MOV_FLAG_FRAG_CUSTOM           (1 <<  5)
234 #define FF_MOV_FLAG_ISML                  (1 <<  6)
235 #define FF_MOV_FLAG_FASTSTART             (1 <<  7)
236 #define FF_MOV_FLAG_OMIT_TFHD_OFFSET      (1 <<  8)
237 #define FF_MOV_FLAG_DISABLE_CHPL          (1 <<  9)
238 #define FF_MOV_FLAG_DEFAULT_BASE_MOOF     (1 << 10)
239 #define FF_MOV_FLAG_DASH                  (1 << 11)
240 #define FF_MOV_FLAG_FRAG_DISCONT          (1 << 12)
241 #define FF_MOV_FLAG_DELAY_MOOV            (1 << 13)
242 #define FF_MOV_FLAG_GLOBAL_SIDX           (1 << 14)
243 #define FF_MOV_FLAG_WRITE_COLR            (1 << 15)
244 #define FF_MOV_FLAG_WRITE_GAMA            (1 << 16)
245 #define FF_MOV_FLAG_USE_MDTA              (1 << 17)
246 #define FF_MOV_FLAG_SKIP_TRAILER          (1 << 18)
247 #define FF_MOV_FLAG_NEGATIVE_CTS_OFFSETS  (1 << 19)
248 #define FF_MOV_FLAG_FRAG_EVERY_FRAME      (1 << 20)
249
250 int ff_mov_write_packet(AVFormatContext *s, AVPacket *pkt);
251
252 int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index);
253 int ff_mov_add_hinted_packet(AVFormatContext *s, AVPacket *pkt,
254                              int track_index, int sample,
255                              uint8_t *sample_data, int sample_size);
256 void ff_mov_close_hinting(MOVTrack *track);
257
258 #endif /* AVFORMAT_MOVENC_H */