gstreamer/gst/matroska/ebml-write.h
Ronald S. Bultje 12e856c26d Riff, EBML, fourcc etc. work. Not fully finished, but better than what we used to have and definately worth a first b...
Original commit message from CVS:
Riff, EBML, fourcc etc. work. Not fully finished, but better than
what we used to have and definately worth a first broad testing.

I've revived rifflib. Rifflib used to be a bytestream-for-riff, which
just dup'ed bytestream. I've rewritten rifflib to be a modern riff-
chunk parser that uses bytestream fully, plus adds some extra functions
so that riff file parsing becomes extremely easy. It also contains some
small usability functions for strh/strf and metadata parsing. Note that
it doesn't use the new tagging yet, that's a TODO.

Avidemux has been rewritten to use this. I think we all agreed that
avidemux was pretty much a big mess, which is because it used all
sort of bytestream magic all around the place. It was just ugly.
This is a lot nicer, very complete and safe. I think this is far more
robust than what the old avidemux could ever have been. Of course, it
might contain bugs, please let me know.

EBML writing has also been implemented. This is useful for matroska.
I'm intending to modify avidemux (with a riffwriter) similarly. Maybe
I'll change wavparse/-enc too to use rifflib.

Lastly, several plugins have been modified to use rifflib's fourcc
parsing instead of their own. this puts fourcc parsing in one central
place, which should make it a lot simpler to add new fourccs. We might
want to move this to its own lib instead of rifflib.

Enjoy!
2003-12-07 20:00:41 +00:00

126 lines
3.9 KiB
C

/* GStreamer EBML I/O
* (c) 2003 Ronald Bultje <rbultje@ronald.bitfreak.net>
*
* ebml-write.c: write EBML data to file/stream
*
* 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.
*/
#ifndef __GST_EBML_WRITE_H__
#define __GST_EBML_WRITE_H__
#include <glib.h>
#include <gst/gst.h>
G_BEGIN_DECLS
#define GST_TYPE_EBML_WRITE \
(gst_ebml_write_get_type ())
#define GST_EBML_WRITE(obj) \
(G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_EBML_WRITE, GstEbmlWrite))
#define GST_EBML_WRITE_CLASS(klass) \
(G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_EBML_WRITE, GstEbmlWriteClass))
#define GST_IS_EBML_WRITE(obj) \
(G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_EBML_WRITE))
#define GST_IS_EBML_WRITE_CLASS(obj) \
(G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_EBML_WRITE))
#define GST_EBML_WRITE_GET_CLASS(obj) \
(G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_EBML_WRITE, GstEbmlWriteClass))
typedef struct _GstEbmlWrite {
GstElement parent;
GstPad *srcpad;
guint64 pos;
GstBuffer *cache;
guint handled;
} GstEbmlWrite;
typedef struct _GstEbmlWriteClass {
GstElementClass parent;
} GstEbmlWriteClass;
GType gst_ebml_write_get_type (void);
/*
* Caching means that we do not push one buffer for
* each element, but fill this one until a flush.
*/
void gst_ebml_write_set_cache (GstEbmlWrite *ebml,
guint size);
void gst_ebml_write_flush_cache (GstEbmlWrite *ebml);
/*
* Seeking.
*/
void gst_ebml_write_seek (GstEbmlWrite *ebml,
guint64 pos);
/*
* Data writing.
*/
void gst_ebml_write_uint (GstEbmlWrite *ebml,
guint32 id,
guint64 num);
void gst_ebml_write_sint (GstEbmlWrite *ebml,
guint32 id,
gint64 num);
void gst_ebml_write_float (GstEbmlWrite *ebml,
guint32 id,
gdouble num);
void gst_ebml_write_ascii (GstEbmlWrite *ebml,
guint32 id,
const gchar *str);
void gst_ebml_write_utf8 (GstEbmlWrite *ebml,
guint32 id,
const gchar *str);
void gst_ebml_write_date (GstEbmlWrite *ebml,
guint32 id,
gint64 date);
guint64 gst_ebml_write_master_start (GstEbmlWrite *ebml,
guint32 id);
void gst_ebml_write_master_finish (GstEbmlWrite *ebml,
guint64 startpos);
void gst_ebml_write_binary (GstEbmlWrite *ebml,
guint32 id,
guchar *binary,
guint64 length);
void gst_ebml_write_header (GstEbmlWrite *ebml,
gchar *doctype,
guint version);
/*
* Note: this is supposed to be used only for media data.
*/
void gst_ebml_write_buffer_header (GstEbmlWrite *ebml,
guint32 id,
guint64 length);
void gst_ebml_write_buffer (GstEbmlWrite *ebml,
GstBuffer *data);
/*
* A hack, basically... See matroska-mux.c. I should actually
* make a nice _replace_element_with_size() or so, but this
* works for now.
*/
void gst_ebml_replace_uint (GstEbmlWrite *ebml,
guint64 pos,
guint64 num);
G_END_DECLS
#endif /* __GST_EBML_WRITE_H__ */