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