--- a/gst_plugins_good/gst/qtmux/atoms.h Tue Aug 31 15:30:33 2010 +0300
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,671 +0,0 @@
-/* Quicktime muxer plugin for GStreamer
- * Copyright (C) 2008 Thiago Sousa 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., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, 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 "descriptors.h"
-#include "properties.h"
-#include "fourcc.h"
-#include "ftypcc.h"
-
-/* 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
-} AtomsTreeFlavor;
-
-typedef struct _AtomsContext
-{
- AtomsTreeFlavor flavor;
-} AtomsContext;
-
-AtomsContext* atoms_context_new (AtomsTreeFlavor flavor);
-void atoms_context_free (AtomsContext *context);
-
-#define METADATA_DATA_FLAG 0x0
-#define METADATA_TEXT_FLAG 0x1
-
-/* atom defs and functions */
-
-/**
- * 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 _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;
-} 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 _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;
-
- guint n_entries;
- /* list of STTSEntry */
- GList *entries;
-} AtomSTTS;
-
-typedef struct _AtomSTSS
-{
- AtomFull header;
-
- guint n_entries;
- /* list of sample indexes (guint32) */
- GList *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
-} SampleEntryKind;
-
-typedef struct _SampleTableEntry
-{
- Atom header;
-
- guint8 reserved[6];
- guint16 data_reference_index;
-
- /* sort 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 _SampleTableEntryMP4S
-{
- SampleTableEntry se;
-
- AtomESDS es;
-} SampleTableEntryMP4S;
-
-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;
- /* list of guint32 */
- GList *entries;
-} AtomSTSZ;
-
-typedef struct _STSCEntry
-{
- guint32 first_chunk;
- guint32 samples_per_chunk;
- guint32 sample_description_index;
-} STSCEntry;
-
-typedef struct _AtomSTSC
-{
- AtomFull header;
-
- guint n_entries;
- /* list of STSCEntry */
- GList *entries;
-} AtomSTSC;
-
-
-/*
- * used for both STCO and CO64
- * if used as STCO, entries should be truncated to use only 32bits
- */
-typedef struct _AtomSTCO64
-{
- AtomFull header;
-
- guint n_entries;
- /* list of guint64 */
- GList *entries;
-} AtomSTCO64;
-
-typedef struct _CTTSEntry
-{
- guint32 samplecount;
- guint32 sampleoffset;
-} CTTSEntry;
-
-typedef struct _AtomCTTS
-{
- AtomFull header;
-
- /* also entry count here */
- guint n_entries;
- GList *entries;
-} AtomCTTS;
-
-typedef struct _AtomSTBL
-{
- Atom header;
-
- AtomSTSD stsd;
- AtomSTTS stts;
- AtomSTSS stss;
- AtomSTSC stsc;
- AtomSTSZ stsz;
- /* NULL if not present */
- AtomCTTS *ctts;
-
- AtomSTCO64 stco64;
-} AtomSTBL;
-
-typedef struct _AtomMINF
-{
- Atom header;
-
- /* only (exactly) one of those must be present */
- AtomVMHD *vmhd;
- AtomSMHD *smhd;
- AtomHMHD *hmhd;
-
- AtomHDLR *hdlr;
- AtomDINF dinf;
- AtomSTBL stbl;
-} AtomMINF;
-
-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;
-} AtomUDTA;
-
-typedef struct _AtomTRAK
-{
- Atom header;
-
- AtomTKHD tkhd;
- AtomMDIA mdia;
-
- /* some helper info for structural conformity checks */
- gboolean is_video;
- gboolean is_h264;
-} AtomTRAK;
-
-typedef struct _AtomMOOV
-{
- /* style */
- AtomsContext context;
-
- Atom header;
-
- AtomMVHD mvhd;
-
- /* list of AtomTRAK */
- GList *traks;
- AtomUDTA *udta;
-} AtomMOOV;
-
-typedef struct _AtomWAVE
-{
- Atom header;
-
- /* list of AtomInfo */
- GList *extension_atoms;
-} AtomWAVE;
-
-
-/*
- * 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).
- */
-typedef struct _AtomInfo
-{
- Atom *atom;
- AtomCopyDataFunc copy_data_func;
- AtomFreeFunc free_func;
-} AtomInfo;
-
-
-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,
- gboolean do_pts, gint64 pts_offset);
-guint32 atom_trak_get_timescale (AtomTRAK *trak);
-
-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_64bits (AtomMOOV *moov, gboolean large_file);
-void atom_moov_chunks_add_offset (AtomMOOV *moov, guint32 offset);
-void atom_moov_add_trak (AtomMOOV *moov, AtomTRAK *trak);
-
-/* media sample description related helpers */
-
-typedef struct
-{
- 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;
-
-void atom_trak_set_audio_type (AtomTRAK * trak, AtomsContext * context,
- AudioSampleEntry * entry, guint32 scale,
- AtomInfo * ext, gint sample_size);
-void atom_trak_set_video_type (AtomTRAK * trak, AtomsContext * context,
- VisualSampleEntry * entry, guint32 rate,
- AtomInfo * ext);
-
-AtomInfo * build_codec_data_extension (guint32 fourcc, const GstBuffer * codec_data);
-AtomInfo * build_mov_aac_extension (AtomTRAK * trak, const GstBuffer * codec_data);
-AtomInfo * build_esds_extension (AtomTRAK * trak, guint8 object_type,
- guint8 stream_type, const GstBuffer * codec_data);
-AtomInfo * build_jp2h_extension (AtomTRAK * trak, gint width, gint height,
- guint32 fourcc);
-AtomInfo * build_amr_extension ();
-AtomInfo * build_h263_extension ();
-
-
-/*
- * Meta tags functions
- */
-void atom_moov_add_str_tag (AtomMOOV *moov, guint32 fourcc, const gchar *value);
-void atom_moov_add_uint_tag (AtomMOOV *moov, guint32 fourcc, guint32 flags,
- guint32 value);
-void atom_moov_add_tag (AtomMOOV *moov, guint32 fourcc, guint32 flags,
- const guint8 * data, guint size);
-void atom_moov_add_blob_tag (AtomMOOV *moov, guint8 *data, guint size);
-
-void atom_moov_add_3gp_str_tag (AtomMOOV * moov, guint32 fourcc, const gchar * value);
-void atom_moov_add_3gp_uint_tag (AtomMOOV * moov, guint32 fourcc, guint16 value);
-void atom_moov_add_3gp_str_int_tag (AtomMOOV * moov, guint32 fourcc, const gchar * value,
- gint16 ivalue);
-void atom_moov_add_3gp_tag (AtomMOOV * moov, guint32 fourcc, guint8 * data,
- guint size);
-
-#define GST_QT_MUX_DEFAULT_TAG_LANGUAGE "eng"
-guint16 language_code (const char * lang);
-
-#endif /* __ATOMS_H__ */