mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-23 18:21:04 +00:00
1149 lines
30 KiB
C
1149 lines
30 KiB
C
/* Quicktime muxer plugin for GStreamer
|
|
* Copyright (C) 2008-2010 Thiago Santos <thiagoss@embedded.ufcg.edu.br>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
/*
|
|
* Unless otherwise indicated, Source Code is licensed under MIT license.
|
|
* See further explanation attached in License Statement (distributed in the file
|
|
* LICENSE).
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
* this software and associated documentation files (the "Software"), to deal in
|
|
* the Software without restriction, including without limitation the rights to
|
|
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
* of the Software, and to permit persons to whom the Software is furnished to do
|
|
* so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in all
|
|
* copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*/
|
|
|
|
#ifndef __ATOMS_H__
|
|
#define __ATOMS_H__
|
|
|
|
#include <glib.h>
|
|
#include <string.h>
|
|
#include <gst/video/video.h>
|
|
|
|
#include "descriptors.h"
|
|
#include "properties.h"
|
|
#include "fourcc.h"
|
|
|
|
/* helper storage struct */
|
|
#define ATOM_ARRAY(struct_type) \
|
|
struct { \
|
|
guint size; \
|
|
guint len; \
|
|
struct_type *data; \
|
|
}
|
|
|
|
/* storage helpers */
|
|
|
|
#define atom_array_init(array, reserve) \
|
|
G_STMT_START { \
|
|
(array)->len = 0; \
|
|
(array)->size = reserve; \
|
|
(array)->data = g_malloc (sizeof (*(array)->data) * reserve); \
|
|
} G_STMT_END
|
|
|
|
#define atom_array_append(array, elmt, inc) \
|
|
G_STMT_START { \
|
|
g_assert ((array)->data); \
|
|
g_assert (inc > 0); \
|
|
if (G_UNLIKELY ((array)->len == (array)->size)) { \
|
|
(array)->size += inc; \
|
|
(array)->data = \
|
|
g_realloc ((array)->data, sizeof (*((array)->data)) * (array)->size); \
|
|
} \
|
|
(array)->data[(array)->len] = elmt; \
|
|
(array)->len++; \
|
|
} G_STMT_END
|
|
|
|
#define atom_array_get_len(array) ((array)->len)
|
|
#define atom_array_index(array, index) ((array)->data[index])
|
|
|
|
#define atom_array_clear(array) \
|
|
G_STMT_START { \
|
|
(array)->size = (array)->len = 0; \
|
|
g_free ((array)->data); \
|
|
(array)->data = NULL; \
|
|
} G_STMT_END
|
|
|
|
/* light-weight context that may influence header atom tree construction */
|
|
typedef enum _AtomsTreeFlavor
|
|
{
|
|
ATOMS_TREE_FLAVOR_MOV,
|
|
ATOMS_TREE_FLAVOR_ISOM,
|
|
ATOMS_TREE_FLAVOR_3GP,
|
|
ATOMS_TREE_FLAVOR_ISML
|
|
} AtomsTreeFlavor;
|
|
|
|
typedef struct _AtomsContext
|
|
{
|
|
AtomsTreeFlavor flavor;
|
|
gboolean force_create_timecode_trak;
|
|
} AtomsContext;
|
|
|
|
AtomsContext* atoms_context_new (AtomsTreeFlavor flavor, gboolean force_create_timecode_trak);
|
|
void atoms_context_free (AtomsContext *context);
|
|
|
|
#define METADATA_DATA_FLAG 0x0
|
|
#define METADATA_TEXT_FLAG 0x1
|
|
|
|
/* atom defs and functions */
|
|
|
|
typedef struct _AtomInfo AtomInfo;
|
|
|
|
/*
|
|
* Used for storing time related values for some atoms.
|
|
*/
|
|
typedef struct _TimeInfo
|
|
{
|
|
guint64 creation_time;
|
|
guint64 modification_time;
|
|
guint32 timescale;
|
|
guint64 duration;
|
|
} TimeInfo;
|
|
|
|
typedef struct _Atom
|
|
{
|
|
guint32 size;
|
|
guint32 type;
|
|
guint64 extended_size;
|
|
} Atom;
|
|
|
|
typedef struct _AtomFull
|
|
{
|
|
Atom header;
|
|
|
|
guint8 version;
|
|
guint8 flags[3];
|
|
} AtomFull;
|
|
|
|
/*
|
|
* Generic extension atom
|
|
*/
|
|
typedef struct _AtomData
|
|
{
|
|
Atom header;
|
|
|
|
/* not written */
|
|
guint32 datalen;
|
|
|
|
guint8 *data;
|
|
} AtomData;
|
|
|
|
typedef struct _AtomUUID
|
|
{
|
|
Atom header;
|
|
|
|
guint8 uuid[16];
|
|
|
|
/* not written */
|
|
guint32 datalen;
|
|
|
|
guint8 *data;
|
|
} AtomUUID;
|
|
|
|
typedef struct _AtomFTYP
|
|
{
|
|
Atom header;
|
|
guint32 major_brand;
|
|
guint32 version;
|
|
guint32 *compatible_brands;
|
|
|
|
/* not written */
|
|
guint32 compatible_brands_size;
|
|
} AtomFTYP;
|
|
|
|
typedef struct _AtomMVHD
|
|
{
|
|
AtomFull header;
|
|
|
|
/* version 0: 32 bits */
|
|
TimeInfo time_info;
|
|
|
|
guint32 prefered_rate; /* ISO: 0x00010000 */
|
|
guint16 volume; /* ISO: 0x0100 */
|
|
guint16 reserved3; /* ISO: 0x0 */
|
|
guint32 reserved4[2]; /* ISO: 0, 0 */
|
|
/* ISO: identity matrix =
|
|
* { 0x00010000, 0, 0, 0, 0x00010000, 0, 0, 0, 0x40000000 } */
|
|
guint32 matrix[9];
|
|
|
|
/* ISO: all 0 */
|
|
guint32 preview_time;
|
|
guint32 preview_duration;
|
|
guint32 poster_time;
|
|
guint32 selection_time;
|
|
guint32 selection_duration;
|
|
guint32 current_time;
|
|
|
|
guint32 next_track_id;
|
|
} AtomMVHD;
|
|
|
|
typedef struct _AtomTKHD
|
|
{
|
|
AtomFull header;
|
|
|
|
/* version 0: 32 bits */
|
|
/* like the TimeInfo struct, but it has this track_ID inside */
|
|
guint64 creation_time;
|
|
guint64 modification_time;
|
|
guint32 track_ID;
|
|
guint32 reserved;
|
|
guint64 duration;
|
|
|
|
guint32 reserved2[2];
|
|
guint16 layer;
|
|
guint16 alternate_group;
|
|
guint16 volume;
|
|
guint16 reserved3;
|
|
|
|
/* ISO: identity matrix =
|
|
* { 0x00010000, 0, 0, 0, 0x00010000, 0, 0, 0, 0x40000000 } */
|
|
guint32 matrix[9];
|
|
guint32 width;
|
|
guint32 height;
|
|
} AtomTKHD;
|
|
|
|
typedef struct _AtomMDHD
|
|
{
|
|
AtomFull header;
|
|
|
|
/* version 0: 32 bits */
|
|
TimeInfo time_info;
|
|
|
|
/* ISO: packed ISO-639-2/T language code (first bit must be 0) */
|
|
guint16 language_code;
|
|
/* ISO: 0 */
|
|
guint16 quality;
|
|
} AtomMDHD;
|
|
|
|
typedef struct _AtomHDLR
|
|
{
|
|
AtomFull header;
|
|
|
|
/* ISO: 0 */
|
|
guint32 component_type;
|
|
guint32 handler_type;
|
|
guint32 manufacturer;
|
|
guint32 flags;
|
|
guint32 flags_mask;
|
|
gchar *name;
|
|
|
|
AtomsTreeFlavor flavor;
|
|
} AtomHDLR;
|
|
|
|
typedef struct _AtomVMHD
|
|
{
|
|
AtomFull header; /* ISO: flags = 1 */
|
|
|
|
guint16 graphics_mode;
|
|
/* RGB */
|
|
guint16 opcolor[3];
|
|
} AtomVMHD;
|
|
|
|
typedef struct _AtomSMHD
|
|
{
|
|
AtomFull header;
|
|
|
|
guint16 balance;
|
|
guint16 reserved;
|
|
} AtomSMHD;
|
|
|
|
typedef struct _AtomHMHD
|
|
{
|
|
AtomFull header;
|
|
|
|
guint16 max_pdu_size;
|
|
guint16 avg_pdu_size;
|
|
guint32 max_bitrate;
|
|
guint32 avg_bitrate;
|
|
guint32 sliding_avg_bitrate;
|
|
} AtomHMHD;
|
|
|
|
typedef struct _AtomTCMI
|
|
{
|
|
AtomFull header;
|
|
|
|
guint16 text_font;
|
|
guint16 text_face;
|
|
guint16 text_size;
|
|
guint16 text_color[3];
|
|
guint16 bg_color[3];
|
|
gchar *font_name;
|
|
} AtomTCMI;
|
|
|
|
typedef struct _AtomTMCD
|
|
{
|
|
Atom header;
|
|
|
|
AtomTCMI tcmi;
|
|
} AtomTMCD;
|
|
|
|
typedef struct _AtomGMIN
|
|
{
|
|
AtomFull header;
|
|
|
|
guint16 graphics_mode;
|
|
guint16 opcolor[3];
|
|
guint8 balance;
|
|
guint8 reserved;
|
|
|
|
} AtomGMIN;
|
|
|
|
typedef struct _AtomGMHD
|
|
{
|
|
Atom header;
|
|
|
|
/* Only gmin is required in a gmhd atom
|
|
* The other fields are optional */
|
|
AtomGMIN gmin;
|
|
AtomTMCD *tmcd;
|
|
|
|
} AtomGMHD;
|
|
|
|
typedef struct _AtomNMHD
|
|
{
|
|
Atom header;
|
|
guint32 flags;
|
|
} AtomNMHD;
|
|
|
|
typedef struct _AtomURL
|
|
{
|
|
AtomFull header;
|
|
|
|
gchar *location;
|
|
} AtomURL;
|
|
|
|
typedef struct _AtomDREF
|
|
{
|
|
AtomFull header;
|
|
|
|
GList *entries;
|
|
} AtomDREF;
|
|
|
|
typedef struct _AtomDINF
|
|
{
|
|
Atom header;
|
|
|
|
AtomDREF dref;
|
|
} AtomDINF;
|
|
|
|
typedef struct _STTSEntry
|
|
{
|
|
guint32 sample_count;
|
|
gint32 sample_delta;
|
|
} STTSEntry;
|
|
|
|
typedef struct _AtomSTTS
|
|
{
|
|
AtomFull header;
|
|
|
|
ATOM_ARRAY (STTSEntry) entries;
|
|
} AtomSTTS;
|
|
|
|
typedef struct _AtomSTSS
|
|
{
|
|
AtomFull header;
|
|
|
|
ATOM_ARRAY (guint32) entries;
|
|
} AtomSTSS;
|
|
|
|
typedef struct _AtomESDS
|
|
{
|
|
AtomFull header;
|
|
|
|
ESDescriptor es;
|
|
} AtomESDS;
|
|
|
|
typedef struct _AtomFRMA
|
|
{
|
|
Atom header;
|
|
|
|
guint32 media_type;
|
|
} AtomFRMA;
|
|
|
|
typedef enum _SampleEntryKind
|
|
{
|
|
UNKNOWN,
|
|
AUDIO,
|
|
VIDEO,
|
|
SUBTITLE,
|
|
TIMECODE,
|
|
CLOSEDCAPTION
|
|
} SampleEntryKind;
|
|
|
|
typedef struct _SampleTableEntry
|
|
{
|
|
Atom header;
|
|
|
|
guint8 reserved[6];
|
|
guint16 data_reference_index;
|
|
|
|
/* type of entry */
|
|
SampleEntryKind kind;
|
|
} SampleTableEntry;
|
|
|
|
typedef struct _AtomHintSampleEntry
|
|
{
|
|
SampleTableEntry se;
|
|
guint32 size;
|
|
guint8 *data;
|
|
} AtomHintSampleEntry;
|
|
|
|
typedef struct _SampleTableEntryMP4V
|
|
{
|
|
SampleTableEntry se;
|
|
|
|
guint16 version;
|
|
guint16 revision_level;
|
|
|
|
guint32 vendor; /* fourcc code */
|
|
guint32 temporal_quality;
|
|
guint32 spatial_quality;
|
|
|
|
guint16 width;
|
|
guint16 height;
|
|
|
|
guint32 horizontal_resolution;
|
|
guint32 vertical_resolution;
|
|
guint32 datasize;
|
|
|
|
guint16 frame_count; /* usually 1 */
|
|
|
|
guint8 compressor[32]; /* pascal string, i.e. first byte = length */
|
|
|
|
guint16 depth;
|
|
guint16 color_table_id;
|
|
|
|
/* (optional) list of AtomInfo */
|
|
GList *extension_atoms;
|
|
} SampleTableEntryMP4V;
|
|
|
|
typedef struct _SampleTableEntryMP4A
|
|
{
|
|
SampleTableEntry se;
|
|
|
|
guint16 version;
|
|
guint16 revision_level;
|
|
guint32 vendor;
|
|
|
|
guint16 channels;
|
|
guint16 sample_size;
|
|
guint16 compression_id;
|
|
guint16 packet_size;
|
|
|
|
guint32 sample_rate; /* fixed point 16.16 */
|
|
|
|
guint32 samples_per_packet;
|
|
guint32 bytes_per_packet;
|
|
guint32 bytes_per_frame;
|
|
guint32 bytes_per_sample;
|
|
|
|
/* (optional) list of AtomInfo */
|
|
GList *extension_atoms;
|
|
} SampleTableEntryMP4A;
|
|
|
|
typedef struct _AtomNAME
|
|
{
|
|
Atom header;
|
|
|
|
guint8 language_code;
|
|
gchar *name;
|
|
} AtomNAME;
|
|
|
|
typedef struct _SampleTableEntryTMCD
|
|
{
|
|
SampleTableEntry se;
|
|
|
|
guint32 tc_flags;
|
|
guint32 timescale;
|
|
guint32 frame_duration;
|
|
guint8 n_frames;
|
|
|
|
AtomNAME name;
|
|
|
|
} SampleTableEntryTMCD;
|
|
|
|
typedef struct _SampleTableEntryTX3G
|
|
{
|
|
SampleTableEntry se;
|
|
|
|
guint32 display_flags;
|
|
guint64 default_text_box;
|
|
guint16 font_id;
|
|
guint8 font_face; /* bold=0x1, italic=0x2, underline=0x4 */
|
|
guint8 font_size; /* should always be 0.05 multiplied by the video track header height */
|
|
guint32 foreground_color_rgba;
|
|
|
|
} SampleTableEntryTX3G;
|
|
|
|
typedef struct _AtomSTSD
|
|
{
|
|
AtomFull header;
|
|
|
|
guint n_entries;
|
|
/* list of subclasses of SampleTableEntry */
|
|
GList *entries;
|
|
} AtomSTSD;
|
|
|
|
typedef struct _AtomSTSZ
|
|
{
|
|
AtomFull header;
|
|
|
|
guint32 sample_size;
|
|
|
|
/* need the size here because when sample_size is constant,
|
|
* the list is empty */
|
|
guint32 table_size;
|
|
ATOM_ARRAY (guint32) entries;
|
|
} AtomSTSZ;
|
|
|
|
typedef struct _STSCEntry
|
|
{
|
|
guint32 first_chunk;
|
|
guint32 samples_per_chunk;
|
|
guint32 sample_description_index;
|
|
} STSCEntry;
|
|
|
|
typedef struct _AtomSTSC
|
|
{
|
|
AtomFull header;
|
|
|
|
ATOM_ARRAY (STSCEntry) entries;
|
|
} AtomSTSC;
|
|
|
|
/* FIXME: this can support multiple tracks */
|
|
typedef struct _AtomTREF
|
|
{
|
|
Atom header;
|
|
|
|
guint32 reftype;
|
|
ATOM_ARRAY (guint32) entries;
|
|
} AtomTREF;
|
|
|
|
/*
|
|
* used for both STCO and CO64
|
|
* The table will be written out as STCO automatically when
|
|
* the offsets being written will fit in a 32-bit table,
|
|
* otherwise it is written as CO64
|
|
*/
|
|
typedef struct _AtomSTCO64
|
|
{
|
|
AtomFull header;
|
|
/* Global offset to add to entries when serialising */
|
|
guint32 chunk_offset;
|
|
/* Maximum offset stored in the table */
|
|
guint64 max_offset;
|
|
ATOM_ARRAY (guint64) entries;
|
|
} AtomSTCO64;
|
|
|
|
typedef struct _CTTSEntry
|
|
{
|
|
guint32 samplecount;
|
|
guint32 sampleoffset;
|
|
} CTTSEntry;
|
|
|
|
typedef struct _AtomCTTS
|
|
{
|
|
AtomFull header;
|
|
|
|
/* also entry count here */
|
|
ATOM_ARRAY (CTTSEntry) entries;
|
|
gboolean do_pts;
|
|
} AtomCTTS;
|
|
|
|
typedef struct _AtomSVMI
|
|
{
|
|
AtomFull header;
|
|
|
|
guint8 stereoscopic_composition_type;
|
|
gboolean is_left_first;
|
|
} AtomSVMI;
|
|
|
|
typedef struct _AtomSTBL
|
|
{
|
|
Atom header;
|
|
|
|
AtomSTSD stsd;
|
|
AtomSTTS stts;
|
|
AtomSTSS stss;
|
|
AtomSTSC stsc;
|
|
AtomSTSZ stsz;
|
|
/* NULL if not present */
|
|
AtomCTTS *ctts;
|
|
/* NULL if not present */
|
|
AtomSVMI *svmi;
|
|
|
|
AtomSTCO64 stco64;
|
|
} AtomSTBL;
|
|
|
|
typedef struct _AtomMINF
|
|
{
|
|
Atom header;
|
|
|
|
/* only (exactly) one of those must be present */
|
|
AtomVMHD *vmhd;
|
|
AtomSMHD *smhd;
|
|
AtomHMHD *hmhd;
|
|
AtomGMHD *gmhd;
|
|
AtomNMHD *nmhd;
|
|
|
|
AtomHDLR *hdlr;
|
|
AtomDINF dinf;
|
|
AtomSTBL stbl;
|
|
} AtomMINF;
|
|
|
|
typedef struct _EditListEntry
|
|
{
|
|
/* duration in movie's timescale */
|
|
guint32 duration;
|
|
/* start time in media's timescale, -1 for empty */
|
|
guint32 media_time;
|
|
guint32 media_rate; /* fixed point 32 bit */
|
|
} EditListEntry;
|
|
|
|
typedef struct _AtomELST
|
|
{
|
|
AtomFull header;
|
|
|
|
/* number of entries is implicit */
|
|
GSList *entries;
|
|
} AtomELST;
|
|
|
|
typedef struct _AtomEDTS
|
|
{
|
|
Atom header;
|
|
AtomELST elst;
|
|
} AtomEDTS;
|
|
|
|
typedef struct _AtomMDIA
|
|
{
|
|
Atom header;
|
|
|
|
AtomMDHD mdhd;
|
|
AtomHDLR hdlr;
|
|
AtomMINF minf;
|
|
} AtomMDIA;
|
|
|
|
typedef struct _AtomILST
|
|
{
|
|
Atom header;
|
|
|
|
/* list of AtomInfo */
|
|
GList* entries;
|
|
} AtomILST;
|
|
|
|
typedef struct _AtomTagData
|
|
{
|
|
AtomFull header;
|
|
guint32 reserved;
|
|
|
|
guint32 datalen;
|
|
guint8* data;
|
|
} AtomTagData;
|
|
|
|
typedef struct _AtomTag
|
|
{
|
|
Atom header;
|
|
|
|
AtomTagData data;
|
|
} AtomTag;
|
|
|
|
typedef struct _AtomMETA
|
|
{
|
|
AtomFull header;
|
|
AtomHDLR hdlr;
|
|
AtomILST *ilst;
|
|
} AtomMETA;
|
|
|
|
typedef struct _AtomUDTA
|
|
{
|
|
Atom header;
|
|
|
|
/* list of AtomInfo */
|
|
GList* entries;
|
|
/* or list is further down */
|
|
AtomMETA *meta;
|
|
|
|
AtomsContext *context;
|
|
} AtomUDTA;
|
|
|
|
enum TrFlags
|
|
{
|
|
TR_DATA_OFFSET = 0x01, /* data-offset-present */
|
|
TR_FIRST_SAMPLE_FLAGS = 0x04, /* first-sample-flags-present */
|
|
TR_SAMPLE_DURATION = 0x0100, /* sample-duration-present */
|
|
TR_SAMPLE_SIZE = 0x0200, /* sample-size-present */
|
|
TR_SAMPLE_FLAGS = 0x0400, /* sample-flags-present */
|
|
TR_COMPOSITION_TIME_OFFSETS = 0x0800 /* sample-composition-time-offsets-presents */
|
|
};
|
|
|
|
enum TfFlags
|
|
{
|
|
TF_BASE_DATA_OFFSET = 0x01, /* base-data-offset-present */
|
|
TF_SAMPLE_DESCRIPTION_INDEX = 0x02, /* sample-description-index-present */
|
|
TF_DEFAULT_SAMPLE_DURATION = 0x08, /* default-sample-duration-present */
|
|
TF_DEFAULT_SAMPLE_SIZE = 0x010, /* default-sample-size-present */
|
|
TF_DEFAULT_SAMPLE_FLAGS = 0x020, /* default-sample-flags-present */
|
|
TF_DURATION_IS_EMPTY = 0x010000, /* sample-composition-time-offsets-presents */
|
|
TF_DEFAULT_BASE_IS_MOOF = 0x020000 /* default-base-is-moof */
|
|
};
|
|
|
|
/* Timecode flags */
|
|
enum TcFlags
|
|
{
|
|
TC_DROP_FRAME = 0x0001, /* Drop-frame timecode */
|
|
TC_24H_MAX = 0x0002, /* Whether the timecode wraps after 24 hours */
|
|
TC_NEGATIVE_OK = 0x0004, /* Whether negative time values are OK */
|
|
TC_COUNTER = 0x0008 /* Whether the time value corresponds to a tape counter value */
|
|
};
|
|
|
|
typedef struct _AtomTRAK
|
|
{
|
|
Atom header;
|
|
|
|
AtomTKHD tkhd;
|
|
AtomInfo *tapt;
|
|
AtomEDTS *edts;
|
|
AtomMDIA mdia;
|
|
AtomUDTA udta;
|
|
AtomTREF *tref;
|
|
|
|
/* some helper info for structural conformity checks */
|
|
gboolean is_video;
|
|
gboolean is_h264;
|
|
|
|
AtomsContext *context;
|
|
} AtomTRAK;
|
|
|
|
typedef struct _AtomTREX
|
|
{
|
|
AtomFull header;
|
|
|
|
guint32 track_ID;
|
|
guint32 default_sample_description_index;
|
|
guint32 default_sample_duration;
|
|
guint32 default_sample_size;
|
|
guint32 default_sample_flags;
|
|
} AtomTREX;
|
|
|
|
typedef struct _AtomMEHD
|
|
{
|
|
AtomFull header;
|
|
|
|
guint64 fragment_duration;
|
|
} AtomMEHD;
|
|
|
|
|
|
typedef struct _AtomMVEX
|
|
{
|
|
Atom header;
|
|
|
|
AtomMEHD mehd;
|
|
|
|
/* list of AtomTREX */
|
|
GList *trexs;
|
|
} AtomMVEX;
|
|
|
|
typedef struct _AtomMFHD
|
|
{
|
|
AtomFull header;
|
|
|
|
guint32 sequence_number;
|
|
} AtomMFHD;
|
|
|
|
typedef struct _AtomTFHD
|
|
{
|
|
AtomFull header;
|
|
|
|
guint32 track_ID;
|
|
guint64 base_data_offset;
|
|
guint32 sample_description_index;
|
|
guint32 default_sample_duration;
|
|
guint32 default_sample_size;
|
|
guint32 default_sample_flags;
|
|
} AtomTFHD;
|
|
|
|
typedef struct _AtomTFDT
|
|
{
|
|
AtomFull header;
|
|
|
|
guint64 base_media_decode_time;
|
|
} AtomTFDT;
|
|
|
|
typedef struct _TRUNSampleEntry
|
|
{
|
|
guint32 sample_duration;
|
|
guint32 sample_size;
|
|
guint32 sample_flags;
|
|
guint32 sample_composition_time_offset;
|
|
} TRUNSampleEntry;
|
|
|
|
typedef struct _AtomTRUN
|
|
{
|
|
AtomFull header;
|
|
|
|
guint32 sample_count;
|
|
gint32 data_offset;
|
|
guint32 first_sample_flags;
|
|
|
|
/* array of fields */
|
|
ATOM_ARRAY (TRUNSampleEntry) entries;
|
|
} AtomTRUN;
|
|
|
|
typedef struct _AtomSDTP
|
|
{
|
|
AtomFull header;
|
|
|
|
/* not serialized */
|
|
guint32 sample_count;
|
|
|
|
/* array of fields */
|
|
ATOM_ARRAY (guint8) entries;
|
|
} AtomSDTP;
|
|
|
|
typedef struct _AtomTRAF
|
|
{
|
|
Atom header;
|
|
|
|
AtomTFHD tfhd;
|
|
|
|
AtomTFDT tfdt;
|
|
|
|
/* list of AtomTRUN. */
|
|
GList *truns;
|
|
/* list of AtomSDTP */
|
|
GList *sdtps;
|
|
} AtomTRAF;
|
|
|
|
typedef struct _AtomMOOF
|
|
{
|
|
Atom header;
|
|
|
|
AtomMFHD mfhd;
|
|
|
|
/* list of AtomTRAF */
|
|
GList *trafs;
|
|
|
|
guint64 traf_offset;
|
|
} AtomMOOF;
|
|
|
|
|
|
typedef struct _AtomMOOV
|
|
{
|
|
/* style */
|
|
AtomsContext context;
|
|
|
|
Atom header;
|
|
|
|
AtomMVHD mvhd;
|
|
AtomMVEX mvex;
|
|
|
|
/* list of AtomTRAK */
|
|
GList *traks;
|
|
AtomUDTA udta;
|
|
|
|
gboolean fragmented;
|
|
guint32 chunks_offset;
|
|
} AtomMOOV;
|
|
|
|
typedef struct _AtomWAVE
|
|
{
|
|
Atom header;
|
|
|
|
/* list of AtomInfo */
|
|
GList *extension_atoms;
|
|
} AtomWAVE;
|
|
|
|
typedef struct _TFRAEntry
|
|
{
|
|
guint64 time;
|
|
guint64 moof_offset;
|
|
guint32 traf_number;
|
|
guint32 trun_number;
|
|
guint32 sample_number;
|
|
} TFRAEntry;
|
|
|
|
typedef struct _AtomTFRA
|
|
{
|
|
AtomFull header;
|
|
|
|
guint32 track_ID;
|
|
guint32 lengths;
|
|
/* array of entries */
|
|
ATOM_ARRAY (TFRAEntry) entries;
|
|
} AtomTFRA;
|
|
|
|
typedef struct _AtomMFRA
|
|
{
|
|
Atom header;
|
|
|
|
/* list of tfra */
|
|
GList *tfras;
|
|
} AtomMFRA;
|
|
|
|
/*
|
|
* Function to serialize an atom
|
|
*/
|
|
typedef guint64 (*AtomCopyDataFunc) (Atom *atom, guint8 **buffer, guint64 *size, guint64 *offset);
|
|
|
|
/*
|
|
* Releases memory allocated by an atom
|
|
*/
|
|
typedef guint64 (*AtomFreeFunc) (Atom *atom);
|
|
|
|
/*
|
|
* Some atoms might have many optional different kinds of child atoms, so this
|
|
* is useful for enabling generic handling of any atom.
|
|
* All we need are the two functions (copying it to an array
|
|
* for serialization and the memory releasing function).
|
|
*/
|
|
struct _AtomInfo
|
|
{
|
|
Atom *atom;
|
|
AtomCopyDataFunc copy_data_func;
|
|
AtomFreeFunc free_func;
|
|
};
|
|
|
|
guint64 atoms_get_current_qt_time (void);
|
|
|
|
guint64 atom_copy_data (Atom *atom, guint8 **buffer,
|
|
guint64 *size, guint64* offset);
|
|
|
|
AtomFTYP* atom_ftyp_new (AtomsContext *context, guint32 major,
|
|
guint32 version, GList *brands);
|
|
guint64 atom_ftyp_copy_data (AtomFTYP *ftyp, guint8 **buffer,
|
|
guint64 *size, guint64 *offset);
|
|
void atom_ftyp_free (AtomFTYP *ftyp);
|
|
|
|
AtomTRAK* atom_trak_new (AtomsContext *context);
|
|
void atom_trak_add_samples (AtomTRAK * trak, guint32 nsamples, guint32 delta,
|
|
guint32 size, guint64 chunk_offset, gboolean sync,
|
|
gint64 pts_offset);
|
|
void atom_trak_set_elst_entry (AtomTRAK * trak, gint index, guint32 duration,
|
|
guint32 media_time, guint32 rate);
|
|
void atom_trak_edts_clear (AtomTRAK * trak);
|
|
guint32 atom_trak_get_timescale (AtomTRAK *trak);
|
|
guint32 atom_trak_get_id (AtomTRAK * trak);
|
|
void atom_trak_set_constant_size_samples (AtomTRAK * trak, guint32 sample_size);
|
|
void atom_stbl_add_samples (AtomSTBL * stbl, guint32 nsamples,
|
|
guint32 delta, guint32 size,
|
|
guint64 chunk_offset, gboolean sync,
|
|
gint64 pts_offset);
|
|
void atom_stsc_add_new_entry (AtomSTSC * stsc,
|
|
guint32 first_chunk, guint32 nsamples, guint32 sample_description_index);
|
|
|
|
AtomMOOV* atom_moov_new (AtomsContext *context);
|
|
void atom_moov_free (AtomMOOV *moov);
|
|
guint64 atom_moov_copy_data (AtomMOOV *atom, guint8 **buffer, guint64 *size, guint64* offset);
|
|
void atom_moov_update_timescale (AtomMOOV *moov, guint32 timescale);
|
|
void atom_moov_update_duration (AtomMOOV *moov);
|
|
void atom_moov_set_fragmented (AtomMOOV *moov, gboolean fragmented);
|
|
void atom_moov_chunks_set_offset (AtomMOOV *moov, guint32 offset);
|
|
void atom_moov_add_trak (AtomMOOV *moov, AtomTRAK *trak);
|
|
guint atom_moov_get_trak_count (AtomMOOV *moov);
|
|
|
|
guint atom_framerate_to_timescale (gint fps_n, gint fps_d);
|
|
|
|
guint64 atom_mvhd_copy_data (AtomMVHD * atom, guint8 ** buffer,
|
|
guint64 * size, guint64 * offset);
|
|
void atom_stco64_chunks_set_offset (AtomSTCO64 * stco64, guint32 offset);
|
|
guint64 atom_trak_copy_data (AtomTRAK * atom, guint8 ** buffer,
|
|
guint64 * size, guint64 * offset);
|
|
void atom_stbl_clear (AtomSTBL * stbl);
|
|
void atom_stbl_init (AtomSTBL * stbl);
|
|
guint64 atom_stss_copy_data (AtomSTSS *atom, guint8 **buffer,
|
|
guint64 *size, guint64* offset);
|
|
guint64 atom_stts_copy_data (AtomSTTS *atom, guint8 **buffer,
|
|
guint64 *size, guint64* offset);
|
|
guint64 atom_stsc_copy_data (AtomSTSC *atom, guint8 **buffer,
|
|
guint64 *size, guint64* offset);
|
|
guint64 atom_stsz_copy_data (AtomSTSZ *atom, guint8 **buffer,
|
|
guint64 *size, guint64* offset);
|
|
guint64 atom_ctts_copy_data (AtomCTTS *atom, guint8 **buffer,
|
|
guint64 *size, guint64* offset);
|
|
guint64 atom_svmi_copy_data (AtomSVMI *atom, guint8 **buffer,
|
|
guint64 *size, guint64* offset);
|
|
AtomSVMI * atom_svmi_new (guint8 stereoscopic_composition_type, gboolean is_left_first);
|
|
guint64 atom_stco64_copy_data (AtomSTCO64 *atom, guint8 **buffer,
|
|
guint64 *size, guint64* offset);
|
|
AtomMOOF* atom_moof_new (AtomsContext *context, guint32 sequence_number);
|
|
void atom_moof_free (AtomMOOF *moof);
|
|
guint64 atom_moof_copy_data (AtomMOOF *moof, guint8 **buffer, guint64 *size, guint64* offset);
|
|
void atom_moof_set_base_offset (AtomMOOF * moof, guint64 offset);
|
|
AtomTRAF * atom_traf_new (AtomsContext * context, guint32 track_ID);
|
|
void atom_traf_free (AtomTRAF * traf);
|
|
void atom_traf_set_base_decode_time (AtomTRAF * traf, guint64 base_decode_time);
|
|
void atom_traf_add_samples (AtomTRAF * traf, guint32 nsamples, guint32 delta,
|
|
guint32 size, gint32 data_offset, gboolean sync,
|
|
gint64 pts_offset, gboolean sdtp_sync);
|
|
guint32 atom_traf_get_sample_num (AtomTRAF * traf);
|
|
void atom_trun_set_offset (AtomTRUN * trun, gint32 offset);
|
|
void atom_moof_add_traf (AtomMOOF *moof, AtomTRAF *traf);
|
|
|
|
AtomMFRA* atom_mfra_new (AtomsContext *context);
|
|
void atom_mfra_free (AtomMFRA *mfra);
|
|
AtomTFRA* atom_tfra_new (AtomsContext *context, guint32 track_ID);
|
|
void atom_tfra_add_entry (AtomTFRA *tfra, guint64 dts, guint32 sample_num);
|
|
void atom_tfra_update_offset (AtomTFRA * tfra, guint64 offset);
|
|
void atom_mfra_add_tfra (AtomMFRA *mfra, AtomTFRA *tfra);
|
|
guint64 atom_mfra_copy_data (AtomMFRA *mfra, guint8 **buffer, guint64 *size, guint64* offset);
|
|
|
|
|
|
/* media sample description related helpers */
|
|
typedef struct
|
|
{
|
|
guint16 version;
|
|
guint32 fourcc;
|
|
guint width;
|
|
guint height;
|
|
guint depth;
|
|
guint frame_count;
|
|
gint color_table_id;
|
|
guint par_n;
|
|
guint par_d;
|
|
|
|
GstBuffer *codec_data;
|
|
} VisualSampleEntry;
|
|
|
|
typedef struct
|
|
{
|
|
guint32 fourcc;
|
|
guint version;
|
|
gint compression_id;
|
|
guint sample_rate;
|
|
guint channels;
|
|
guint sample_size;
|
|
guint bytes_per_packet;
|
|
guint samples_per_packet;
|
|
guint bytes_per_sample;
|
|
guint bytes_per_frame;
|
|
|
|
GstBuffer *codec_data;
|
|
} AudioSampleEntry;
|
|
|
|
typedef struct
|
|
{
|
|
guint32 fourcc;
|
|
|
|
guint8 font_face; /* bold=0x1, italic=0x2, underline=0x4 */
|
|
guint8 font_size;
|
|
guint32 foreground_color_rgba;
|
|
} SubtitleSampleEntry;
|
|
|
|
void subtitle_sample_entry_init (SubtitleSampleEntry * entry);
|
|
|
|
SampleTableEntryMP4A * atom_trak_set_audio_type (AtomTRAK * trak, AtomsContext * context,
|
|
AudioSampleEntry * entry, guint32 scale,
|
|
AtomInfo * ext, gint sample_size);
|
|
|
|
SampleTableEntryMP4V * atom_trak_set_video_type (AtomTRAK * trak, AtomsContext * context,
|
|
VisualSampleEntry * entry, guint32 rate,
|
|
GList * ext_atoms_list);
|
|
|
|
SampleTableEntryTX3G * atom_trak_set_subtitle_type (AtomTRAK * trak, AtomsContext * context,
|
|
SubtitleSampleEntry * entry);
|
|
|
|
SampleTableEntryTMCD *
|
|
atom_trak_set_timecode_type (AtomTRAK * trak, AtomsContext * context, guint trak_timescale, GstVideoTimeCode * tc);
|
|
|
|
SampleTableEntry * atom_trak_set_caption_type (AtomTRAK *trak, AtomsContext *context,
|
|
guint32 trak_timescale, guint32 caption_type);
|
|
|
|
void atom_trak_update_bitrates (AtomTRAK * trak, guint32 avg_bitrate,
|
|
guint32 max_bitrate);
|
|
|
|
void atom_trak_tx3g_update_dimension (AtomTRAK * trak, guint32 width,
|
|
guint32 height);
|
|
|
|
void sample_table_entry_add_ext_atom (SampleTableEntry * ste, AtomInfo * ext);
|
|
|
|
AtomInfo * build_codec_data_extension (guint32 fourcc, const GstBuffer * codec_data);
|
|
AtomInfo * build_mov_aac_extension (AtomTRAK * trak, const GstBuffer * codec_data,
|
|
guint32 avg_bitrate, guint32 max_bitrate);
|
|
AtomInfo * build_mov_alac_extension (const GstBuffer * codec_data);
|
|
AtomInfo * build_esds_extension (AtomTRAK * trak, guint8 object_type,
|
|
guint8 stream_type, const GstBuffer * codec_data,
|
|
guint32 avg_bitrate, guint32 max_bitrate);
|
|
AtomInfo * build_btrt_extension (guint32 buffer_size_db, guint32 avg_bitrate,
|
|
guint32 max_bitrate);
|
|
AtomInfo * build_jp2h_extension (gint width, gint height, const gchar *colorspace,
|
|
gint ncomp, const GValue * cmap_array,
|
|
const GValue * cdef_array);
|
|
|
|
AtomInfo * build_jp2x_extension (const GstBuffer * prefix);
|
|
AtomInfo * build_fiel_extension (GstVideoInterlaceMode mode, GstVideoFieldOrder order);
|
|
AtomInfo * build_colr_extension (const GstVideoColorimetry *colorimetry, gboolean is_mp4);
|
|
AtomInfo * build_clap_extension (gint width_n, gint width_d, gint height_n, gint height_d, gint h_off_n, gint h_off_d, gint v_off_n, gint v_off_d);
|
|
AtomInfo * build_tapt_extension (gint clef_width, gint clef_height, gint prof_width, gint prof_height, gint enof_width, gint enof_height);
|
|
|
|
|
|
AtomInfo * build_ac3_extension (guint8 fscod, guint8 bsid,
|
|
guint8 bsmod, guint8 acmod,
|
|
guint8 lfe_on, guint8 bitrate_code);
|
|
AtomInfo * build_opus_extension (guint32 rate, guint8 channels, guint8 mapping_family,
|
|
guint8 stream_count, guint8 coupled_count,
|
|
guint8 channel_mapping[256], guint16 pre_skip,
|
|
guint16 output_gain);
|
|
|
|
AtomInfo * build_amr_extension (void);
|
|
AtomInfo * build_h263_extension (void);
|
|
AtomInfo * build_gama_atom (gdouble gamma);
|
|
AtomInfo * build_SMI_atom (const GstBuffer *seqh);
|
|
AtomInfo * build_ima_adpcm_extension (gint channels, gint rate,
|
|
gint blocksize);
|
|
AtomInfo * build_uuid_xmp_atom (GstBuffer * xmp);
|
|
|
|
|
|
/*
|
|
* Meta tags functions
|
|
*/
|
|
void atom_udta_clear_tags (AtomUDTA *udta);
|
|
void atom_udta_add_str_tag (AtomUDTA *udta, guint32 fourcc, const gchar *value);
|
|
void atom_udta_add_uint_tag (AtomUDTA *udta, guint32 fourcc, guint32 flags,
|
|
guint32 value);
|
|
void atom_udta_add_tag (AtomUDTA *udta, guint32 fourcc, guint32 flags,
|
|
const guint8 * data, guint size);
|
|
void atom_udta_add_blob_tag (AtomUDTA *udta, guint8 *data, guint size);
|
|
|
|
void atom_udta_add_3gp_str_tag (AtomUDTA *udta, guint32 fourcc, const gchar * value);
|
|
void atom_udta_add_3gp_uint_tag (AtomUDTA *udta, guint32 fourcc, guint16 value);
|
|
void atom_udta_add_3gp_str_int_tag (AtomUDTA *udta, guint32 fourcc, const gchar * value,
|
|
gint16 ivalue);
|
|
void atom_udta_add_3gp_tag (AtomUDTA *udta, guint32 fourcc, guint8 * data,
|
|
guint size);
|
|
|
|
void atom_udta_add_xmp_tags (AtomUDTA *udta, GstBuffer * xmp);
|
|
|
|
AtomTREF * atom_tref_new (guint32 reftype);
|
|
void atom_tref_add_entry (AtomTREF * tref, guint32 sample);
|
|
|
|
#define GST_QT_MUX_DEFAULT_TAG_LANGUAGE "und" /* undefined/unknown */
|
|
guint16 language_code (const char * lang);
|
|
|
|
#endif /* __ATOMS_H__ */
|