git.sesse.net Git - ffmpeg/blob - 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     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 */