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 
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 {
60  int size;
62  int offset;
63  int own_data;
64 } HintSample;
65 
66 typedef struct HintSampleQueue {
67  int size;
68  int len;
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;
79 
80 typedef struct MOVTrack {
81  int mode;
82  int entry;
83  unsigned timescale;
84  uint64_t time;
85  int64_t track_duration;
89  long chunkCount;
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
105 
106  int vos_len;
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  int64_t end_pts;
117 
118  int hint_track; ///< the track that hints this track, -1 if no hint track is set
119  int src_track; ///< the track that this hint (or tmcd) track describes
120  AVFormatContext *rtp_ctx; ///< the format context for the hinting rtp muxer
121  uint32_t prev_rtp_ts;
123  uint32_t max_packet_size;
124 
127  uint32_t default_size;
128 
130 
132  int64_t data_offset;
133  int64_t frag_start;
136 
140 
141  struct {
148  int slices;
149  } vc1_info;
150 
151  void *eac3_priv;
152 } MOVTrack;
153 
154 typedef struct MOVMuxContext {
156  int mode;
157  int64_t time;
159  int nb_meta_tmcd; ///< number of new created tmcd track based on metadata (aka not data copy)
160  int chapter_track; ///< qt chapter track number
161  int64_t mdat_pos;
162  uint64_t mdat_size;
164 
165  int flags;
167  int exact;
168 
172 
181 
183 
184  int reserved_moov_size; ///< 0 for disabled, -1 for automatic, size otherwise
186 
187  char *major_brand;
188 
191 
193  float gamma;
194 
197 } MOVMuxContext;
198 
199 #define FF_MOV_FLAG_RTP_HINT (1 << 0)
200 #define FF_MOV_FLAG_FRAGMENT (1 << 1)
201 #define FF_MOV_FLAG_EMPTY_MOOV (1 << 2)
202 #define FF_MOV_FLAG_FRAG_KEYFRAME (1 << 3)
203 #define FF_MOV_FLAG_SEPARATE_MOOF (1 << 4)
204 #define FF_MOV_FLAG_FRAG_CUSTOM (1 << 5)
205 #define FF_MOV_FLAG_ISML (1 << 6)
206 #define FF_MOV_FLAG_FASTSTART (1 << 7)
207 #define FF_MOV_FLAG_OMIT_TFHD_OFFSET (1 << 8)
208 #define FF_MOV_FLAG_DISABLE_CHPL (1 << 9)
209 #define FF_MOV_FLAG_DEFAULT_BASE_MOOF (1 << 10)
210 #define FF_MOV_FLAG_DASH (1 << 11)
211 #define FF_MOV_FLAG_FRAG_DISCONT (1 << 12)
212 #define FF_MOV_FLAG_DELAY_MOOV (1 << 13)
213 #define FF_MOV_FLAG_WRITE_COLR (1 << 14)
214 #define FF_MOV_FLAG_WRITE_GAMA (1 << 15)
215 
217 
218 int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index);
220  int track_index, int sample,
221  uint8_t *sample_data, int sample_size);
222 void ff_mov_close_hinting(MOVTrack *track);
223 
224 #endif /* AVFORMAT_MOVENC_H */