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