Merge commit '847bf5988fec1d3e65c1d8cf0cdb8caf0cfd0c1b'
[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
29 #define MOV_FRAG_INFO_ALLOC_INCREMENT 64
30 #define MOV_INDEX_CLUSTER_SIZE 1024
31 #define MOV_TIMESCALE 1000
32
33 #define RTP_MAX_PACKET_SIZE 1450
34
35 #define MODE_MP4  0x01
36 #define MODE_MOV  0x02
37 #define MODE_3GP  0x04
38 #define MODE_PSP  0x08 // example working PSP command line:
39 // ffmpeg -i testinput.avi  -f psp -r 14.985 -s 320x240 -b 768 -ar 24000 -ab 32 M4V00001.MP4
40 #define MODE_3G2  0x10
41 #define MODE_IPOD 0x20
42 #define MODE_ISM  0x40
43 #define MODE_F4V  0x80
44
45 typedef struct MOVIentry {
46     uint64_t     pos;
47     int64_t      dts;
48     unsigned int size;
49     unsigned int samples_in_chunk;
50     unsigned int chunkNum;              ///< Chunk number if the current entry is a chunk start otherwise 0
51     unsigned int entries;
52     int          cts;
53 #define MOV_SYNC_SAMPLE         0x0001
54 #define MOV_PARTIAL_SYNC_SAMPLE 0x0002
55     uint32_t     flags;
56 } MOVIentry;
57
58 typedef struct HintSample {
59     uint8_t *data;
60     int size;
61     int sample_number;
62     int offset;
63     int own_data;
64 } HintSample;
65
66 typedef struct HintSampleQueue {
67     int size;
68     int len;
69     HintSample *samples;
70 } HintSampleQueue;
71
72 typedef struct MOVFragmentInfo {
73     int64_t offset;
74     int64_t time;
75     int64_t duration;
76     int64_t tfrf_offset;
77     int size;
78 } MOVFragmentInfo;
79
80 typedef struct MOVTrack {
81     int         mode;
82     int         entry;
83     unsigned    timescale;
84     uint64_t    time;
85     int64_t     track_duration;
86     int         last_sample_is_subtitle_end;
87     long        sample_count;
88     long        sample_size;
89     long        chunkCount;
90     int         has_keyframes;
91 #define MOV_TRACK_CTTS         0x0001
92 #define MOV_TRACK_STPS         0x0002
93 #define MOV_TRACK_ENABLED      0x0004
94     uint32_t    flags;
95 #define MOV_TIMECODE_FLAG_DROPFRAME     0x0001
96 #define MOV_TIMECODE_FLAG_24HOURSMAX    0x0002
97 #define MOV_TIMECODE_FLAG_ALLOWNEGATIVE 0x0004
98     uint32_t    timecode_flags;
99     int         language;
100     int         track_id;
101     int         tag; ///< stsd fourcc
102     AVStream        *st;
103     AVCodecContext *enc;
104     int multichannel_as_mono;
105
106     int         vos_len;
107     uint8_t     *vos_data;
108     MOVIentry   *cluster;
109     unsigned    cluster_capacity;
110     int         audio_vbr;
111     int         height; ///< active picture (w/o VBI) height for D-10/IMX
112     uint32_t    tref_tag;
113     int         tref_id; ///< trackID of the referenced track
114     int64_t     start_dts;
115     int64_t     start_cts;
116
117     int         hint_track;   ///< the track that hints this track, -1 if no hint track is set
118     int         src_track;    ///< the track that this hint (or tmcd) track describes
119     AVFormatContext *rtp_ctx; ///< the format context for the hinting rtp muxer
120     uint32_t    prev_rtp_ts;
121     int64_t     cur_rtp_ts_unwrapped;
122     uint32_t    max_packet_size;
123
124     int64_t     default_duration;
125     uint32_t    default_sample_flags;
126     uint32_t    default_size;
127
128     HintSampleQueue sample_queue;
129
130     AVIOContext *mdat_buf;
131     int64_t     data_offset;
132     int64_t     frag_start;
133     int         frag_discont;
134
135     int         nb_frag_info;
136     MOVFragmentInfo *frag_info;
137     unsigned    frag_info_capacity;
138
139     struct {
140         int64_t struct_offset;
141         int     first_packet_seq;
142         int     first_packet_entry;
143         int     packet_seq;
144         int     packet_entry;
145         int     slices;
146     } vc1_info;
147
148     void       *eac3_priv;
149 } MOVTrack;
150
151 typedef struct MOVMuxContext {
152     const AVClass *av_class;
153     int     mode;
154     int64_t time;
155     int     nb_streams;
156     int     nb_meta_tmcd;  ///< number of new created tmcd track based on metadata (aka not data copy)
157     int     chapter_track; ///< qt chapter track number
158     int64_t mdat_pos;
159     uint64_t mdat_size;
160     MOVTrack *tracks;
161
162     int flags;
163     int rtp_flags;
164     int exact;
165
166     int iods_skip;
167     int iods_video_profile;
168     int iods_audio_profile;
169
170     int fragments;
171     int max_fragment_duration;
172     int min_fragment_duration;
173     int max_fragment_size;
174     int ism_lookahead;
175     AVIOContext *mdat_buf;
176     int first_trun;
177
178     int video_track_timescale;
179
180     int reserved_moov_size; ///< 0 for disabled, -1 for automatic, size otherwise
181     int64_t reserved_moov_pos;
182
183     char *major_brand;
184
185     int per_stream_grouping;
186     AVFormatContext *fc;
187
188     int use_editlist;
189 } MOVMuxContext;
190
191 #define FF_MOV_FLAG_RTP_HINT              (1 <<  0)
192 #define FF_MOV_FLAG_FRAGMENT              (1 <<  1)
193 #define FF_MOV_FLAG_EMPTY_MOOV            (1 <<  2)
194 #define FF_MOV_FLAG_FRAG_KEYFRAME         (1 <<  3)
195 #define FF_MOV_FLAG_SEPARATE_MOOF         (1 <<  4)
196 #define FF_MOV_FLAG_FRAG_CUSTOM           (1 <<  5)
197 #define FF_MOV_FLAG_ISML                  (1 <<  6)
198 #define FF_MOV_FLAG_FASTSTART             (1 <<  7)
199 #define FF_MOV_FLAG_OMIT_TFHD_OFFSET      (1 <<  8)
200 #define FF_MOV_FLAG_DISABLE_CHPL          (1 <<  9)
201 #define FF_MOV_FLAG_DEFAULT_BASE_MOOF     (1 << 10)
202 #define FF_MOV_FLAG_DASH                  (1 << 11)
203 #define FF_MOV_FLAG_FRAG_DISCONT          (1 << 12)
204 #define FF_MOV_FLAG_DELAY_MOOV            (1 << 13)
205
206 int ff_mov_write_packet(AVFormatContext *s, AVPacket *pkt);
207
208 int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index);
209 int ff_mov_add_hinted_packet(AVFormatContext *s, AVPacket *pkt,
210                              int track_index, int sample,
211                              uint8_t *sample_data, int sample_size);
212 void ff_mov_close_hinting(MOVTrack *track);
213
214 #endif /* AVFORMAT_MOVENC_H */