2002-01-15 00:41:22 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GstData
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2004-03-25 04:20:33 +00:00
|
|
|
Abstract structure for information that is passed among elements
|
2002-01-15 00:41:22 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2002-07-12 23:21:20 +00:00
|
|
|
This abstract structure provides a common base for #GstBuffer, #GstBufferPool
|
|
|
|
and #GstEvent. It is the main data type that is passed along in a pipeline.
|
|
|
|
GstData provides refcounting, freeing and copying for its child classes.
|
2002-01-15 00:41:22 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
2002-07-12 23:21:20 +00:00
|
|
|
#GstBuffer, #GstBufferPool, #GstEvent
|
2002-01-15 00:41:22 +00:00
|
|
|
</para>
|
|
|
|
|
2002-07-12 23:21:20 +00:00
|
|
|
<!-- ##### MACRO GST_DATA ##### -->
|
|
|
|
<para>
|
|
|
|
Cast a pointer to a GstData
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The pointer to cast
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_DATA_TYPE ##### -->
|
|
|
|
<para>
|
|
|
|
Get the type of the GstData
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The data to get the type of
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_DATA_FLAGS ##### -->
|
|
|
|
<para>
|
|
|
|
Get the flags of this GstData
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The data to get the flags of
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_DATA_FLAG_SHIFT ##### -->
|
|
|
|
<para>
|
|
|
|
Shift a given flag so that it can be used in an or operation
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@flag: The flag to shift
|
|
|
|
|
|
|
|
|
2004-03-25 04:20:33 +00:00
|
|
|
<!-- ##### MACRO GST_DATA_FLAG_UNSET ##### -->
|
2002-07-12 23:21:20 +00:00
|
|
|
<para>
|
2004-03-25 04:20:33 +00:00
|
|
|
Unset the given flag
|
2002-07-12 23:21:20 +00:00
|
|
|
</para>
|
|
|
|
|
2004-03-25 04:20:33 +00:00
|
|
|
@data: The data to unset the flag of
|
|
|
|
@flag: The flag to unset
|
2002-07-12 23:21:20 +00:00
|
|
|
|
|
|
|
|
2004-03-25 04:20:33 +00:00
|
|
|
<!-- ##### MACRO GST_TYPE_DATA ##### -->
|
2002-07-12 23:21:20 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
2002-01-15 00:41:22 +00:00
|
|
|
<!-- ##### STRUCT GstData ##### -->
|
|
|
|
<para>
|
|
|
|
The base structure
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@type: The type of this data.
|
2002-07-12 23:21:20 +00:00
|
|
|
@refcount: A refcount
|
|
|
|
@flags: The flags of this GstData
|
|
|
|
@free: A pointer to a custom free function
|
|
|
|
@copy: A pointer to a custom copy function
|
2003-12-13 16:58:29 +00:00
|
|
|
@_gst_reserved:
|
2002-07-12 23:21:20 +00:00
|
|
|
|
|
|
|
<!-- ##### USER_FUNCTION GstDataFreeFunction ##### -->
|
|
|
|
<para>
|
|
|
|
The signature of the free function. Subclasses should provide a free function
|
|
|
|
with this signature and pass it in the gst_data_init() function.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The GstData to free
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### USER_FUNCTION GstDataCopyFunction ##### -->
|
|
|
|
<para>
|
|
|
|
The signature of the copy function. Subclasses should provide a copy function
|
|
|
|
with this signature and pass it in the gst_data_init() function.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The GstData to copy
|
|
|
|
@Returns: A new GstData that is a copy of data
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### ENUM GstDataFlags ##### -->
|
|
|
|
<para>
|
|
|
|
Various flags that can be set on a GstData
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@GST_DATA_READONLY: The data is readonly
|
|
|
|
@GST_DATA_FLAG_LAST: Subclasses can add additional flags starting from this offset
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_DATA_REFCOUNT ##### -->
|
|
|
|
<para>
|
|
|
|
Get access to the refcount field of the GstData
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The GstData to get the refcount field of
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_DATA_REFCOUNT_VALUE ##### -->
|
|
|
|
<para>
|
|
|
|
Get the current refcount value
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The GstData to query
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_DATA_COPY_FUNC ##### -->
|
|
|
|
<para>
|
|
|
|
Get access to the copy function of the data
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The data to query
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO GST_DATA_FREE_FUNC ##### -->
|
|
|
|
<para>
|
|
|
|
Get access to the free function of the data
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data: The data to query
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_data_init ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
@type:
|
2002-07-11 19:40:06 +00:00
|
|
|
@flags:
|
|
|
|
@free:
|
|
|
|
@copy:
|
2002-01-15 00:41:22 +00:00
|
|
|
|
2002-07-12 23:21:20 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_data_dispose ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_data_copy_into ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
@target:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_data_copy ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2004-03-25 04:20:33 +00:00
|
|
|
<!-- ##### FUNCTION gst_data_is_writable ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-07-12 23:21:20 +00:00
|
|
|
<!-- ##### FUNCTION gst_data_copy_on_write ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_data_ref ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_data_ref_by_count ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
@count:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gst_data_unref ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@data:
|
|
|
|
|
|
|
|
|