doxygen/trunk/movenc_8h_source.html

/*

 * 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"

#include "movenccenc.h"

#include "packet_internal.h"


#define MOV_FRAG_INFO_ALLOC_INCREMENT 64

#define MOV_INDEX_CLUSTER_SIZE 1024

#define MOV_TIMESCALE 1000

#define MOV_TIMESCALE_Q (AVRational){1, 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

#define MODE_AVIF 0x100


typedef struct MOVIentry {

    uint64_t     pos;

    int64_t      dts;

    int64_t      pts;

    unsigned int size;

    unsigned int stsd_index;

    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

#define MOV_DISPOSABLE_SAMPLE   0x0004

    uint32_t     flags;

    AVProducerReferenceTime prft;

} MOVIentry;


typedef struct HintSample {

    const 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 MovTag {

    uint32_t    name;

    int         nb_id;

    uint32_t   *id; ///< trackID of the referenced track

} MovTag;


typedef struct MOVTrack {

    int         mode;

    int         entry_version;

    int         entry, entry_written;

    unsigned    timescale;

    uint64_t    time;

    int64_t     track_duration;

    int         last_sample_is_subtitle_end;


    /* multiple stsd */

    int         stsd_count;

    int         last_stsd_index;

    uint8_t     **extradata;

    int         *extradata_size;


    long        sample_count;

    long        sample_size;

    long        chunkCount;

    int         has_keyframes;

    int         has_disposable;

#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;

    AVCodecParameters *par;

    int mono_as_fc;

    int multichannel_as_mono;


    MOVIentry   *cluster;

    MOVIentry   *cluster_written;

    unsigned    cluster_capacity;

    int         audio_vbr;

    int         height; ///< active picture (w/o VBI) height for D-10/IMX

    int         nb_tref_tags;

    MovTag      *tref_tags;

    int64_t     start_dts;

    int64_t     start_cts;

    int64_t     end_pts;

    int64_t     elst_end_pts;

    int         end_reliable;

    int64_t     dts_shift;


    int         hint_track;   ///< the track that hints this track, -1 if no hint track is set

    int         nb_src_track;

    int         *src_track;   ///< the tracks 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;

    AVPacket *cover_image;


    AVIOContext *mdat_buf;

    int64_t     data_offset;

    int         frag_discont;

    int         entries_flushed;


    int         nb_frag_info;

    MOVFragmentInfo *frag_info;

    unsigned    frag_info_capacity;


    struct {

        int     first_packet_seq;

        int     first_packet_entry;

        int     first_packet_seen;

        int     first_frag_written;

        int     packet_seq;

        int     packet_entry;

        int     slices;

    } vc1_info;


    void       *eac3_priv;


    MOVMuxCencContext cenc;


    uint32_t palette[AVPALETTE_COUNT];

    int pal_done;


    int is_unaligned_qt_rgb;


    unsigned int squash_fragment_samples_to_one; //< flag to note formats where all samples for a fragment are to be squashed


    PacketList squashed_packet_queue;


    struct IAMFContext *iamf;

    int first_iamf_idx;

    int last_iamf_idx;

    AVIOContext *iamf_buf;


    struct APVDecoderConfigurationRecord *apv;

} MOVTrack;


typedef enum {

    MOV_ENC_NONE = 0,

    MOV_ENC_CENC_AES_CTR,

} MOVEncryptionScheme;


typedef enum {

    MOV_PRFT_NONE = 0,

    MOV_PRFT_SRC_WALLCLOCK,

    MOV_PRFT_SRC_PTS,

    MOV_PRFT_NB

} MOVPrftBox;


typedef struct MOVMuxContext {

    const AVClass *av_class;

    int     mode;

    int64_t time;

    int     nb_streams;

    int     nb_tracks;

    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 iods_skip;

    int iods_video_profile;

    int iods_audio_profile;


    int moov_written;

    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_header_pos;


    char *major_brand;


    int per_stream_grouping;

    AVFormatContext *fc;


    AVPacket *pkt;


    int use_editlist;

    float gamma;


    int frag_interleave;

    int missing_duration_warned;


    char *encryption_scheme_str;

    MOVEncryptionScheme encryption_scheme;

    uint8_t *encryption_key;

    int encryption_key_len;

    uint8_t *encryption_kid;

    int encryption_kid_len;


    int use_stream_ids_as_track_ids;

    int track_ids_ok;

    int write_btrt;

    int write_tmcd;

    MOVPrftBox write_prft;

    int empty_hdlr_name;

    int movie_timescale;


    int64_t avif_extent_pos[2];  // index 0 is YUV and 1 is Alpha.

    int avif_extent_length[2];   // index 0 is YUV and 1 is Alpha.

    int is_animated_avif;

    int avif_loop_count;

} 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)

#define FF_MOV_FLAG_DELAY_MOOV            (1 << 13)

#define FF_MOV_FLAG_GLOBAL_SIDX           (1 << 14)

#define FF_MOV_FLAG_WRITE_COLR            (1 << 15)

#define FF_MOV_FLAG_WRITE_GAMA            (1 << 16)

#define FF_MOV_FLAG_USE_MDTA              (1 << 17)

#define FF_MOV_FLAG_SKIP_TRAILER          (1 << 18)

#define FF_MOV_FLAG_NEGATIVE_CTS_OFFSETS  (1 << 19)

#define FF_MOV_FLAG_FRAG_EVERY_FRAME      (1 << 20)

#define FF_MOV_FLAG_SKIP_SIDX             (1 << 21)

#define FF_MOV_FLAG_CMAF                  (1 << 22)

#define FF_MOV_FLAG_PREFER_ICC            (1 << 23)

#define FF_MOV_FLAG_HYBRID_FRAGMENTED     (1 << 24)


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 */