[deb_ffmpeg.git] / ffmpeg / libavformat / movenc.h

/*
 * MOV, 3GP, MP4 muxer
 * Copyright (c) 2003 Thomas Raivio
 * Copyright (c) 2004 Gildas Bazin <gbazin at videolan dot org>
 * Copyright (c) 2009 Baptiste Coudurier <baptiste dot coudurier at gmail dot com>
 *
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * FFmpeg is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

#ifndef AVFORMAT_MOVENC_H
#define AVFORMAT_MOVENC_H

#include "avformat.h"

#define MOV_FRAG_INFO_ALLOC_INCREMENT 64
#define MOV_INDEX_CLUSTER_SIZE 1024
#define MOV_TIMESCALE 1000

#define RTP_MAX_PACKET_SIZE 1450

#define MODE_MP4  0x01
#define MODE_MOV  0x02
#define MODE_3GP  0x04
#define MODE_PSP  0x08 // example working PSP command line:
// ffmpeg -i testinput.avi  -f psp -r 14.985 -s 320x240 -b 768 -ar 24000 -ab 32 M4V00001.MP4
#define MODE_3G2  0x10
#define MODE_IPOD 0x20
#define MODE_ISM  0x40
#define MODE_F4V  0x80

typedef struct MOVIentry {
    uint64_t     pos;
    int64_t      dts;
    unsigned int size;
    unsigned int samples_in_chunk;
    unsigned int chunkNum;              ///< Chunk number if the current entry is a chunk start otherwise 0
    unsigned int entries;
    int          cts;
#define MOV_SYNC_SAMPLE         0x0001
#define MOV_PARTIAL_SYNC_SAMPLE 0x0002
    uint32_t     flags;
} MOVIentry;

typedef struct HintSample {
    uint8_t *data;
    int size;
    int sample_number;
    int offset;
    int own_data;
} HintSample;

typedef struct HintSampleQueue {
    int size;
    int len;
    HintSample *samples;
} HintSampleQueue;

typedef struct MOVFragmentInfo {
    int64_t offset;
    int64_t time;
    int64_t duration;
    int64_t tfrf_offset;
    int size;
} MOVFragmentInfo;

typedef struct MOVTrack {
    int         mode;
    int         entry;
    unsigned    timescale;
    uint64_t    time;
    int64_t     track_duration;
    int         last_sample_is_subtitle_end;
    long        sample_count;
    long        sample_size;
    long        chunkCount;
    int         has_keyframes;
#define MOV_TRACK_CTTS         0x0001
#define MOV_TRACK_STPS         0x0002
#define MOV_TRACK_ENABLED      0x0004
    uint32_t    flags;
#define MOV_TIMECODE_FLAG_DROPFRAME     0x0001
#define MOV_TIMECODE_FLAG_24HOURSMAX    0x0002
#define MOV_TIMECODE_FLAG_ALLOWNEGATIVE 0x0004
    uint32_t    timecode_flags;
    int         language;
    int         track_id;
    int         tag; ///< stsd fourcc
    AVStream        *st;
    AVCodecContext *enc;
    int multichannel_as_mono;

    int         vos_len;
    uint8_t     *vos_data;
    MOVIentry   *cluster;
    unsigned    cluster_capacity;
    int         audio_vbr;
    int         height; ///< active picture (w/o VBI) height for D-10/IMX
    uint32_t    tref_tag;
    int         tref_id; ///< trackID of the referenced track
    int64_t     start_dts;

    int         hint_track;   ///< the track that hints this track, -1 if no hint track is set
    int         src_track;    ///< the track that this hint (or tmcd) track describes
    AVFormatContext *rtp_ctx; ///< the format context for the hinting rtp muxer
    uint32_t    prev_rtp_ts;
    int64_t     cur_rtp_ts_unwrapped;
    uint32_t    max_packet_size;

    int64_t     default_duration;
    uint32_t    default_sample_flags;
    uint32_t    default_size;

    HintSampleQueue sample_queue;

    AVIOContext *mdat_buf;
    int64_t     data_offset;
    int64_t     frag_start;
    int         frag_discont;

    int         nb_frag_info;
    MOVFragmentInfo *frag_info;
    unsigned    frag_info_capacity;

    struct {
        int64_t struct_offset;
        int     first_packet_seq;
        int     first_packet_entry;
        int     packet_seq;
        int     packet_entry;
        int     slices;
    } vc1_info;

    void       *eac3_priv;
} MOVTrack;

typedef struct MOVMuxContext {
    const AVClass *av_class;
    int     mode;
    int64_t time;
    int     nb_streams;
    int     nb_meta_tmcd;  ///< number of new created tmcd track based on metadata (aka not data copy)
    int     chapter_track; ///< qt chapter track number
    int64_t mdat_pos;
    uint64_t mdat_size;
    MOVTrack *tracks;

    int flags;
    int rtp_flags;
    int exact;

    int iods_skip;
    int iods_video_profile;
    int iods_audio_profile;

    int fragments;
    int max_fragment_duration;
    int min_fragment_duration;
    int max_fragment_size;
    int ism_lookahead;
    AVIOContext *mdat_buf;
    int first_trun;

    int video_track_timescale;

    int reserved_moov_size; ///< 0 for disabled, -1 for automatic, size otherwise
    int64_t reserved_moov_pos;

    char *major_brand;

    int per_stream_grouping;
    AVFormatContext *fc;

    int use_editlist;
} MOVMuxContext;

#define FF_MOV_FLAG_RTP_HINT              (1 <<  0)
#define FF_MOV_FLAG_FRAGMENT              (1 <<  1)
#define FF_MOV_FLAG_EMPTY_MOOV            (1 <<  2)
#define FF_MOV_FLAG_FRAG_KEYFRAME         (1 <<  3)
#define FF_MOV_FLAG_SEPARATE_MOOF         (1 <<  4)
#define FF_MOV_FLAG_FRAG_CUSTOM           (1 <<  5)
#define FF_MOV_FLAG_ISML                  (1 <<  6)
#define FF_MOV_FLAG_FASTSTART             (1 <<  7)
#define FF_MOV_FLAG_OMIT_TFHD_OFFSET      (1 <<  8)
#define FF_MOV_FLAG_DISABLE_CHPL          (1 <<  9)
#define FF_MOV_FLAG_DEFAULT_BASE_MOOF     (1 << 10)
#define FF_MOV_FLAG_DASH                  (1 << 11)
#define FF_MOV_FLAG_FRAG_DISCONT          (1 << 12)

int ff_mov_write_packet(AVFormatContext *s, AVPacket *pkt);

int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index);
int ff_mov_add_hinted_packet(AVFormatContext *s, AVPacket *pkt,
                             int track_index, int sample,
                             uint8_t *sample_data, int sample_size);
void ff_mov_close_hinting(MOVTrack *track);

#endif /* AVFORMAT_MOVENC_H */
Commit	Line	Data
2ba45a60 DM	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;
f6fa7814	77	int size;
2ba45a60 DM	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
	116	int hint_track; ///< the track that hints this track, -1 if no hint track is set
	117	int src_track; ///< the track that this hint (or tmcd) track describes
	118	AVFormatContext *rtp_ctx; ///< the format context for the hinting rtp muxer
	119	uint32_t prev_rtp_ts;
	120	int64_t cur_rtp_ts_unwrapped;
	121	uint32_t max_packet_size;
	122
	123	int64_t default_duration;
	124	uint32_t default_sample_flags;
	125	uint32_t default_size;
	126
	127	HintSampleQueue sample_queue;
	128
	129	AVIOContext *mdat_buf;
	130	int64_t data_offset;
	131	int64_t frag_start;
f6fa7814	132	int frag_discont;
2ba45a60 DM	133
	134	int nb_frag_info;
	135	MOVFragmentInfo *frag_info;
	136	unsigned frag_info_capacity;
	137
	138	struct {
	139	int64_t struct_offset;
	140	int first_packet_seq;
	141	int first_packet_entry;
	142	int packet_seq;
	143	int packet_entry;
	144	int slices;
	145	} vc1_info;
f6fa7814 DM	146
f6fa7814 DM	147	void *eac3_priv;
2ba45a60 DM	148	} MOVTrack;
	149
	150	typedef struct MOVMuxContext {
	151	const AVClass *av_class;
	152	int mode;
	153	int64_t time;
	154	int nb_streams;
	155	int nb_meta_tmcd; ///< number of new created tmcd track based on metadata (aka not data copy)
	156	int chapter_track; ///< qt chapter track number
	157	int64_t mdat_pos;
	158	uint64_t mdat_size;
	159	MOVTrack *tracks;
	160
	161	int flags;
	162	int rtp_flags;
	163	int exact;
	164
	165	int iods_skip;
	166	int iods_video_profile;
	167	int iods_audio_profile;
	168
	169	int fragments;
	170	int max_fragment_duration;
	171	int min_fragment_duration;
	172	int max_fragment_size;
	173	int ism_lookahead;
	174	AVIOContext *mdat_buf;
f6fa7814	175	int first_trun;
2ba45a60	176
2ba45a60 DM	177	int video_track_timescale;
	178
	179	int reserved_moov_size; ///< 0 for disabled, -1 for automatic, size otherwise
	180	int64_t reserved_moov_pos;
	181
	182	char *major_brand;
	183
	184	int per_stream_grouping;
	185	AVFormatContext *fc;
f6fa7814 DM	186
f6fa7814 DM	187	int use_editlist;
2ba45a60 DM	188	} MOVMuxContext;
2ba45a60 DM	189
f6fa7814 DM	190	#define FF_MOV_FLAG_RTP_HINT (1 << 0)
	191	#define FF_MOV_FLAG_FRAGMENT (1 << 1)
	192	#define FF_MOV_FLAG_EMPTY_MOOV (1 << 2)
	193	#define FF_MOV_FLAG_FRAG_KEYFRAME (1 << 3)
	194	#define FF_MOV_FLAG_SEPARATE_MOOF (1 << 4)
	195	#define FF_MOV_FLAG_FRAG_CUSTOM (1 << 5)
	196	#define FF_MOV_FLAG_ISML (1 << 6)
	197	#define FF_MOV_FLAG_FASTSTART (1 << 7)
	198	#define FF_MOV_FLAG_OMIT_TFHD_OFFSET (1 << 8)
	199	#define FF_MOV_FLAG_DISABLE_CHPL (1 << 9)
	200	#define FF_MOV_FLAG_DEFAULT_BASE_MOOF (1 << 10)
	201	#define FF_MOV_FLAG_DASH (1 << 11)
	202	#define FF_MOV_FLAG_FRAG_DISCONT (1 << 12)
2ba45a60 DM	203
	204	int ff_mov_write_packet(AVFormatContext s, AVPacket pkt);
	205
	206	int ff_mov_init_hinting(AVFormatContext *s, int index, int src_index);
	207	int ff_mov_add_hinted_packet(AVFormatContext s, AVPacket pkt,
	208	int track_index, int sample,
	209	uint8_t *sample_data, int sample_size);
	210	void ff_mov_close_hinting(MOVTrack *track);
	211
	212	#endif /* AVFORMAT_MOVENC_H */