gstreamer/gst/gstmeta.c
Wim Taymans 9bae9d4b91 More Docs updates.
Original commit message from CVS:
More Docs updates.
Added plugin documentation. I fear we need a gstdoc implementation
that loads plugins and does introspection on them. I think we should
automatically create the docs for the pads and mime types the plugins
provide. Does anyone have enough perl knowledge to add these features? I
allready changed the C code to output the pad definitions but my perl
knowledge is too limited, for now, to implement the rest of the needed
functionality...
2000-10-25 19:09:53 +00:00

89 lines
2.1 KiB
C

/* Gnome-Streamer
* Copyright (C) <1999> Erik Walthinsen <omega@cse.ogi.edu>
*
* 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.
*/
#include <gst/gstmeta.h>
#include <gst/gsttrace.h>
/**
* gst_meta_new_size:
* @size: the size of the new meta data
*
* Create a new metadata object with a given size
*
* Returns: new meta object
*/
GstMeta *gst_meta_new_size(gint size) {
GstMeta *meta;
meta = g_malloc0(size);
gst_meta_ref(meta);
return meta;
}
/**
* gst_meta_ref:
* @meta: the meta object to ref
*
* increases the refcount of a meta object
*/
void gst_meta_ref(GstMeta *meta) {
g_return_if_fail(meta != NULL);
gst_trace_add_entry(NULL,0,meta,"ref meta");
meta->refcount++;
}
/**
* gst_meta_unref:
* @meta: the meta object to unref
*
* decreases the refcount of a meta object. if the refcount is zero, the
* meta object is freed.
*/
void gst_meta_unref(GstMeta *meta) {
g_return_if_fail(meta != NULL);
gst_trace_add_entry(NULL,0,meta,"unref meta");
meta->refcount--;
if (meta->refcount == 0) {
// gst_trace_add_entry(NULL,0,meta,"destroy meta");
g_free(meta);
// g_print("freeing metadata\n");
}
}
/**
* gst_meta_cow:
* @meta: the meta object prepare for write
*
* prepares a meta object for writing. A copy of the meta
* object is returned if needed.
*
* Returns: the meta object or a copy.
*/
GstMeta *gst_meta_cow(GstMeta *meta) {
g_return_val_if_fail(meta != NULL, NULL);
return NULL;
}