forked from mirrors/gstreamer-rs
13625 lines
610 KiB
XML
13625 lines
610 KiB
XML
<?xml version="1.0"?>
|
|
<!-- This file was automatically generated from C sources - DO NOT EDIT!
|
|
To affect the contents of this file, edit the original C definitions,
|
|
and/or use gtk-doc annotations. -->
|
|
<repository xmlns="http://www.gtk.org/introspection/core/1.0" xmlns:c="http://www.gtk.org/introspection/c/1.0" xmlns:glib="http://www.gtk.org/introspection/glib/1.0" version="1.2">
|
|
<include name="GLib" version="2.0"/>
|
|
<include name="GModule" version="2.0"/>
|
|
<include name="GObject" version="2.0"/>
|
|
<include name="Gst" version="1.0"/>
|
|
<package name="gstreamer-base-1.0"/>
|
|
<c:include name="gst/base/base.h"/>
|
|
<namespace name="GstBase" version="1.0" shared-library="libgstbase-1.0.so.0" c:identifier-prefixes="Gst" c:symbol-prefixes="gst">
|
|
<function-macro name="ADAPTER" c:identifier="GST_ADAPTER" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ADAPTER_CLASS" c:identifier="GST_ADAPTER_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ADAPTER_GET_CLASS" c:identifier="GST_ADAPTER_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR" c:identifier="GST_AGGREGATOR" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR_CAST" c:identifier="GST_AGGREGATOR_CAST" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR_CLASS" c:identifier="GST_AGGREGATOR_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR_GET_CLASS" c:identifier="GST_AGGREGATOR_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR_PAD" c:identifier="GST_AGGREGATOR_PAD" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR_PAD_CAST" c:identifier="GST_AGGREGATOR_PAD_CAST" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR_PAD_CLASS" c:identifier="GST_AGGREGATOR_PAD_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR_PAD_GET_CLASS" c:identifier="GST_AGGREGATOR_PAD_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="AGGREGATOR_SRC_PAD" c:identifier="GST_AGGREGATOR_SRC_PAD" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Convenience macro to access the source pad of #GstAggregator</doc>
|
|
|
|
<parameters>
|
|
<parameter name="agg">
|
|
<doc xml:space="preserve">a #GstAggregator</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="Adapter" c:symbol-prefix="adapter" c:type="GstAdapter" parent="GObject.Object" glib:type-name="GstAdapter" glib:get-type="gst_adapter_get_type" glib:type-struct="AdapterClass">
|
|
<doc xml:space="preserve">This class is for elements that receive buffers in an undesired size.
|
|
While for example raw video contains one image per buffer, the same is not
|
|
true for a lot of other formats, especially those that come directly from
|
|
a file. So if you have undefined buffer sizes and require a specific size,
|
|
this object is for you.
|
|
|
|
An adapter is created with gst_adapter_new(). It can be freed again with
|
|
g_object_unref().
|
|
|
|
The theory of operation is like this: All buffers received are put
|
|
into the adapter using gst_adapter_push() and the data is then read back
|
|
in chunks of the desired size using gst_adapter_map()/gst_adapter_unmap()
|
|
and/or gst_adapter_copy(). After the data has been processed, it is freed
|
|
using gst_adapter_unmap().
|
|
|
|
Other methods such as gst_adapter_take() and gst_adapter_take_buffer()
|
|
combine gst_adapter_map() and gst_adapter_unmap() in one method and are
|
|
potentially more convenient for some use cases.
|
|
|
|
For example, a sink pad's chain function that needs to pass data to a library
|
|
in 512-byte chunks could be implemented like this:
|
|
|[<!-- language="C" -->
|
|
static GstFlowReturn
|
|
sink_pad_chain (GstPad *pad, GstObject *parent, GstBuffer *buffer)
|
|
{
|
|
MyElement *this;
|
|
GstAdapter *adapter;
|
|
GstFlowReturn ret = GST_FLOW_OK;
|
|
|
|
this = MY_ELEMENT (parent);
|
|
|
|
adapter = this->adapter;
|
|
|
|
// put buffer into adapter
|
|
gst_adapter_push (adapter, buffer);
|
|
|
|
// while we can read out 512 bytes, process them
|
|
while (gst_adapter_available (adapter) >= 512 && ret == GST_FLOW_OK) {
|
|
const guint8 *data = gst_adapter_map (adapter, 512);
|
|
// use flowreturn as an error value
|
|
ret = my_library_foo (data);
|
|
gst_adapter_unmap (adapter);
|
|
gst_adapter_flush (adapter, 512);
|
|
}
|
|
return ret;
|
|
}
|
|
]|
|
|
|
|
For another example, a simple element inside GStreamer that uses #GstAdapter
|
|
is the libvisual element.
|
|
|
|
An element using #GstAdapter in its sink pad chain function should ensure that
|
|
when the FLUSH_STOP event is received, that any queued data is cleared using
|
|
gst_adapter_clear(). Data should also be cleared or processed on EOS and
|
|
when changing state from %GST_STATE_PAUSED to %GST_STATE_READY.
|
|
|
|
Also check the GST_BUFFER_FLAG_DISCONT flag on the buffer. Some elements might
|
|
need to clear the adapter after a discontinuity.
|
|
|
|
The adapter will keep track of the timestamps of the buffers
|
|
that were pushed. The last seen timestamp before the current position
|
|
can be queried with gst_adapter_prev_pts(). This function can
|
|
optionally return the number of bytes between the start of the buffer that
|
|
carried the timestamp and the current adapter position. The distance is
|
|
useful when dealing with, for example, raw audio samples because it allows
|
|
you to calculate the timestamp of the current adapter position by using the
|
|
last seen timestamp and the amount of bytes since. Additionally, the
|
|
gst_adapter_prev_pts_at_offset() can be used to determine the last
|
|
seen timestamp at a particular offset in the adapter.
|
|
|
|
The adapter will also keep track of the offset of the buffers
|
|
(#GST_BUFFER_OFFSET) that were pushed. The last seen offset before the
|
|
current position can be queried with gst_adapter_prev_offset(). This function
|
|
can optionally return the number of bytes between the start of the buffer
|
|
that carried the offset and the current adapter position.
|
|
|
|
Additionally the adapter also keeps track of the PTS, DTS and buffer offset
|
|
at the last discontinuity, which can be retrieved with
|
|
gst_adapter_pts_at_discont(), gst_adapter_dts_at_discont() and
|
|
gst_adapter_offset_at_discont(). The number of bytes that were consumed
|
|
since then can be queried with gst_adapter_distance_from_discont().
|
|
|
|
A last thing to note is that while #GstAdapter is pretty optimized,
|
|
merging buffers still might be an operation that requires a `malloc()` and
|
|
`memcpy()` operation, and these operations are not the fastest. Because of
|
|
this, some functions like gst_adapter_available_fast() are provided to help
|
|
speed up such cases should you want to. To avoid repeated memory allocations,
|
|
gst_adapter_copy() can be used to copy data into a (statically allocated)
|
|
user provided buffer.
|
|
|
|
#GstAdapter is not MT safe. All operations on an adapter must be serialized by
|
|
the caller. This is not normally a problem, however, as the normal use case
|
|
of #GstAdapter is inside one pad's chain function, in which case access is
|
|
serialized via the pad's STREAM_LOCK.
|
|
|
|
Note that gst_adapter_push() takes ownership of the buffer passed. Use
|
|
gst_buffer_ref() before pushing it into the adapter if you still want to
|
|
access the buffer later. The adapter will never modify the data in the
|
|
buffer pushed in it.</doc>
|
|
|
|
<constructor name="new" c:identifier="gst_adapter_new">
|
|
<doc xml:space="preserve">Creates a new #GstAdapter. Free with g_object_unref().</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="available" c:identifier="gst_adapter_available">
|
|
<doc xml:space="preserve">Gets the maximum amount of bytes available, that is it returns the maximum
|
|
value that can be supplied to gst_adapter_map() without that function
|
|
returning %NULL.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bytes available in @adapter</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="available_fast" c:identifier="gst_adapter_available_fast">
|
|
<doc xml:space="preserve">Gets the maximum number of bytes that are immediately available without
|
|
requiring any expensive operations (like copying the data into a
|
|
temporary buffer).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bytes that are available in @adapter without expensive
|
|
operations</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="clear" c:identifier="gst_adapter_clear">
|
|
<doc xml:space="preserve">Removes all buffers from @adapter.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="copy" c:identifier="gst_adapter_copy" shadowed-by="copy_bytes" introspectable="0">
|
|
<doc xml:space="preserve">Copies @size bytes of data starting at @offset out of the buffers
|
|
contained in #GstAdapter into an array @dest provided by the caller.
|
|
|
|
The array @dest should be large enough to contain @size bytes.
|
|
The user should check that the adapter has (@offset + @size) bytes
|
|
available before calling this function.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="dest" direction="out" caller-allocates="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">
|
|
the memory to copy into</doc>
|
|
<array length="2" zero-terminated="0" c:type="gpointer">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">the bytes offset in the adapter to start from</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">the number of bytes to copy</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="copy_bytes" c:identifier="gst_adapter_copy_bytes" shadows="copy" version="1.4">
|
|
<doc xml:space="preserve">Similar to gst_adapter_copy, but more suitable for language bindings. @size
|
|
bytes of data starting at @offset will be copied out of the buffers contained
|
|
in @adapter and into a new #GBytes structure which is returned. Depending on
|
|
the value of the @size argument an empty #GBytes structure may be returned.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">A new #GBytes structure containing the copied data.</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">the bytes offset in the adapter to start from</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to copy</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="distance_from_discont" c:identifier="gst_adapter_distance_from_discont">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="dts_at_discont" c:identifier="gst_adapter_dts_at_discont" version="1.10">
|
|
<doc xml:space="preserve">Get the DTS that was on the last buffer with the GST_BUFFER_FLAG_DISCONT
|
|
flag, or GST_CLOCK_TIME_NONE.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The DTS at the last discont or GST_CLOCK_TIME_NONE.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush" c:identifier="gst_adapter_flush">
|
|
<doc xml:space="preserve">Flushes the first @flush bytes in the @adapter. The caller must ensure that
|
|
at least this many bytes are available.
|
|
|
|
See also: gst_adapter_map(), gst_adapter_unmap()</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="flush" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to flush</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_buffer" c:identifier="gst_adapter_get_buffer" version="1.6">
|
|
<doc xml:space="preserve">Returns a #GstBuffer containing the first @nbytes of the @adapter, but
|
|
does not flush them from the adapter. See gst_adapter_take_buffer()
|
|
for details.
|
|
|
|
Caller owns a reference to the returned buffer. gst_buffer_unref() after
|
|
usage.
|
|
|
|
Free-function: gst_buffer_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GstBuffer containing the first
|
|
@nbytes of the adapter, or %NULL if @nbytes bytes are not available.
|
|
gst_buffer_unref() when no longer needed.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to get</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_buffer_fast" c:identifier="gst_adapter_get_buffer_fast" version="1.6">
|
|
<doc xml:space="preserve">Returns a #GstBuffer containing the first @nbytes of the @adapter, but
|
|
does not flush them from the adapter. See gst_adapter_take_buffer_fast()
|
|
for details.
|
|
|
|
Caller owns a reference to the returned buffer. gst_buffer_unref() after
|
|
usage.
|
|
|
|
Free-function: gst_buffer_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GstBuffer containing the first
|
|
@nbytes of the adapter, or %NULL if @nbytes bytes are not available.
|
|
gst_buffer_unref() when no longer needed.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to get</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_buffer_list" c:identifier="gst_adapter_get_buffer_list" version="1.6">
|
|
<doc xml:space="preserve">Returns a #GstBufferList of buffers containing the first @nbytes bytes of
|
|
the @adapter but does not flush them from the adapter. See
|
|
gst_adapter_take_buffer_list() for details.
|
|
|
|
Caller owns the returned list. Call gst_buffer_list_unref() to free
|
|
the list after usage.</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GstBufferList of buffers containing
|
|
the first @nbytes of the adapter, or %NULL if @nbytes bytes are not
|
|
available</doc>
|
|
<type name="Gst.BufferList" c:type="GstBufferList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to get</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_list" c:identifier="gst_adapter_get_list" version="1.6">
|
|
<doc xml:space="preserve">Returns a #GList of buffers containing the first @nbytes bytes of the
|
|
@adapter, but does not flush them from the adapter. See
|
|
gst_adapter_take_list() for details.
|
|
|
|
Caller owns returned list and contained buffers. gst_buffer_unref() each
|
|
buffer in the list before freeing the list after usage.</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GList of
|
|
buffers containing the first @nbytes of the adapter, or %NULL if @nbytes
|
|
bytes are not available</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Gst.Buffer"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to get</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="map" c:identifier="gst_adapter_map">
|
|
<doc xml:space="preserve">Gets the first @size bytes stored in the @adapter. The returned pointer is
|
|
valid until the next function is called on the adapter.
|
|
|
|
Note that setting the returned pointer as the data of a #GstBuffer is
|
|
incorrect for general-purpose plugins. The reason is that if a downstream
|
|
element stores the buffer so that it has access to it outside of the bounds
|
|
of its chain function, the buffer will have an invalid data pointer after
|
|
your element flushes the bytes. In that case you should use
|
|
gst_adapter_take(), which returns a freshly-allocated buffer that you can set
|
|
as #GstBuffer memory or the potentially more performant
|
|
gst_adapter_take_buffer().
|
|
|
|
Returns %NULL if @size bytes are not available.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">
|
|
a pointer to the first @size bytes of data, or %NULL</doc>
|
|
<array length="0" zero-terminated="0" c:type="gconstpointer">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">the number of bytes to map/peek</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="masked_scan_uint32" c:identifier="gst_adapter_masked_scan_uint32">
|
|
<doc xml:space="preserve">Scan for pattern @pattern with applied mask @mask in the adapter data,
|
|
starting from offset @offset.
|
|
|
|
The bytes in @pattern and @mask are interpreted left-to-right, regardless
|
|
of endianness. All four bytes of the pattern must be present in the
|
|
adapter for it to match, even if the first or last bytes are masked out.
|
|
|
|
It is an error to call this function without making sure that there is
|
|
enough data (offset+size bytes) in the adapter.
|
|
|
|
This function calls gst_adapter_masked_scan_uint32_peek() passing %NULL
|
|
for value.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">offset of the first match, or -1 if no match was found.
|
|
|
|
Example:
|
|
|[
|
|
// Assume the adapter contains 0x00 0x01 0x02 ... 0xfe 0xff
|
|
|
|
gst_adapter_masked_scan_uint32 (adapter, 0xffffffff, 0x00010203, 0, 256);
|
|
// -> returns 0
|
|
gst_adapter_masked_scan_uint32 (adapter, 0xffffffff, 0x00010203, 1, 255);
|
|
// -> returns -1
|
|
gst_adapter_masked_scan_uint32 (adapter, 0xffffffff, 0x01020304, 1, 255);
|
|
// -> returns 1
|
|
gst_adapter_masked_scan_uint32 (adapter, 0xffff, 0x0001, 0, 256);
|
|
// -> returns -1
|
|
gst_adapter_masked_scan_uint32 (adapter, 0xffff, 0x0203, 0, 256);
|
|
// -> returns 0
|
|
gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 256);
|
|
// -> returns 2
|
|
gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4);
|
|
// -> returns -1
|
|
]|</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve">mask to apply to data before matching against @pattern</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="pattern" transfer-ownership="none">
|
|
<doc xml:space="preserve">pattern to match (after mask is applied)</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">offset into the adapter data from which to start scanning, returns
|
|
the last scanned position.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bytes to scan from offset</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="masked_scan_uint32_peek" c:identifier="gst_adapter_masked_scan_uint32_peek">
|
|
<doc xml:space="preserve">Scan for pattern @pattern with applied mask @mask in the adapter data,
|
|
starting from offset @offset. If a match is found, the value that matched
|
|
is returned through @value, otherwise @value is left untouched.
|
|
|
|
The bytes in @pattern and @mask are interpreted left-to-right, regardless
|
|
of endianness. All four bytes of the pattern must be present in the
|
|
adapter for it to match, even if the first or last bytes are masked out.
|
|
|
|
It is an error to call this function without making sure that there is
|
|
enough data (offset+size bytes) in the adapter.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">offset of the first match, or -1 if no match was found.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve">mask to apply to data before matching against @pattern</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="pattern" transfer-ownership="none">
|
|
<doc xml:space="preserve">pattern to match (after mask is applied)</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">offset into the adapter data from which to start scanning, returns
|
|
the last scanned position.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bytes to scan from offset</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">pointer to uint32 to return matching data</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="offset_at_discont" c:identifier="gst_adapter_offset_at_discont" version="1.10">
|
|
<doc xml:space="preserve">Get the offset that was on the last buffer with the GST_BUFFER_FLAG_DISCONT
|
|
flag, or GST_BUFFER_OFFSET_NONE.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The offset at the last discont or GST_BUFFER_OFFSET_NONE.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prev_dts" c:identifier="gst_adapter_prev_dts">
|
|
<doc xml:space="preserve">Get the dts that was before the current byte in the adapter. When
|
|
@distance is given, the amount of bytes between the dts and the current
|
|
position is returned.
|
|
|
|
The dts is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when
|
|
the adapter is first created or when it is cleared. This also means that before
|
|
the first byte with a dts is removed from the adapter, the dts
|
|
and distance returned are GST_CLOCK_TIME_NONE and 0 respectively.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The previously seen dts.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="distance" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">pointer to location for distance, or %NULL</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prev_dts_at_offset" c:identifier="gst_adapter_prev_dts_at_offset" version="1.2">
|
|
<doc xml:space="preserve">Get the dts that was before the byte at offset @offset in the adapter. When
|
|
@distance is given, the amount of bytes between the dts and the current
|
|
position is returned.
|
|
|
|
The dts is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when
|
|
the adapter is first created or when it is cleared. This also means that before
|
|
the first byte with a dts is removed from the adapter, the dts
|
|
and distance returned are GST_CLOCK_TIME_NONE and 0 respectively.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The previously seen dts at given offset.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">the offset in the adapter at which to get timestamp</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="distance" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">pointer to location for distance, or %NULL</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prev_offset" c:identifier="gst_adapter_prev_offset" version="1.10">
|
|
<doc xml:space="preserve">Get the offset that was before the current byte in the adapter. When
|
|
@distance is given, the amount of bytes between the offset and the current
|
|
position is returned.
|
|
|
|
The offset is reset to GST_BUFFER_OFFSET_NONE and the distance is set to 0
|
|
when the adapter is first created or when it is cleared. This also means that
|
|
before the first byte with an offset is removed from the adapter, the offset
|
|
and distance returned are GST_BUFFER_OFFSET_NONE and 0 respectively.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The previous seen offset.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="distance" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">pointer to a location for distance, or %NULL</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prev_pts" c:identifier="gst_adapter_prev_pts">
|
|
<doc xml:space="preserve">Get the pts that was before the current byte in the adapter. When
|
|
@distance is given, the amount of bytes between the pts and the current
|
|
position is returned.
|
|
|
|
The pts is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when
|
|
the adapter is first created or when it is cleared. This also means that before
|
|
the first byte with a pts is removed from the adapter, the pts
|
|
and distance returned are GST_CLOCK_TIME_NONE and 0 respectively.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The previously seen pts.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="distance" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">pointer to location for distance, or %NULL</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prev_pts_at_offset" c:identifier="gst_adapter_prev_pts_at_offset" version="1.2">
|
|
<doc xml:space="preserve">Get the pts that was before the byte at offset @offset in the adapter. When
|
|
@distance is given, the amount of bytes between the pts and the current
|
|
position is returned.
|
|
|
|
The pts is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when
|
|
the adapter is first created or when it is cleared. This also means that before
|
|
the first byte with a pts is removed from the adapter, the pts
|
|
and distance returned are GST_CLOCK_TIME_NONE and 0 respectively.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The previously seen pts at given offset.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">the offset in the adapter at which to get timestamp</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="distance" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">pointer to location for distance, or %NULL</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pts_at_discont" c:identifier="gst_adapter_pts_at_discont" version="1.10">
|
|
<doc xml:space="preserve">Get the PTS that was on the last buffer with the GST_BUFFER_FLAG_DISCONT
|
|
flag, or GST_CLOCK_TIME_NONE.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The PTS at the last discont or GST_CLOCK_TIME_NONE.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="push" c:identifier="gst_adapter_push">
|
|
<doc xml:space="preserve">Adds the data from @buf to the data stored inside @adapter and takes
|
|
ownership of the buffer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="buf" transfer-ownership="full">
|
|
<doc xml:space="preserve">a #GstBuffer to add to queue in the adapter</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take" c:identifier="gst_adapter_take">
|
|
<doc xml:space="preserve">Returns a freshly allocated buffer containing the first @nbytes bytes of the
|
|
@adapter. The returned bytes will be flushed from the adapter.
|
|
|
|
Caller owns returned value. g_free after usage.
|
|
|
|
Free-function: g_free</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">
|
|
oven-fresh hot data, or %NULL if @nbytes bytes are not available</doc>
|
|
<array length="0" zero-terminated="0" c:type="gpointer">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">the number of bytes to take</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_buffer" c:identifier="gst_adapter_take_buffer">
|
|
<doc xml:space="preserve">Returns a #GstBuffer containing the first @nbytes bytes of the
|
|
@adapter. The returned bytes will be flushed from the adapter.
|
|
This function is potentially more performant than
|
|
gst_adapter_take() since it can reuse the memory in pushed buffers
|
|
by subbuffering or merging. This function will always return a
|
|
buffer with a single memory region.
|
|
|
|
Note that no assumptions should be made as to whether certain buffer
|
|
flags such as the DISCONT flag are set on the returned buffer, or not.
|
|
The caller needs to explicitly set or unset flags that should be set or
|
|
unset.
|
|
|
|
Since 1.6 this will also copy over all GstMeta of the input buffers except
|
|
for meta with the %GST_META_FLAG_POOLED flag or with the "memory" tag.
|
|
|
|
Caller owns a reference to the returned buffer. gst_buffer_unref() after
|
|
usage.
|
|
|
|
Free-function: gst_buffer_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GstBuffer containing the first
|
|
@nbytes of the adapter, or %NULL if @nbytes bytes are not available.
|
|
gst_buffer_unref() when no longer needed.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to take</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_buffer_fast" c:identifier="gst_adapter_take_buffer_fast" version="1.2">
|
|
<doc xml:space="preserve">Returns a #GstBuffer containing the first @nbytes of the @adapter.
|
|
The returned bytes will be flushed from the adapter. This function
|
|
is potentially more performant than gst_adapter_take_buffer() since
|
|
it can reuse the memory in pushed buffers by subbuffering or
|
|
merging. Unlike gst_adapter_take_buffer(), the returned buffer may
|
|
be composed of multiple non-contiguous #GstMemory objects, no
|
|
copies are made.
|
|
|
|
Note that no assumptions should be made as to whether certain buffer
|
|
flags such as the DISCONT flag are set on the returned buffer, or not.
|
|
The caller needs to explicitly set or unset flags that should be set or
|
|
unset.
|
|
|
|
This will also copy over all GstMeta of the input buffers except
|
|
for meta with the %GST_META_FLAG_POOLED flag or with the "memory" tag.
|
|
|
|
This function can return buffer up to the return value of
|
|
gst_adapter_available() without making copies if possible.
|
|
|
|
Caller owns a reference to the returned buffer. gst_buffer_unref() after
|
|
usage.
|
|
|
|
Free-function: gst_buffer_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GstBuffer containing the first
|
|
@nbytes of the adapter, or %NULL if @nbytes bytes are not available.
|
|
gst_buffer_unref() when no longer needed.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to take</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_buffer_list" c:identifier="gst_adapter_take_buffer_list" version="1.6">
|
|
<doc xml:space="preserve">Returns a #GstBufferList of buffers containing the first @nbytes bytes of
|
|
the @adapter. The returned bytes will be flushed from the adapter.
|
|
When the caller can deal with individual buffers, this function is more
|
|
performant because no memory should be copied.
|
|
|
|
Caller owns the returned list. Call gst_buffer_list_unref() to free
|
|
the list after usage.</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GstBufferList of buffers containing
|
|
the first @nbytes of the adapter, or %NULL if @nbytes bytes are not
|
|
available</doc>
|
|
<type name="Gst.BufferList" c:type="GstBufferList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to take</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_list" c:identifier="gst_adapter_take_list">
|
|
<doc xml:space="preserve">Returns a #GList of buffers containing the first @nbytes bytes of the
|
|
@adapter. The returned bytes will be flushed from the adapter.
|
|
When the caller can deal with individual buffers, this function is more
|
|
performant because no memory should be copied.
|
|
|
|
Caller owns returned list and contained buffers. gst_buffer_unref() each
|
|
buffer in the list before freeing the list after usage.</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GList of
|
|
buffers containing the first @nbytes of the adapter, or %NULL if @nbytes
|
|
bytes are not available</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Gst.Buffer"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to take</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmap" c:identifier="gst_adapter_unmap">
|
|
<doc xml:space="preserve">Releases the memory obtained with the last gst_adapter_map().</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="adapter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAdapter</doc>
|
|
<type name="Adapter" c:type="GstAdapter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<record name="AdapterClass" c:type="GstAdapterClass" disguised="1" glib:is-gtype-struct-for="Adapter">
|
|
|
|
</record>
|
|
<class name="Aggregator" c:symbol-prefix="aggregator" c:type="GstAggregator" version="1.14" parent="Gst.Element" abstract="1" glib:type-name="GstAggregator" glib:get-type="gst_aggregator_get_type" glib:type-struct="AggregatorClass">
|
|
<doc xml:space="preserve">Manages a set of pads with the purpose of aggregating their buffers.
|
|
Control is given to the subclass when all pads have data.
|
|
|
|
* Base class for mixers and muxers. Subclasses should at least implement
|
|
the #GstAggregatorClass.aggregate() virtual method.
|
|
|
|
* Installs a #GstPadChainFunction, a #GstPadEventFullFunction and a
|
|
#GstPadQueryFunction to queue all serialized data packets per sink pad.
|
|
Subclasses should not overwrite those, but instead implement
|
|
#GstAggregatorClass.sink_event() and #GstAggregatorClass.sink_query() as
|
|
needed.
|
|
|
|
* When data is queued on all pads, the aggregate vmethod is called.
|
|
|
|
* One can peek at the data on any given GstAggregatorPad with the
|
|
gst_aggregator_pad_peek_buffer () method, and remove it from the pad
|
|
with the gst_aggregator_pad_pop_buffer () method. When a buffer
|
|
has been taken with pop_buffer (), a new buffer can be queued
|
|
on that pad.
|
|
|
|
* If the subclass wishes to push a buffer downstream in its aggregate
|
|
implementation, it should do so through the
|
|
gst_aggregator_finish_buffer () method. This method will take care
|
|
of sending and ordering mandatory events such as stream start, caps
|
|
and segment.
|
|
|
|
* Same goes for EOS events, which should not be pushed directly by the
|
|
subclass, it should instead return GST_FLOW_EOS in its aggregate
|
|
implementation.
|
|
|
|
* Note that the aggregator logic regarding gap event handling is to turn
|
|
these into gap buffers with matching PTS and duration. It will also
|
|
flag these buffers with GST_BUFFER_FLAG_GAP and GST_BUFFER_FLAG_DROPPABLE
|
|
to ease their identification and subsequent processing.
|
|
|
|
* Subclasses must use (a subclass of) #GstAggregatorPad for both their
|
|
sink and source pads.
|
|
See gst_element_class_add_static_pad_template_with_gtype().
|
|
|
|
This class used to live in gst-plugins-bad and was moved to core.</doc>
|
|
|
|
<virtual-method name="aggregate">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="clip">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_new_pad" introspectable="0">
|
|
|
|
<return-value>
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="templ" transfer-ownership="none">
|
|
<type name="Gst.PadTemplate" c:type="GstPadTemplate*"/>
|
|
</parameter>
|
|
<parameter name="req_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="const GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="decide_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="finish_buffer" invoker="finish_buffer">
|
|
<doc xml:space="preserve">This method will push the provided output buffer downstream. If needed,
|
|
mandatory events such as stream-start, caps, and segment events will be
|
|
sent before pushing the buffer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="full">
|
|
<doc xml:space="preserve">the #GstBuffer to push.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="fixate_src_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="flush">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_next_time">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="negotiate" invoker="negotiate" version="1.18">
|
|
<doc xml:space="preserve">Negotiates src pad caps with downstream elements.
|
|
Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again
|
|
if #GstAggregatorClass.negotiate() fails.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the negotiation succeeded, else %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="negotiated_src_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="propose_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="decide_query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="sink_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="sink_event_pre_queue">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="sink_query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="sink_query_pre_queue">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="src_activate">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="mode" transfer-ownership="none">
|
|
<type name="Gst.PadMode" c:type="GstPadMode"/>
|
|
</parameter>
|
|
<parameter name="active" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="src_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="src_query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="update_src_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="ret" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<type name="Gst.Caps" c:type="GstCaps**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="finish_buffer" c:identifier="gst_aggregator_finish_buffer">
|
|
<doc xml:space="preserve">This method will push the provided output buffer downstream. If needed,
|
|
mandatory events such as stream-start, caps, and segment events will be
|
|
sent before pushing the buffer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggregator" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="full">
|
|
<doc xml:space="preserve">the #GstBuffer to push.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_allocator" c:identifier="gst_aggregator_get_allocator">
|
|
<doc xml:space="preserve">Lets #GstAggregator sub-classes get the memory @allocator
|
|
acquired by the base class and its @params.
|
|
|
|
Unref the @allocator after use it.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="allocator" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the #GstAllocator
|
|
used</doc>
|
|
<type name="Gst.Allocator" c:type="GstAllocator**"/>
|
|
</parameter>
|
|
<parameter name="params" direction="out" caller-allocates="1" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the
|
|
#GstAllocationParams of @allocator</doc>
|
|
<type name="Gst.AllocationParams" c:type="GstAllocationParams*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_buffer_pool" c:identifier="gst_aggregator_get_buffer_pool">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the instance of the #GstBufferPool used
|
|
by @trans; free it after use it</doc>
|
|
<type name="Gst.BufferPool" c:type="GstBufferPool*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_latency" c:identifier="gst_aggregator_get_latency">
|
|
<doc xml:space="preserve">Retrieves the latency values reported by @self in response to the latency
|
|
query, or %GST_CLOCK_TIME_NONE if there is not live source connected and the element
|
|
will not wait for the clock.
|
|
|
|
Typically only called by subclasses.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The latency or %GST_CLOCK_TIME_NONE if the element does not sync</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="negotiate" c:identifier="gst_aggregator_negotiate" version="1.18">
|
|
<doc xml:space="preserve">Negotiates src pad caps with downstream elements.
|
|
Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again
|
|
if #GstAggregatorClass.negotiate() fails.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the negotiation succeeded, else %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_latency" c:identifier="gst_aggregator_set_latency">
|
|
<doc xml:space="preserve">Lets #GstAggregator sub-classes tell the baseclass what their internal
|
|
latency is. Will also post a LATENCY message on the bus so the pipeline
|
|
can reconfigure its global latency.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="min_latency" transfer-ownership="none">
|
|
<doc xml:space="preserve">minimum latency</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
<parameter name="max_latency" transfer-ownership="none">
|
|
<doc xml:space="preserve">maximum latency</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_src_caps" c:identifier="gst_aggregator_set_src_caps">
|
|
<doc xml:space="preserve">Sets the caps to be used on the src pad.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GstCaps to set on the src pad.</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="simple_get_next_time" c:identifier="gst_aggregator_simple_get_next_time" version="1.16">
|
|
<doc xml:space="preserve">This is a simple #GstAggregatorClass.get_next_time() implementation that
|
|
just looks at the #GstSegment on the srcpad of the aggregator and bases
|
|
the next time on the running time there.
|
|
|
|
This is the desired behaviour in most cases where you have a live source
|
|
and you have a dead line based aggregator subclass.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The running time based on the position</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">A #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="update_segment" c:identifier="gst_aggregator_update_segment" version="1.18">
|
|
<doc xml:space="preserve">Subclasses should use this to update the segment on their
|
|
source pad, instead of directly pushing new segment events
|
|
downstream.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</instance-parameter>
|
|
<parameter name="segment" transfer-ownership="none">
|
|
<type name="Gst.Segment" c:type="const GstSegment*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="latency" writable="1" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</property>
|
|
<property name="min-upstream-latency" version="1.16" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">Force minimum upstream latency (in nanoseconds). When sources with a
|
|
higher latency are expected to be plugged in dynamically after the
|
|
aggregator has started playing, this allows overriding the minimum
|
|
latency reported by the initial source(s). This is only taken into
|
|
account when larger than the actually reported minimum latency.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</property>
|
|
<property name="start-time" writable="1" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</property>
|
|
<property name="start-time-selection" introspectable="0" writable="1" transfer-ownership="none">
|
|
<type/>
|
|
</property>
|
|
<field name="parent">
|
|
<type name="Gst.Element" c:type="GstElement"/>
|
|
</field>
|
|
<field name="srcpad">
|
|
<doc xml:space="preserve">the aggregator's source pad</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="AggregatorPrivate" c:type="GstAggregatorPrivate*"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="20">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</class>
|
|
<record name="AggregatorClass" c:type="GstAggregatorClass" glib:is-gtype-struct-for="Aggregator" version="1.14">
|
|
<doc xml:space="preserve">The aggregator base class will handle in a thread-safe way all manners of
|
|
concurrent flushes, seeks, pad additions and removals, leaving to the
|
|
subclass the responsibility of clipping buffers, and aggregating buffers in
|
|
the way the implementor sees fit.
|
|
|
|
It will also take care of event ordering (stream-start, segment, eos).
|
|
|
|
Basically, a simple implementation will override @aggregate, and call
|
|
_finish_buffer from inside that function.</doc>
|
|
|
|
<field name="parent_class">
|
|
<type name="Gst.ElementClass" c:type="GstElementClass"/>
|
|
</field>
|
|
<field name="flush">
|
|
<callback name="flush">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="clip">
|
|
<callback name="clip">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="finish_buffer">
|
|
<callback name="finish_buffer">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="full">
|
|
<doc xml:space="preserve">the #GstBuffer to push.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="sink_event">
|
|
<callback name="sink_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="sink_query">
|
|
<callback name="sink_query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="src_event">
|
|
<callback name="src_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="src_query">
|
|
<callback name="src_query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="src_activate">
|
|
<callback name="src_activate">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="mode" transfer-ownership="none">
|
|
<type name="Gst.PadMode" c:type="GstPadMode"/>
|
|
</parameter>
|
|
<parameter name="active" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="aggregate">
|
|
<callback name="aggregate">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop">
|
|
<callback name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="start">
|
|
<callback name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_next_time">
|
|
<callback name="get_next_time">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_new_pad" introspectable="0">
|
|
<callback name="create_new_pad" introspectable="0">
|
|
|
|
<return-value>
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="templ" transfer-ownership="none">
|
|
<type name="Gst.PadTemplate" c:type="GstPadTemplate*"/>
|
|
</parameter>
|
|
<parameter name="req_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="const GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="update_src_caps">
|
|
<callback name="update_src_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="ret" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<type name="Gst.Caps" c:type="GstCaps**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="fixate_src_caps">
|
|
<callback name="fixate_src_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="negotiated_src_caps">
|
|
<callback name="negotiated_src_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="decide_allocation">
|
|
<callback name="decide_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="propose_allocation">
|
|
<callback name="propose_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="decide_query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="negotiate">
|
|
<callback name="negotiate">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the negotiation succeeded, else %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstAggregator</doc>
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="sink_event_pre_queue">
|
|
<callback name="sink_event_pre_queue">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="sink_query_pre_queue">
|
|
<callback name="sink_query_pre_queue">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="aggregator_pad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="17">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<class name="AggregatorPad" c:symbol-prefix="aggregator_pad" c:type="GstAggregatorPad" version="1.14" parent="Gst.Pad" glib:type-name="GstAggregatorPad" glib:get-type="gst_aggregator_pad_get_type" glib:type-struct="AggregatorPadClass">
|
|
<doc xml:space="preserve">Pads managed by a #GstAggregator subclass.
|
|
|
|
This class used to live in gst-plugins-bad and was moved to core.</doc>
|
|
|
|
<virtual-method name="flush">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggpad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</instance-parameter>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="skip_buffer">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="aggpad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</instance-parameter>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="drop_buffer" c:identifier="gst_aggregator_pad_drop_buffer">
|
|
<doc xml:space="preserve">Drop the buffer currently queued in @pad.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">TRUE if there was a buffer queued in @pad, or FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the pad where to drop any pending buffer</doc>
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_buffer" c:identifier="gst_aggregator_pad_has_buffer" version="1.14.1">
|
|
<doc xml:space="preserve">This checks if a pad has a buffer available that will be returned by
|
|
a call to gst_aggregator_pad_peek_buffer() or
|
|
gst_aggregator_pad_pop_buffer().</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the pad has a buffer available as the next thing.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the pad to check the buffer on</doc>
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_eos" c:identifier="gst_aggregator_pad_is_eos">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the pad is EOS, otherwise %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">an aggregator pad</doc>
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_buffer" c:identifier="gst_aggregator_pad_peek_buffer">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">A reference to the buffer in @pad or
|
|
NULL if no buffer was queued. You should unref the buffer after
|
|
usage.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the pad to get buffer from</doc>
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pop_buffer" c:identifier="gst_aggregator_pad_pop_buffer">
|
|
<doc xml:space="preserve">Steal the ref to the buffer currently queued in @pad.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">The buffer in @pad or NULL if no buffer was
|
|
queued. You should unref the buffer after usage.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the pad to get buffer from</doc>
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="emit-signals" version="1.16" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">Enables the emission of signals such as #GstAggregatorPad::buffer-consumed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="parent">
|
|
<type name="Gst.Pad" c:type="GstPad"/>
|
|
</field>
|
|
<field name="segment">
|
|
<doc xml:space="preserve">last segment received.</doc>
|
|
<type name="Gst.Segment" c:type="GstSegment"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="AggregatorPadPrivate" c:type="GstAggregatorPadPrivate*"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<glib:signal name="buffer-consumed" when="first">
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="Gst.Buffer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="AggregatorPadClass" c:type="GstAggregatorPadClass" glib:is-gtype-struct-for="AggregatorPad" version="1.14">
|
|
|
|
<field name="parent_class">
|
|
<type name="Gst.PadClass" c:type="GstPadClass"/>
|
|
</field>
|
|
<field name="flush">
|
|
<callback name="flush">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggpad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="skip_buffer">
|
|
<callback name="skip_buffer">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="aggpad" transfer-ownership="none">
|
|
<type name="AggregatorPad" c:type="GstAggregatorPad*"/>
|
|
</parameter>
|
|
<parameter name="aggregator" transfer-ownership="none">
|
|
<type name="Aggregator" c:type="GstAggregator*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="20">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="AggregatorPadPrivate" c:type="GstAggregatorPadPrivate" disguised="1">
|
|
|
|
</record>
|
|
<record name="AggregatorPrivate" c:type="GstAggregatorPrivate" disguised="1">
|
|
|
|
</record>
|
|
<function-macro name="BASE_PARSE" c:identifier="GST_BASE_PARSE" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_PARSE_CAST" c:identifier="GST_BASE_PARSE_CAST" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_PARSE_CLASS" c:identifier="GST_BASE_PARSE_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_PARSE_DRAINING" c:identifier="GST_BASE_PARSE_DRAINING" introspectable="0">
|
|
<doc xml:space="preserve">Obtains current drain status (ie. whether EOS has been received and
|
|
the parser is now processing the frames at the end of the stream)</doc>
|
|
|
|
<parameters>
|
|
<parameter name="parse">
|
|
<doc xml:space="preserve">base parse instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="BASE_PARSE_FLAG_DRAINING" value="2" c:type="GST_BASE_PARSE_FLAG_DRAINING">
|
|
|
|
<type name="gint" c:type="gint"/>
|
|
</constant>
|
|
<constant name="BASE_PARSE_FLAG_LOST_SYNC" value="1" c:type="GST_BASE_PARSE_FLAG_LOST_SYNC">
|
|
|
|
<type name="gint" c:type="gint"/>
|
|
</constant>
|
|
<function-macro name="BASE_PARSE_GET_CLASS" c:identifier="GST_BASE_PARSE_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_PARSE_LOST_SYNC" c:identifier="GST_BASE_PARSE_LOST_SYNC" introspectable="0">
|
|
<doc xml:space="preserve">Obtains current sync status.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="parse">
|
|
<doc xml:space="preserve">base parse instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_PARSE_SINK_PAD" c:identifier="GST_BASE_PARSE_SINK_PAD" introspectable="0">
|
|
<doc xml:space="preserve">Gives the pointer to the sink #GstPad object of the element.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
<doc xml:space="preserve">base parse instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_PARSE_SRC_PAD" c:identifier="GST_BASE_PARSE_SRC_PAD" introspectable="0">
|
|
<doc xml:space="preserve">Gives the pointer to the source #GstPad object of the element.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
<doc xml:space="preserve">base parse instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK" c:identifier="GST_BASE_SINK" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_CAST" c:identifier="GST_BASE_SINK_CAST" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_CLASS" c:identifier="GST_BASE_SINK_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_GET_CLASS" c:identifier="GST_BASE_SINK_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_GET_PREROLL_COND" c:identifier="GST_BASE_SINK_GET_PREROLL_COND" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_GET_PREROLL_LOCK" c:identifier="GST_BASE_SINK_GET_PREROLL_LOCK" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_PAD" c:identifier="GST_BASE_SINK_PAD" introspectable="0">
|
|
<doc xml:space="preserve">Gives the pointer to the #GstPad object of the element.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
<doc xml:space="preserve">base sink instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_PREROLL_BROADCAST" c:identifier="GST_BASE_SINK_PREROLL_BROADCAST" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_PREROLL_LOCK" c:identifier="GST_BASE_SINK_PREROLL_LOCK" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_PREROLL_SIGNAL" c:identifier="GST_BASE_SINK_PREROLL_SIGNAL" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_PREROLL_TRYLOCK" c:identifier="GST_BASE_SINK_PREROLL_TRYLOCK" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_PREROLL_UNLOCK" c:identifier="GST_BASE_SINK_PREROLL_UNLOCK" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_PREROLL_WAIT" c:identifier="GST_BASE_SINK_PREROLL_WAIT" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SINK_PREROLL_WAIT_UNTIL" c:identifier="GST_BASE_SINK_PREROLL_WAIT_UNTIL" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
<parameter name="end_time">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SRC" c:identifier="GST_BASE_SRC" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SRC_CAST" c:identifier="GST_BASE_SRC_CAST" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SRC_CLASS" c:identifier="GST_BASE_SRC_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SRC_GET_CLASS" c:identifier="GST_BASE_SRC_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SRC_IS_STARTED" c:identifier="GST_BASE_SRC_IS_STARTED" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SRC_IS_STARTING" c:identifier="GST_BASE_SRC_IS_STARTING" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_SRC_PAD" c:identifier="GST_BASE_SRC_PAD" introspectable="0">
|
|
<doc xml:space="preserve">Gives the pointer to the #GstPad object of the element.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_TRANSFORM" c:identifier="GST_BASE_TRANSFORM" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_TRANSFORM_CAST" c:identifier="GST_BASE_TRANSFORM_CAST" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_TRANSFORM_CLASS" c:identifier="GST_BASE_TRANSFORM_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BASE_TRANSFORM_GET_CLASS" c:identifier="GST_BASE_TRANSFORM_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="BASE_TRANSFORM_SINK_NAME" value="sink" c:type="GST_BASE_TRANSFORM_SINK_NAME">
|
|
<doc xml:space="preserve">The name of the templates for the sink pad.</doc>
|
|
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="BASE_TRANSFORM_SINK_PAD" c:identifier="GST_BASE_TRANSFORM_SINK_PAD" introspectable="0">
|
|
<doc xml:space="preserve">Gives the pointer to the sink #GstPad object of the element.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
<doc xml:space="preserve">base transform instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="BASE_TRANSFORM_SRC_NAME" value="src" c:type="GST_BASE_TRANSFORM_SRC_NAME">
|
|
<doc xml:space="preserve">The name of the templates for the source pad.</doc>
|
|
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="BASE_TRANSFORM_SRC_PAD" c:identifier="GST_BASE_TRANSFORM_SRC_PAD" introspectable="0">
|
|
<doc xml:space="preserve">Gives the pointer to the source #GstPad object of the element.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
<doc xml:space="preserve">base transform instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BIT_READER" c:identifier="GST_BIT_READER" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="reader">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BIT_READER_INIT" c:identifier="GST_BIT_READER_INIT" introspectable="0">
|
|
<doc xml:space="preserve">A #GstBitReader must be initialized with this macro, before it can be
|
|
used. This macro can used be to initialize a variable, but it cannot
|
|
be assigned to a variable. In that case you have to use
|
|
gst_bit_reader_init().</doc>
|
|
|
|
<parameters>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">Data from which the #GstBitReader should read</doc>
|
|
</parameter>
|
|
<parameter name="size">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BIT_WRITER" c:identifier="GST_BIT_WRITER" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="writer">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BIT_WRITER_BIT_SIZE" c:identifier="GST_BIT_WRITER_BIT_SIZE" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="writer">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BIT_WRITER_DATA" c:identifier="GST_BIT_WRITER_DATA" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="writer">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BYTE_READER" c:identifier="GST_BYTE_READER" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="reader">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BYTE_READER_INIT" c:identifier="GST_BYTE_READER_INIT" introspectable="0">
|
|
<doc xml:space="preserve">A #GstByteReader must be initialized with this macro, before it can be
|
|
used. This macro can used be to initialize a variable, but it cannot
|
|
be assigned to a variable. In that case you have to use
|
|
gst_byte_reader_init().</doc>
|
|
|
|
<parameters>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">Data from which the #GstByteReader should read</doc>
|
|
</parameter>
|
|
<parameter name="size">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BYTE_WRITER" c:identifier="GST_BYTE_WRITER" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="writer">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="BaseParse" c:symbol-prefix="base_parse" c:type="GstBaseParse" parent="Gst.Element" abstract="1" glib:type-name="GstBaseParse" glib:get-type="gst_base_parse_get_type" glib:type-struct="BaseParseClass">
|
|
<doc xml:space="preserve">This base class is for parser elements that process data and splits it
|
|
into separate audio/video/whatever frames.
|
|
|
|
It provides for:
|
|
|
|
* provides one sink pad and one source pad
|
|
* handles state changes
|
|
* can operate in pull mode or push mode
|
|
* handles seeking in both modes
|
|
* handles events (SEGMENT/EOS/FLUSH)
|
|
* handles queries (POSITION/DURATION/SEEKING/FORMAT/CONVERT)
|
|
* handles flushing
|
|
|
|
The purpose of this base class is to provide the basic functionality of
|
|
a parser and share a lot of rather complex code.
|
|
|
|
# Description of the parsing mechanism:
|
|
|
|
## Set-up phase
|
|
|
|
* #GstBaseParse calls #GstBaseParseClass.start() to inform subclass
|
|
that data processing is about to start now.
|
|
|
|
* #GstBaseParse class calls #GstBaseParseClass.set_sink_caps() to
|
|
inform the subclass about incoming sinkpad caps. Subclass could
|
|
already set the srcpad caps accordingly, but this might be delayed
|
|
until calling gst_base_parse_finish_frame() with a non-queued frame.
|
|
|
|
* At least at this point subclass needs to tell the #GstBaseParse class
|
|
how big data chunks it wants to receive (minimum frame size ). It can
|
|
do this with gst_base_parse_set_min_frame_size().
|
|
|
|
* #GstBaseParse class sets up appropriate data passing mode (pull/push)
|
|
and starts to process the data.
|
|
|
|
## Parsing phase
|
|
|
|
* #GstBaseParse gathers at least min_frame_size bytes of data either
|
|
by pulling it from upstream or collecting buffers in an internal
|
|
#GstAdapter.
|
|
|
|
* A buffer of (at least) min_frame_size bytes is passed to subclass
|
|
with #GstBaseParseClass.handle_frame(). Subclass checks the contents
|
|
and can optionally return #GST_FLOW_OK along with an amount of data
|
|
to be skipped to find a valid frame (which will result in a
|
|
subsequent DISCONT). If, otherwise, the buffer does not hold a
|
|
complete frame, #GstBaseParseClass.handle_frame() can merely return
|
|
and will be called again when additional data is available. In push
|
|
mode this amounts to an additional input buffer (thus minimal
|
|
additional latency), in pull mode this amounts to some arbitrary
|
|
reasonable buffer size increase.
|
|
|
|
Of course, gst_base_parse_set_min_frame_size() could also be used if
|
|
a very specific known amount of additional data is required. If,
|
|
however, the buffer holds a complete valid frame, it can pass the
|
|
size of this frame to gst_base_parse_finish_frame().
|
|
|
|
If acting as a converter, it can also merely indicate consumed input
|
|
data while simultaneously providing custom output data. Note that
|
|
baseclass performs some processing (such as tracking overall consumed
|
|
data rate versus duration) for each finished frame, but other state
|
|
is only updated upon each call to #GstBaseParseClass.handle_frame()
|
|
(such as tracking upstream input timestamp).
|
|
|
|
Subclass is also responsible for setting the buffer metadata
|
|
(e.g. buffer timestamp and duration, or keyframe if applicable).
|
|
(although the latter can also be done by #GstBaseParse if it is
|
|
appropriately configured, see below). Frame is provided with
|
|
timestamp derived from upstream (as much as generally possible),
|
|
duration obtained from configuration (see below), and offset
|
|
if meaningful (in pull mode).
|
|
|
|
Note that #GstBaseParseClass.handle_frame() might receive any small
|
|
amount of input data when leftover data is being drained (e.g. at
|
|
EOS).
|
|
|
|
* As part of finish frame processing, just prior to actually pushing
|
|
the buffer in question, it is passed to
|
|
#GstBaseParseClass.pre_push_frame() which gives subclass yet one last
|
|
chance to examine buffer metadata, or to send some custom (tag)
|
|
events, or to perform custom (segment) filtering.
|
|
|
|
* During the parsing process #GstBaseParseClass will handle both srcpad
|
|
and sinkpad events. They will be passed to subclass if
|
|
#GstBaseParseClass.sink_event() or #GstBaseParseClass.src_event()
|
|
implementations have been provided.
|
|
|
|
## Shutdown phase
|
|
|
|
* #GstBaseParse class calls #GstBaseParseClass.stop() to inform the
|
|
subclass that data parsing will be stopped.
|
|
|
|
Subclass is responsible for providing pad template caps for source and
|
|
sink pads. The pads need to be named "sink" and "src". It also needs to
|
|
set the fixed caps on srcpad, when the format is ensured (e.g. when
|
|
base class calls subclass' #GstBaseParseClass.set_sink_caps() function).
|
|
|
|
This base class uses %GST_FORMAT_DEFAULT as a meaning of frames. So,
|
|
subclass conversion routine needs to know that conversion from
|
|
%GST_FORMAT_TIME to %GST_FORMAT_DEFAULT must return the
|
|
frame number that can be found from the given byte position.
|
|
|
|
#GstBaseParse uses subclasses conversion methods also for seeking (or
|
|
otherwise uses its own default one, see also below).
|
|
|
|
Subclass @start and @stop functions will be called to inform the beginning
|
|
and end of data processing.
|
|
|
|
Things that subclass need to take care of:
|
|
|
|
* Provide pad templates
|
|
* Fixate the source pad caps when appropriate
|
|
* Inform base class how big data chunks should be retrieved. This is
|
|
done with gst_base_parse_set_min_frame_size() function.
|
|
* Examine data chunks passed to subclass with
|
|
#GstBaseParseClass.handle_frame() and pass proper frame(s) to
|
|
gst_base_parse_finish_frame(), and setting src pad caps and timestamps
|
|
on frame.
|
|
* Provide conversion functions
|
|
* Update the duration information with gst_base_parse_set_duration()
|
|
* Optionally passthrough using gst_base_parse_set_passthrough()
|
|
* Configure various baseparse parameters using
|
|
gst_base_parse_set_average_bitrate(), gst_base_parse_set_syncable()
|
|
and gst_base_parse_set_frame_rate().
|
|
|
|
* In particular, if subclass is unable to determine a duration, but
|
|
parsing (or specs) yields a frames per seconds rate, then this can be
|
|
provided to #GstBaseParse to enable it to cater for buffer time
|
|
metadata (which will be taken from upstream as much as
|
|
possible). Internally keeping track of frame durations and respective
|
|
sizes that have been pushed provides #GstBaseParse with an estimated
|
|
bitrate. A default #GstBaseParseClass.convert() (used if not
|
|
overridden) will then use these rates to perform obvious conversions.
|
|
These rates are also used to update (estimated) duration at regular
|
|
frame intervals.</doc>
|
|
|
|
<virtual-method name="convert">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="src_format" transfer-ownership="none">
|
|
<type name="Gst.Format" c:type="GstFormat"/>
|
|
</parameter>
|
|
<parameter name="src_value" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="dest_format" transfer-ownership="none">
|
|
<type name="Gst.Format" c:type="GstFormat"/>
|
|
</parameter>
|
|
<parameter name="dest_value" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="detect">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_sink_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="filter" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="handle_frame">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="frame" transfer-ownership="none">
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</parameter>
|
|
<parameter name="skipsize" transfer-ownership="none">
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="pre_push_frame">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="frame" transfer-ownership="none">
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_sink_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="sink_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="sink_query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="src_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="src_query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="add_index_entry" c:identifier="gst_base_parse_add_index_entry">
|
|
<doc xml:space="preserve">Adds an entry to the index associating @offset to @ts. It is recommended
|
|
to only add keyframe entries. @force allows to bypass checks, such as
|
|
whether the stream is (upstream) seekable, another entry is already "close"
|
|
to the new entry, etc.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">#gboolean indicating whether entry was added</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBaseParse.</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">offset of entry</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="ts" transfer-ownership="none">
|
|
<doc xml:space="preserve">timestamp associated with offset</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve">whether entry refers to keyframe</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="force" transfer-ownership="none">
|
|
<doc xml:space="preserve">add entry disregarding sanity checks</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="convert_default" c:identifier="gst_base_parse_convert_default">
|
|
<doc xml:space="preserve">Default implementation of #GstBaseParseClass.convert().</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if conversion was successful.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBaseParse.</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="src_format" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstFormat describing the source format.</doc>
|
|
<type name="Gst.Format" c:type="GstFormat"/>
|
|
</parameter>
|
|
<parameter name="src_value" transfer-ownership="none">
|
|
<doc xml:space="preserve">Source value to be converted.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="dest_format" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstFormat defining the converted format.</doc>
|
|
<type name="Gst.Format" c:type="GstFormat"/>
|
|
</parameter>
|
|
<parameter name="dest_value" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer where the conversion result will be put.</doc>
|
|
<type name="gint64" c:type="gint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="drain" c:identifier="gst_base_parse_drain" version="1.12">
|
|
<doc xml:space="preserve">Drains the adapter until it is empty. It decreases the min_frame_size to
|
|
match the current adapter size and calls chain method until the adapter
|
|
is emptied or chain returns with error.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="finish_frame" c:identifier="gst_base_parse_finish_frame">
|
|
<doc xml:space="preserve">Collects parsed data and pushes this downstream.
|
|
Source pad caps must be set when this is called.
|
|
|
|
If @frame's out_buffer is set, that will be used as subsequent frame data.
|
|
Otherwise, @size samples will be taken from the input and used for output,
|
|
and the output's metadata (timestamps etc) will be taken as (optionally)
|
|
set by the subclass on @frame's (input) buffer (which is otherwise
|
|
ignored for any but the above purpose/information).
|
|
|
|
Note that the latter buffer is invalidated by this call, whereas the
|
|
caller retains ownership of @frame.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstFlowReturn that should be escalated to caller (of caller)</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="frame" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParseFrame</doc>
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">consumed input data represented by frame</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="merge_tags" c:identifier="gst_base_parse_merge_tags" version="1.6">
|
|
<doc xml:space="preserve">Sets the parser subclass's tags and how they should be merged with any
|
|
upstream stream tags. This will override any tags previously-set
|
|
with gst_base_parse_merge_tags().
|
|
|
|
Note that this is provided for convenience, and the subclass is
|
|
not required to use this and can still do tag handling on its own.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="tags" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">a #GstTagList to merge, or NULL to unset
|
|
previously-set tags</doc>
|
|
<type name="Gst.TagList" c:type="GstTagList*"/>
|
|
</parameter>
|
|
<parameter name="mode" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc>
|
|
<type name="Gst.TagMergeMode" c:type="GstTagMergeMode"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="push_frame" c:identifier="gst_base_parse_push_frame">
|
|
<doc xml:space="preserve">Pushes the frame's buffer downstream, sends any pending events and
|
|
does some timestamp and segment handling. Takes ownership of
|
|
frame's buffer, though caller retains ownership of @frame.
|
|
|
|
This must be called with sinkpad STREAM_LOCK held.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstFlowReturn</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBaseParse.</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="frame" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParseFrame</doc>
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_average_bitrate" c:identifier="gst_base_parse_set_average_bitrate">
|
|
<doc xml:space="preserve">Optionally sets the average bitrate detected in media (if non-zero),
|
|
e.g. based on metadata, as it will be posted to the application.
|
|
|
|
By default, announced average bitrate is estimated. The average bitrate
|
|
is used to estimate the total duration of the stream and to estimate
|
|
a seek position, if there's no index and the format is syncable
|
|
(see gst_base_parse_set_syncable()).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBaseParse.</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="bitrate" transfer-ownership="none">
|
|
<doc xml:space="preserve">average bitrate in bits/second</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_duration" c:identifier="gst_base_parse_set_duration">
|
|
<doc xml:space="preserve">Sets the duration of the currently playing media. Subclass can use this
|
|
when it is able to determine duration and/or notices a change in the media
|
|
duration. Alternatively, if @interval is non-zero (default), then stream
|
|
duration is determined based on estimated bitrate, and updated every @interval
|
|
frames.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBaseParse.</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="fmt" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstFormat.</doc>
|
|
<type name="Gst.Format" c:type="GstFormat"/>
|
|
</parameter>
|
|
<parameter name="duration" transfer-ownership="none">
|
|
<doc xml:space="preserve">duration value.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="interval" transfer-ownership="none">
|
|
<doc xml:space="preserve">how often to update the duration estimate based on bitrate, or 0.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_frame_rate" c:identifier="gst_base_parse_set_frame_rate">
|
|
<doc xml:space="preserve">If frames per second is configured, parser can take care of buffer duration
|
|
and timestamping. When performing segment clipping, or seeking to a specific
|
|
location, a corresponding decoder might need an initial @lead_in and a
|
|
following @lead_out number of frames to ensure the desired segment is
|
|
entirely filled upon decoding.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstBaseParse to set</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="fps_num" transfer-ownership="none">
|
|
<doc xml:space="preserve">frames per second (numerator).</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="fps_den" transfer-ownership="none">
|
|
<doc xml:space="preserve">frames per second (denominator).</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="lead_in" transfer-ownership="none">
|
|
<doc xml:space="preserve">frames needed before a segment for subsequent decode</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="lead_out" transfer-ownership="none">
|
|
<doc xml:space="preserve">frames needed after a segment</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_has_timing_info" c:identifier="gst_base_parse_set_has_timing_info">
|
|
<doc xml:space="preserve">Set if frames carry timing information which the subclass can (generally)
|
|
parse and provide. In particular, intrinsic (rather than estimated) time
|
|
can be obtained following a seek.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="has_timing" transfer-ownership="none">
|
|
<doc xml:space="preserve">whether frames carry timing information</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_infer_ts" c:identifier="gst_base_parse_set_infer_ts">
|
|
<doc xml:space="preserve">By default, the base class might try to infer PTS from DTS and vice
|
|
versa. While this is generally correct for audio data, it may not
|
|
be otherwise. Sub-classes implementing such formats should disable
|
|
timestamp inferring.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="infer_ts" transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if parser should infer DTS/PTS from each other</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_latency" c:identifier="gst_base_parse_set_latency">
|
|
<doc xml:space="preserve">Sets the minimum and maximum (which may likely be equal) latency introduced
|
|
by the parsing process. If there is such a latency, which depends on the
|
|
particular parsing of the format, it typically corresponds to 1 frame duration.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="min_latency" transfer-ownership="none">
|
|
<doc xml:space="preserve">minimum parse latency</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
<parameter name="max_latency" transfer-ownership="none">
|
|
<doc xml:space="preserve">maximum parse latency</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_min_frame_size" c:identifier="gst_base_parse_set_min_frame_size">
|
|
<doc xml:space="preserve">Subclass can use this function to tell the base class that it needs to
|
|
be given buffers of at least @min_size bytes.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBaseParse.</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="min_size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Minimum size in bytes of the data that this base class should
|
|
give to subclass.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_passthrough" c:identifier="gst_base_parse_set_passthrough">
|
|
<doc xml:space="preserve">Set if the nature of the format or configuration does not allow (much)
|
|
parsing, and the parser should operate in passthrough mode (which only
|
|
applies when operating in push mode). That is, incoming buffers are
|
|
pushed through unmodified, i.e. no #GstBaseParseClass.handle_frame()
|
|
will be invoked, but #GstBaseParseClass.pre_push_frame() will still be
|
|
invoked, so subclass can perform as much or as little is appropriate for
|
|
passthrough semantics in #GstBaseParseClass.pre_push_frame().</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="passthrough" transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if parser should run in passthrough mode</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pts_interpolation" c:identifier="gst_base_parse_set_pts_interpolation">
|
|
<doc xml:space="preserve">By default, the base class will guess PTS timestamps using a simple
|
|
interpolation (previous timestamp + duration), which is incorrect for
|
|
data streams with reordering, where PTS can go backward. Sub-classes
|
|
implementing such formats should disable PTS interpolation.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="pts_interpolate" transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if parser should interpolate PTS timestamps</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_syncable" c:identifier="gst_base_parse_set_syncable">
|
|
<doc xml:space="preserve">Set if frame starts can be identified. This is set by default and
|
|
determines whether seeking based on bitrate averages
|
|
is possible for a format/stream.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="syncable" transfer-ownership="none">
|
|
<doc xml:space="preserve">set if frame starts can be identified</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_ts_at_offset" c:identifier="gst_base_parse_set_ts_at_offset" version="1.2">
|
|
<doc xml:space="preserve">This function should only be called from a @handle_frame implementation.
|
|
|
|
#GstBaseParse creates initial timestamps for frames by using the last
|
|
timestamp seen in the stream before the frame starts. In certain
|
|
cases, the correct timestamps will occur in the stream after the
|
|
start of the frame, but before the start of the actual picture data.
|
|
This function can be used to set the timestamps based on the offset
|
|
into the frame data that the picture starts.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parse" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParse</doc>
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">offset into current buffer</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="disable-passthrough" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">If set to %TRUE, baseparse will unconditionally force parsing of the
|
|
incoming data. This can be required in the rare cases where the incoming
|
|
side-data (caps, pts, dts, ...) is not trusted by the user and wants to
|
|
force validation and parsing of the incoming data.
|
|
If set to %FALSE, decision of whether to parse the data or not is up to
|
|
the implementation (standard behaviour).</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="element">
|
|
<doc xml:space="preserve">the parent element.</doc>
|
|
<type name="Gst.Element" c:type="GstElement"/>
|
|
</field>
|
|
<field name="sinkpad">
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</field>
|
|
<field name="srcpad">
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</field>
|
|
<field name="flags">
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="segment">
|
|
<type name="Gst.Segment" c:type="GstSegment"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="20">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="BaseParsePrivate" c:type="GstBaseParsePrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="BaseParseClass" c:type="GstBaseParseClass" glib:is-gtype-struct-for="BaseParse">
|
|
<doc xml:space="preserve">Subclasses can override any of the available virtual methods or not, as
|
|
needed. At minimum @handle_frame needs to be overridden.</doc>
|
|
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve">the parent class</doc>
|
|
<type name="Gst.ElementClass" c:type="GstElementClass"/>
|
|
</field>
|
|
<field name="start">
|
|
<callback name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop">
|
|
<callback name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_sink_caps">
|
|
<callback name="set_sink_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="handle_frame">
|
|
<callback name="handle_frame">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="frame" transfer-ownership="none">
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</parameter>
|
|
<parameter name="skipsize" transfer-ownership="none">
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="pre_push_frame">
|
|
<callback name="pre_push_frame">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="frame" transfer-ownership="none">
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="convert">
|
|
<callback name="convert">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="src_format" transfer-ownership="none">
|
|
<type name="Gst.Format" c:type="GstFormat"/>
|
|
</parameter>
|
|
<parameter name="src_value" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="dest_format" transfer-ownership="none">
|
|
<type name="Gst.Format" c:type="GstFormat"/>
|
|
</parameter>
|
|
<parameter name="dest_value" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="sink_event">
|
|
<callback name="sink_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="src_event">
|
|
<callback name="src_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_sink_caps">
|
|
<callback name="get_sink_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="filter" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="detect">
|
|
<callback name="detect">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="sink_query">
|
|
<callback name="sink_query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="src_query">
|
|
<callback name="src_query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse" transfer-ownership="none">
|
|
<type name="BaseParse" c:type="GstBaseParse*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="18">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="BaseParseFrame" c:type="GstBaseParseFrame" glib:type-name="GstBaseParseFrame" glib:get-type="gst_base_parse_frame_get_type" c:symbol-prefix="base_parse_frame">
|
|
<doc xml:space="preserve">Frame (context) data passed to each frame parsing virtual methods. In
|
|
addition to providing the data to be checked for a valid frame or an already
|
|
identified frame, it conveys additional metadata or control information
|
|
from and to the subclass w.r.t. the particular frame in question (rather
|
|
than global parameters). Some of these may apply to each parsing stage, others
|
|
only to some a particular one. These parameters are effectively zeroed at start
|
|
of each frame's processing, i.e. parsing virtual method invocation sequence.</doc>
|
|
|
|
<field name="buffer" writable="1">
|
|
<doc xml:space="preserve">input data to be parsed for frames.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</field>
|
|
<field name="out_buffer" writable="1">
|
|
<doc xml:space="preserve">output data.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</field>
|
|
<field name="flags" writable="1">
|
|
<doc xml:space="preserve">a combination of input and output #GstBaseParseFrameFlags that
|
|
convey additional context to subclass or allow subclass to tune
|
|
subsequent #GstBaseParse actions.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="offset" writable="1">
|
|
<doc xml:space="preserve">media specific offset of input frame
|
|
Note that a converter may have a different one on the frame's buffer.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</field>
|
|
<field name="overhead" writable="1">
|
|
<doc xml:space="preserve">subclass can set this to indicates the metadata overhead
|
|
for the given frame, which is then used to enable more accurate bitrate
|
|
computations. If this is -1, it is assumed that this frame should be
|
|
skipped in bitrate calculation.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</field>
|
|
<field name="size" readable="0" private="1">
|
|
<type name="gint" c:type="gint"/>
|
|
</field>
|
|
<field name="_gst_reserved_i" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="2">
|
|
<type name="guint" c:type="guint"/>
|
|
</array>
|
|
</field>
|
|
<field name="_gst_reserved_p" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="2">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<field name="_private_flags" readable="0" private="1">
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<constructor name="new" c:identifier="gst_base_parse_frame_new">
|
|
<doc xml:space="preserve">Allocates a new #GstBaseParseFrame. This function is mainly for bindings,
|
|
elements written in C should usually allocate the frame on the stack and
|
|
then use gst_base_parse_frame_init() to initialise it.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a newly-allocated #GstBaseParseFrame. Free with
|
|
gst_base_parse_frame_free() when no longer needed.</doc>
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBuffer</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve">the flags</doc>
|
|
<type name="BaseParseFrameFlags" c:type="GstBaseParseFrameFlags"/>
|
|
</parameter>
|
|
<parameter name="overhead" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bytes in this frame which should be counted as
|
|
metadata overhead, ie. not used to calculate the average bitrate.
|
|
Set to -1 to mark the entire frame as metadata. If in doubt, set to 0.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="copy" c:identifier="gst_base_parse_frame_copy">
|
|
<doc xml:space="preserve">Copies a #GstBaseParseFrame.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">A copy of @frame</doc>
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="frame" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseParseFrame</doc>
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="gst_base_parse_frame_free">
|
|
<doc xml:space="preserve">Frees the provided @frame.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="frame" transfer-ownership="none">
|
|
<doc xml:space="preserve">A #GstBaseParseFrame</doc>
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init" c:identifier="gst_base_parse_frame_init">
|
|
<doc xml:space="preserve">Sets a #GstBaseParseFrame to initial state. Currently this means
|
|
all public fields are zero-ed and a private flag is set to make
|
|
sure gst_base_parse_frame_free() only frees the contents but not
|
|
the actual frame. Use this function to initialise a #GstBaseParseFrame
|
|
allocated on the stack.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="frame" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBaseParseFrame.</doc>
|
|
<type name="BaseParseFrame" c:type="GstBaseParseFrame*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<bitfield name="BaseParseFrameFlags" c:type="GstBaseParseFrameFlags">
|
|
<doc xml:space="preserve">Flags to be used in a #GstBaseParseFrame.</doc>
|
|
|
|
<member name="none" value="0" c:identifier="GST_BASE_PARSE_FRAME_FLAG_NONE">
|
|
<doc xml:space="preserve">no flag</doc>
|
|
</member>
|
|
<member name="new_frame" value="1" c:identifier="GST_BASE_PARSE_FRAME_FLAG_NEW_FRAME">
|
|
<doc xml:space="preserve">set by baseclass if current frame
|
|
is passed for processing to the subclass for the first time
|
|
(and not set on subsequent calls with same data).</doc>
|
|
</member>
|
|
<member name="no_frame" value="2" c:identifier="GST_BASE_PARSE_FRAME_FLAG_NO_FRAME">
|
|
<doc xml:space="preserve">set to indicate this buffer should not be
|
|
counted as frame, e.g. if this frame is dependent on a previous one.
|
|
As it is not counted as a frame, bitrate increases but frame to time
|
|
conversions are maintained.</doc>
|
|
</member>
|
|
<member name="clip" value="4" c:identifier="GST_BASE_PARSE_FRAME_FLAG_CLIP">
|
|
<doc xml:space="preserve">@pre_push_frame can set this to indicate
|
|
that regular segment clipping can still be performed (as opposed to
|
|
any custom one having been done).</doc>
|
|
</member>
|
|
<member name="drop" value="8" c:identifier="GST_BASE_PARSE_FRAME_FLAG_DROP">
|
|
<doc xml:space="preserve">indicates to @finish_frame that the
|
|
the frame should be dropped (and might be handled internally by subclass)</doc>
|
|
</member>
|
|
<member name="queue" value="16" c:identifier="GST_BASE_PARSE_FRAME_FLAG_QUEUE">
|
|
<doc xml:space="preserve">indicates to @finish_frame that the
|
|
the frame should be queued for now and processed fully later
|
|
when the first non-queued frame is finished</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="BaseParsePrivate" c:type="GstBaseParsePrivate" disguised="1">
|
|
|
|
</record>
|
|
<class name="BaseSink" c:symbol-prefix="base_sink" c:type="GstBaseSink" parent="Gst.Element" abstract="1" glib:type-name="GstBaseSink" glib:get-type="gst_base_sink_get_type" glib:type-struct="BaseSinkClass">
|
|
<doc xml:space="preserve">#GstBaseSink is the base class for sink elements in GStreamer, such as
|
|
xvimagesink or filesink. It is a layer on top of #GstElement that provides a
|
|
simplified interface to plugin writers. #GstBaseSink handles many details
|
|
for you, for example: preroll, clock synchronization, state changes,
|
|
activation in push or pull mode, and queries.
|
|
|
|
In most cases, when writing sink elements, there is no need to implement
|
|
class methods from #GstElement or to set functions on pads, because the
|
|
#GstBaseSink infrastructure should be sufficient.
|
|
|
|
#GstBaseSink provides support for exactly one sink pad, which should be
|
|
named "sink". A sink implementation (subclass of #GstBaseSink) should
|
|
install a pad template in its class_init function, like so:
|
|
|[<!-- language="C" -->
|
|
static void
|
|
my_element_class_init (GstMyElementClass *klass)
|
|
{
|
|
GstElementClass *gstelement_class = GST_ELEMENT_CLASS (klass);
|
|
|
|
// sinktemplate should be a #GstStaticPadTemplate with direction
|
|
// %GST_PAD_SINK and name "sink"
|
|
gst_element_class_add_static_pad_template (gstelement_class, &amp;sinktemplate);
|
|
|
|
gst_element_class_set_static_metadata (gstelement_class,
|
|
"Sink name",
|
|
"Sink",
|
|
"My Sink element",
|
|
"The author <my.sink@my.email>");
|
|
}
|
|
]|
|
|
|
|
#GstBaseSink will handle the prerolling correctly. This means that it will
|
|
return %GST_STATE_CHANGE_ASYNC from a state change to PAUSED until the first
|
|
buffer arrives in this element. The base class will call the
|
|
#GstBaseSinkClass.preroll() vmethod with this preroll buffer and will then
|
|
commit the state change to the next asynchronously pending state.
|
|
|
|
When the element is set to PLAYING, #GstBaseSink will synchronise on the
|
|
clock using the times returned from #GstBaseSinkClass.get_times(). If this
|
|
function returns %GST_CLOCK_TIME_NONE for the start time, no synchronisation
|
|
will be done. Synchronisation can be disabled entirely by setting the object
|
|
#GstBaseSink:sync property to %FALSE.
|
|
|
|
After synchronisation the virtual method #GstBaseSinkClass.render() will be
|
|
called. Subclasses should minimally implement this method.
|
|
|
|
Subclasses that synchronise on the clock in the #GstBaseSinkClass.render()
|
|
method are supported as well. These classes typically receive a buffer in
|
|
the render method and can then potentially block on the clock while
|
|
rendering. A typical example is an audiosink.
|
|
These subclasses can use gst_base_sink_wait_preroll() to perform the
|
|
blocking wait.
|
|
|
|
Upon receiving the EOS event in the PLAYING state, #GstBaseSink will wait
|
|
for the clock to reach the time indicated by the stop time of the last
|
|
#GstBaseSinkClass.get_times() call before posting an EOS message. When the
|
|
element receives EOS in PAUSED, preroll completes, the event is queued and an
|
|
EOS message is posted when going to PLAYING.
|
|
|
|
#GstBaseSink will internally use the %GST_EVENT_SEGMENT events to schedule
|
|
synchronisation and clipping of buffers. Buffers that fall completely outside
|
|
of the current segment are dropped. Buffers that fall partially in the
|
|
segment are rendered (and prerolled). Subclasses should do any subbuffer
|
|
clipping themselves when needed.
|
|
|
|
#GstBaseSink will by default report the current playback position in
|
|
%GST_FORMAT_TIME based on the current clock time and segment information.
|
|
If no clock has been set on the element, the query will be forwarded
|
|
upstream.
|
|
|
|
The #GstBaseSinkClass.set_caps() function will be called when the subclass
|
|
should configure itself to process a specific media type.
|
|
|
|
The #GstBaseSinkClass.start() and #GstBaseSinkClass.stop() virtual methods
|
|
will be called when resources should be allocated. Any
|
|
#GstBaseSinkClass.preroll(), #GstBaseSinkClass.render() and
|
|
#GstBaseSinkClass.set_caps() function will be called between the
|
|
#GstBaseSinkClass.start() and #GstBaseSinkClass.stop() calls.
|
|
|
|
The #GstBaseSinkClass.event() virtual method will be called when an event is
|
|
received by #GstBaseSink. Normally this method should only be overridden by
|
|
very specific elements (such as file sinks) which need to handle the
|
|
newsegment event specially.
|
|
|
|
The #GstBaseSinkClass.unlock() method is called when the elements should
|
|
unblock any blocking operations they perform in the
|
|
#GstBaseSinkClass.render() method. This is mostly useful when the
|
|
#GstBaseSinkClass.render() method performs a blocking write on a file
|
|
descriptor, for example.
|
|
|
|
The #GstBaseSink:max-lateness property affects how the sink deals with
|
|
buffers that arrive too late in the sink. A buffer arrives too late in the
|
|
sink when the presentation time (as a combination of the last segment, buffer
|
|
timestamp and element base_time) plus the duration is before the current
|
|
time of the clock.
|
|
If the frame is later than max-lateness, the sink will drop the buffer
|
|
without calling the render method.
|
|
This feature is disabled if sync is disabled, the
|
|
#GstBaseSinkClass.get_times() method does not return a valid start time or
|
|
max-lateness is set to -1 (the default).
|
|
Subclasses can use gst_base_sink_set_max_lateness() to configure the
|
|
max-lateness value.
|
|
|
|
The #GstBaseSink:qos property will enable the quality-of-service features of
|
|
the basesink which gather statistics about the real-time performance of the
|
|
clock synchronisation. For each buffer received in the sink, statistics are
|
|
gathered and a QOS event is sent upstream with these numbers. This
|
|
information can then be used by upstream elements to reduce their processing
|
|
rate, for example.
|
|
|
|
The #GstBaseSink:async property can be used to instruct the sink to never
|
|
perform an ASYNC state change. This feature is mostly usable when dealing
|
|
with non-synchronized streams or sparse streams.</doc>
|
|
|
|
<virtual-method name="activate_pull">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="active" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="fixate">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="filter" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_times">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="start" transfer-ownership="none">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
<parameter name="end" transfer-ownership="none">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="prepare">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="prepare_list">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer_list" transfer-ownership="none">
|
|
<type name="Gst.BufferList" c:type="GstBufferList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="preroll">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="propose_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="render">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="render_list">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer_list" transfer-ownership="none">
|
|
<type name="Gst.BufferList" c:type="GstBufferList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unlock">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unlock_stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="wait_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="do_preroll" c:identifier="gst_base_sink_do_preroll">
|
|
<doc xml:space="preserve">If the @sink spawns its own thread for pulling buffers from upstream it
|
|
should call this method after it has pulled a buffer. If the element needed
|
|
to preroll, this function will perform the preroll and will then block
|
|
until the element state is changed.
|
|
|
|
This function should be called with the PREROLL_LOCK held.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%GST_FLOW_OK if the preroll completed and processing can
|
|
continue. Any other return value should be returned from the render vmethod.</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="obj" transfer-ownership="none">
|
|
<doc xml:space="preserve">the mini object that caused the preroll</doc>
|
|
<type name="Gst.MiniObject" c:type="GstMiniObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_blocksize" c:identifier="gst_base_sink_get_blocksize">
|
|
<doc xml:space="preserve">Get the number of bytes that the sink will pull when it is operating in pull
|
|
mode.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes @sink will pull in pull mode.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_drop_out_of_segment" c:identifier="gst_base_sink_get_drop_out_of_segment" version="1.12">
|
|
<doc xml:space="preserve">Checks if @sink is currently configured to drop buffers which are outside
|
|
the current segment</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the sink is configured to drop buffers outside the
|
|
current segment.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_last_sample" c:identifier="gst_base_sink_get_last_sample">
|
|
<doc xml:space="preserve">Get the last sample that arrived in the sink and was used for preroll or for
|
|
rendering. This property can be used to generate thumbnails.
|
|
|
|
The #GstCaps on the sample can be used to determine the type of the buffer.
|
|
|
|
Free-function: gst_sample_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">a #GstSample. gst_sample_unref() after
|
|
usage. This function returns %NULL when no buffer has arrived in the
|
|
sink yet or when the sink is not in PAUSED or PLAYING.</doc>
|
|
<type name="Gst.Sample" c:type="GstSample*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_latency" c:identifier="gst_base_sink_get_latency">
|
|
<doc xml:space="preserve">Get the currently configured latency.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The configured latency.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_max_bitrate" c:identifier="gst_base_sink_get_max_bitrate" version="1.2">
|
|
<doc xml:space="preserve">Get the maximum amount of bits per second that the sink will render.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the maximum number of bits per second @sink will render.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_max_lateness" c:identifier="gst_base_sink_get_max_lateness">
|
|
<doc xml:space="preserve">Gets the max lateness value. See gst_base_sink_set_max_lateness() for
|
|
more details.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The maximum time in nanoseconds that a buffer can be late
|
|
before it is dropped and not rendered. A value of -1 means an
|
|
unlimited time.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_processing_deadline" c:identifier="gst_base_sink_get_processing_deadline" version="1.16">
|
|
<doc xml:space="preserve">Get the processing deadline of @sink. see
|
|
gst_base_sink_set_processing_deadline() for more information about
|
|
the processing deadline.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the processing deadline</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_render_delay" c:identifier="gst_base_sink_get_render_delay">
|
|
<doc xml:space="preserve">Get the render delay of @sink. see gst_base_sink_set_render_delay() for more
|
|
information about the render delay.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the render delay of @sink.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_stats" c:identifier="gst_base_sink_get_stats" version="1.18">
|
|
<doc xml:space="preserve">Return various #GstBaseSink statistics. This function returns a #GstStructure
|
|
with name `application/x-gst-base-sink-stats` with the following fields:
|
|
|
|
- "average-rate" G_TYPE_DOUBLE average frame rate
|
|
- "dropped" G_TYPE_UINT64 Number of dropped frames
|
|
- "rendered" G_TYPE_UINT64 Number of rendered frames</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">pointer to #GstStructure</doc>
|
|
<type name="Gst.Structure" c:type="GstStructure*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_sync" c:identifier="gst_base_sink_get_sync">
|
|
<doc xml:space="preserve">Checks if @sink is currently configured to synchronize against the
|
|
clock.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the sink is configured to synchronize against the clock.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_throttle_time" c:identifier="gst_base_sink_get_throttle_time">
|
|
<doc xml:space="preserve">Get the time that will be inserted between frames to control the
|
|
maximum buffers per second.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of nanoseconds @sink will put between frames.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_ts_offset" c:identifier="gst_base_sink_get_ts_offset">
|
|
<doc xml:space="preserve">Get the synchronisation offset of @sink.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The synchronisation offset.</doc>
|
|
<type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_async_enabled" c:identifier="gst_base_sink_is_async_enabled">
|
|
<doc xml:space="preserve">Checks if @sink is currently configured to perform asynchronous state
|
|
changes to PAUSED.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the sink is configured to perform asynchronous state
|
|
changes.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_last_sample_enabled" c:identifier="gst_base_sink_is_last_sample_enabled">
|
|
<doc xml:space="preserve">Checks if @sink is currently configured to store the last received sample in
|
|
the last-sample property.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the sink is configured to store the last received sample.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_qos_enabled" c:identifier="gst_base_sink_is_qos_enabled">
|
|
<doc xml:space="preserve">Checks if @sink is currently configured to send Quality-of-Service events
|
|
upstream.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the sink is configured to perform Quality-of-Service.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_latency" c:identifier="gst_base_sink_query_latency">
|
|
<doc xml:space="preserve">Query the sink for the latency parameters. The latency will be queried from
|
|
the upstream elements. @live will be %TRUE if @sink is configured to
|
|
synchronize against the clock. @upstream_live will be %TRUE if an upstream
|
|
element is live.
|
|
|
|
If both @live and @upstream_live are %TRUE, the sink will want to compensate
|
|
for the latency introduced by the upstream elements by setting the
|
|
@min_latency to a strictly positive value.
|
|
|
|
This function is mostly used by subclasses.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the query succeeded.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="live" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">if the sink is live</doc>
|
|
<type name="gboolean" c:type="gboolean*"/>
|
|
</parameter>
|
|
<parameter name="upstream_live" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">if an upstream element is live</doc>
|
|
<type name="gboolean" c:type="gboolean*"/>
|
|
</parameter>
|
|
<parameter name="min_latency" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the min latency of the upstream elements</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
<parameter name="max_latency" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the max latency of the upstream elements</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_async_enabled" c:identifier="gst_base_sink_set_async_enabled">
|
|
<doc xml:space="preserve">Configures @sink to perform all state changes asynchronously. When async is
|
|
disabled, the sink will immediately go to PAUSED instead of waiting for a
|
|
preroll buffer. This feature is useful if the sink does not synchronize
|
|
against the clock or when it is dealing with sparse streams.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new async value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_blocksize" c:identifier="gst_base_sink_set_blocksize">
|
|
<doc xml:space="preserve">Set the number of bytes that the sink will pull when it is operating in pull
|
|
mode.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="blocksize" transfer-ownership="none">
|
|
<doc xml:space="preserve">the blocksize in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_drop_out_of_segment" c:identifier="gst_base_sink_set_drop_out_of_segment" version="1.12">
|
|
<doc xml:space="preserve">Configure @sink to drop buffers which are outside the current segment</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="drop_out_of_segment" transfer-ownership="none">
|
|
<doc xml:space="preserve">drop buffers outside the segment</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_last_sample_enabled" c:identifier="gst_base_sink_set_last_sample_enabled">
|
|
<doc xml:space="preserve">Configures @sink to store the last received sample in the last-sample
|
|
property.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new enable-last-sample value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_max_bitrate" c:identifier="gst_base_sink_set_max_bitrate" version="1.2">
|
|
<doc xml:space="preserve">Set the maximum amount of bits per second that the sink will render.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="max_bitrate" transfer-ownership="none">
|
|
<doc xml:space="preserve">the max_bitrate in bits per second</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_max_lateness" c:identifier="gst_base_sink_set_max_lateness">
|
|
<doc xml:space="preserve">Sets the new max lateness value to @max_lateness. This value is
|
|
used to decide if a buffer should be dropped or not based on the
|
|
buffer timestamp and the current clock time. A value of -1 means
|
|
an unlimited time.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="max_lateness" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new max lateness value.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_processing_deadline" c:identifier="gst_base_sink_set_processing_deadline" version="1.16">
|
|
<doc xml:space="preserve">Maximum amount of time (in nanoseconds) that the pipeline can take
|
|
for processing the buffer. This is added to the latency of live
|
|
pipelines.
|
|
|
|
This function is usually called by subclasses.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="processing_deadline" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new processing deadline in nanoseconds.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_qos_enabled" c:identifier="gst_base_sink_set_qos_enabled">
|
|
<doc xml:space="preserve">Configures @sink to send Quality-of-Service events upstream.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new qos value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_render_delay" c:identifier="gst_base_sink_set_render_delay">
|
|
<doc xml:space="preserve">Set the render delay in @sink to @delay. The render delay is the time
|
|
between actual rendering of a buffer and its synchronisation time. Some
|
|
devices might delay media rendering which can be compensated for with this
|
|
function.
|
|
|
|
After calling this function, this sink will report additional latency and
|
|
other sinks will adjust their latency to delay the rendering of their media.
|
|
|
|
This function is usually called by subclasses.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="delay" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new delay</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_sync" c:identifier="gst_base_sink_set_sync">
|
|
<doc xml:space="preserve">Configures @sink to synchronize on the clock or not. When
|
|
@sync is %FALSE, incoming samples will be played as fast as
|
|
possible. If @sync is %TRUE, the timestamps of the incoming
|
|
buffers will be used to schedule the exact render time of its
|
|
contents.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="sync" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new sync value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_throttle_time" c:identifier="gst_base_sink_set_throttle_time">
|
|
<doc xml:space="preserve">Set the time that will be inserted between rendered buffers. This
|
|
can be used to control the maximum buffers per second that the sink
|
|
will render.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="throttle" transfer-ownership="none">
|
|
<doc xml:space="preserve">the throttle time in nanoseconds</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_ts_offset" c:identifier="gst_base_sink_set_ts_offset">
|
|
<doc xml:space="preserve">Adjust the synchronisation of @sink with @offset. A negative value will
|
|
render buffers earlier than their timestamp. A positive value will delay
|
|
rendering. This function can be used to fix playback of badly timestamped
|
|
buffers.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new offset</doc>
|
|
<type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait" c:identifier="gst_base_sink_wait">
|
|
<doc xml:space="preserve">This function will wait for preroll to complete and will then block until @time
|
|
is reached. It is usually called by subclasses that use their own internal
|
|
synchronisation but want to let some synchronization (like EOS) be handled
|
|
by the base class.
|
|
|
|
This function should only be called with the PREROLL_LOCK held (like when
|
|
receiving an EOS event in the ::event vmethod or when handling buffers in
|
|
::render).
|
|
|
|
The @time argument should be the running_time of when the timeout should happen
|
|
and will be adjusted with any latency and offset configured in the sink.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstFlowReturn</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="time" transfer-ownership="none">
|
|
<doc xml:space="preserve">the running_time to be reached</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
<parameter name="jitter" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the jitter to be filled with time diff, or %NULL</doc>
|
|
<type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait_clock" c:identifier="gst_base_sink_wait_clock">
|
|
<doc xml:space="preserve">This function will block until @time is reached. It is usually called by
|
|
subclasses that use their own internal synchronisation.
|
|
|
|
If @time is not valid, no synchronisation is done and %GST_CLOCK_BADTIME is
|
|
returned. Likewise, if synchronisation is disabled in the element or there
|
|
is no clock, no synchronisation is done and %GST_CLOCK_BADTIME is returned.
|
|
|
|
This function should only be called with the PREROLL_LOCK held, like when
|
|
receiving an EOS event in the #GstBaseSinkClass.event() vmethod or when
|
|
receiving a buffer in
|
|
the #GstBaseSinkClass.render() vmethod.
|
|
|
|
The @time argument should be the running_time of when this method should
|
|
return and is not adjusted with any latency or offset configured in the
|
|
sink.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstClockReturn</doc>
|
|
<type name="Gst.ClockReturn" c:type="GstClockReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
<parameter name="time" transfer-ownership="none">
|
|
<doc xml:space="preserve">the running_time to be reached</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
<parameter name="jitter" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the jitter to be filled with time diff, or %NULL</doc>
|
|
<type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait_preroll" c:identifier="gst_base_sink_wait_preroll">
|
|
<doc xml:space="preserve">If the #GstBaseSinkClass.render() method performs its own synchronisation
|
|
against the clock it must unblock when going from PLAYING to the PAUSED state
|
|
and call this method before continuing to render the remaining data.
|
|
|
|
If the #GstBaseSinkClass.render() method can block on something else than
|
|
the clock, it must also be ready to unblock immediately on
|
|
the #GstBaseSinkClass.unlock() method and cause the
|
|
#GstBaseSinkClass.render() method to immediately call this function.
|
|
In this case, the subclass must be prepared to continue rendering where it
|
|
left off if this function returns %GST_FLOW_OK.
|
|
|
|
This function will block until a state change to PLAYING happens (in which
|
|
case this function returns %GST_FLOW_OK) or the processing must be stopped due
|
|
to a state change to READY or a FLUSH event (in which case this function
|
|
returns %GST_FLOW_FLUSHING).
|
|
|
|
This function should only be called with the PREROLL_LOCK held, like in the
|
|
render function.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%GST_FLOW_OK if the preroll completed and processing can
|
|
continue. Any other return value should be returned from the render vmethod.</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="sink" transfer-ownership="none">
|
|
<doc xml:space="preserve">the sink</doc>
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="async" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">If set to %TRUE, the basesink will perform asynchronous state changes.
|
|
When set to %FALSE, the sink will not signal the parent when it prerolls.
|
|
Use this option when dealing with sparse streams or when synchronisation is
|
|
not required.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="blocksize" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">The amount of bytes to pull when operating in pull mode.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="enable-last-sample" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">Enable the last-sample property. If %FALSE, basesink doesn't keep a
|
|
reference to the last buffer arrived and the last-sample property is always
|
|
set to %NULL. This can be useful if you need buffers to be released as soon
|
|
as possible, eg. if you're using a buffer pool.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="last-sample" transfer-ownership="none">
|
|
<doc xml:space="preserve">The last buffer that arrived in the sink and was used for preroll or for
|
|
rendering. This property can be used to generate thumbnails. This property
|
|
can be %NULL when the sink has not yet received a buffer.</doc>
|
|
<type name="Gst.Sample"/>
|
|
</property>
|
|
<property name="max-bitrate" version="1.2" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">Control the maximum amount of bits that will be rendered per second.
|
|
Setting this property to a value bigger than 0 will make the sink delay
|
|
rendering of the buffers when it would exceed to max-bitrate.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</property>
|
|
<property name="max-lateness" writable="1" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</property>
|
|
<property name="processing-deadline" version="1.16" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">Maximum amount of time (in nanoseconds) that the pipeline can take
|
|
for processing the buffer. This is added to the latency of live
|
|
pipelines.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</property>
|
|
<property name="qos" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="render-delay" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">The additional delay between synchronisation and actual rendering of the
|
|
media. This property will add additional latency to the device in order to
|
|
make other sinks compensate for the delay.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</property>
|
|
<property name="stats" version="1.18" transfer-ownership="none">
|
|
<doc xml:space="preserve">Various #GstBaseSink statistics. This property returns a #GstStructure
|
|
with name `application/x-gst-base-sink-stats` with the following fields:
|
|
|
|
- "average-rate" G_TYPE_DOUBLE average frame rate
|
|
- "dropped" G_TYPE_UINT64 Number of dropped frames
|
|
- "rendered" G_TYPE_UINT64 Number of rendered frames</doc>
|
|
<type name="Gst.Structure"/>
|
|
</property>
|
|
<property name="sync" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="throttle-time" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">The time to insert between buffers. This property can be used to control
|
|
the maximum amount of buffers per second to render. Setting this property
|
|
to a value bigger than 0 will make the sink create THROTTLE QoS events.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</property>
|
|
<property name="ts-offset" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">Controls the final synchronisation, a negative value will render the buffer
|
|
earlier while a positive value delays playback. This property can be
|
|
used to fix synchronisation in bad files.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</property>
|
|
<field name="element">
|
|
<type name="Gst.Element" c:type="GstElement"/>
|
|
</field>
|
|
<field name="sinkpad">
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</field>
|
|
<field name="pad_mode">
|
|
<type name="Gst.PadMode" c:type="GstPadMode"/>
|
|
</field>
|
|
<field name="offset">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</field>
|
|
<field name="can_activate_pull">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="can_activate_push">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="preroll_lock">
|
|
<type name="GLib.Mutex" c:type="GMutex"/>
|
|
</field>
|
|
<field name="preroll_cond">
|
|
<type name="GLib.Cond" c:type="GCond"/>
|
|
</field>
|
|
<field name="eos">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="need_preroll">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="have_preroll">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="playing_async">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="have_newsegment">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="segment">
|
|
<type name="Gst.Segment" c:type="GstSegment"/>
|
|
</field>
|
|
<field name="clock_id" readable="0" private="1">
|
|
<type name="Gst.ClockID" c:type="GstClockID"/>
|
|
</field>
|
|
<field name="sync" readable="0" private="1">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="flushing" readable="0" private="1">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="running" readable="0" private="1">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="max_lateness" readable="0" private="1">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="BaseSinkPrivate" c:type="GstBaseSinkPrivate*"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="20">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</class>
|
|
<record name="BaseSinkClass" c:type="GstBaseSinkClass" glib:is-gtype-struct-for="BaseSink">
|
|
<doc xml:space="preserve">Subclasses can override any of the available virtual methods or not, as
|
|
needed. At the minimum, the @render method should be overridden to
|
|
output/present buffers.</doc>
|
|
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve">Element parent class</doc>
|
|
<type name="Gst.ElementClass" c:type="GstElementClass"/>
|
|
</field>
|
|
<field name="get_caps">
|
|
<callback name="get_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="filter" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_caps">
|
|
<callback name="set_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="fixate">
|
|
<callback name="fixate">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="activate_pull">
|
|
<callback name="activate_pull">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="active" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_times">
|
|
<callback name="get_times">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="start" transfer-ownership="none">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
<parameter name="end" transfer-ownership="none">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="propose_allocation">
|
|
<callback name="propose_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="start">
|
|
<callback name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop">
|
|
<callback name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unlock">
|
|
<callback name="unlock">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unlock_stop">
|
|
<callback name="unlock_stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query">
|
|
<callback name="query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="event">
|
|
<callback name="event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="wait_event">
|
|
<callback name="wait_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="prepare">
|
|
<callback name="prepare">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="prepare_list">
|
|
<callback name="prepare_list">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="buffer_list" transfer-ownership="none">
|
|
<type name="Gst.BufferList" c:type="GstBufferList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="preroll">
|
|
<callback name="preroll">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="render">
|
|
<callback name="render">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="render_list">
|
|
<callback name="render_list">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sink" transfer-ownership="none">
|
|
<type name="BaseSink" c:type="GstBaseSink*"/>
|
|
</parameter>
|
|
<parameter name="buffer_list" transfer-ownership="none">
|
|
<type name="Gst.BufferList" c:type="GstBufferList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="20">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="BaseSinkPrivate" c:type="GstBaseSinkPrivate" disguised="1">
|
|
|
|
</record>
|
|
<class name="BaseSrc" c:symbol-prefix="base_src" c:type="GstBaseSrc" parent="Gst.Element" abstract="1" glib:type-name="GstBaseSrc" glib:get-type="gst_base_src_get_type" glib:type-struct="BaseSrcClass">
|
|
<doc xml:space="preserve">This is a generic base class for source elements. The following
|
|
types of sources are supported:
|
|
|
|
* random access sources like files
|
|
* seekable sources
|
|
* live sources
|
|
|
|
The source can be configured to operate in any #GstFormat with the
|
|
gst_base_src_set_format() method. The currently set format determines
|
|
the format of the internal #GstSegment and any %GST_EVENT_SEGMENT
|
|
events. The default format for #GstBaseSrc is %GST_FORMAT_BYTES.
|
|
|
|
#GstBaseSrc always supports push mode scheduling. If the following
|
|
conditions are met, it also supports pull mode scheduling:
|
|
|
|
* The format is set to %GST_FORMAT_BYTES (default).
|
|
* #GstBaseSrcClass.is_seekable() returns %TRUE.
|
|
|
|
If all the conditions are met for operating in pull mode, #GstBaseSrc is
|
|
automatically seekable in push mode as well. The following conditions must
|
|
be met to make the element seekable in push mode when the format is not
|
|
%GST_FORMAT_BYTES:
|
|
|
|
* #GstBaseSrcClass.is_seekable() returns %TRUE.
|
|
* #GstBaseSrcClass.query() can convert all supported seek formats to the
|
|
internal format as set with gst_base_src_set_format().
|
|
* #GstBaseSrcClass.do_seek() is implemented, performs the seek and returns
|
|
%TRUE.
|
|
|
|
When the element does not meet the requirements to operate in pull mode, the
|
|
offset and length in the #GstBaseSrcClass.create() method should be ignored.
|
|
It is recommended to subclass #GstPushSrc instead, in this situation. If the
|
|
element can operate in pull mode but only with specific offsets and
|
|
lengths, it is allowed to generate an error when the wrong values are passed
|
|
to the #GstBaseSrcClass.create() function.
|
|
|
|
#GstBaseSrc has support for live sources. Live sources are sources that when
|
|
paused discard data, such as audio or video capture devices. A typical live
|
|
source also produces data at a fixed rate and thus provides a clock to publish
|
|
this rate.
|
|
Use gst_base_src_set_live() to activate the live source mode.
|
|
|
|
A live source does not produce data in the PAUSED state. This means that the
|
|
#GstBaseSrcClass.create() method will not be called in PAUSED but only in
|
|
PLAYING. To signal the pipeline that the element will not produce data, the
|
|
return value from the READY to PAUSED state will be
|
|
%GST_STATE_CHANGE_NO_PREROLL.
|
|
|
|
A typical live source will timestamp the buffers it creates with the
|
|
current running time of the pipeline. This is one reason why a live source
|
|
can only produce data in the PLAYING state, when the clock is actually
|
|
distributed and running.
|
|
|
|
Live sources that synchronize and block on the clock (an audio source, for
|
|
example) can use gst_base_src_wait_playing() when the
|
|
#GstBaseSrcClass.create() function was interrupted by a state change to
|
|
PAUSED.
|
|
|
|
The #GstBaseSrcClass.get_times() method can be used to implement pseudo-live
|
|
sources. It only makes sense to implement the #GstBaseSrcClass.get_times()
|
|
function if the source is a live source. The #GstBaseSrcClass.get_times()
|
|
function should return timestamps starting from 0, as if it were a non-live
|
|
source. The base class will make sure that the timestamps are transformed
|
|
into the current running_time. The base source will then wait for the
|
|
calculated running_time before pushing out the buffer.
|
|
|
|
For live sources, the base class will by default report a latency of 0.
|
|
For pseudo live sources, the base class will by default measure the difference
|
|
between the first buffer timestamp and the start time of get_times and will
|
|
report this value as the latency.
|
|
Subclasses should override the query function when this behaviour is not
|
|
acceptable.
|
|
|
|
There is only support in #GstBaseSrc for exactly one source pad, which
|
|
should be named "src". A source implementation (subclass of #GstBaseSrc)
|
|
should install a pad template in its class_init function, like so:
|
|
|[<!-- language="C" -->
|
|
static void
|
|
my_element_class_init (GstMyElementClass *klass)
|
|
{
|
|
GstElementClass *gstelement_class = GST_ELEMENT_CLASS (klass);
|
|
// srctemplate should be a #GstStaticPadTemplate with direction
|
|
// %GST_PAD_SRC and name "src"
|
|
gst_element_class_add_static_pad_template (gstelement_class, &amp;srctemplate);
|
|
|
|
gst_element_class_set_static_metadata (gstelement_class,
|
|
"Source name",
|
|
"Source",
|
|
"My Source element",
|
|
"The author <my.sink@my.email>");
|
|
}
|
|
]|
|
|
|
|
## Controlled shutdown of live sources in applications
|
|
|
|
Applications that record from a live source may want to stop recording
|
|
in a controlled way, so that the recording is stopped, but the data
|
|
already in the pipeline is processed to the end (remember that many live
|
|
sources would go on recording forever otherwise). For that to happen the
|
|
application needs to make the source stop recording and send an EOS
|
|
event down the pipeline. The application would then wait for an
|
|
EOS message posted on the pipeline's bus to know when all data has
|
|
been processed and the pipeline can safely be stopped.
|
|
|
|
An application may send an EOS event to a source element to make it
|
|
perform the EOS logic (send EOS event downstream or post a
|
|
%GST_MESSAGE_SEGMENT_DONE on the bus). This can typically be done
|
|
with the gst_element_send_event() function on the element or its parent bin.
|
|
|
|
After the EOS has been sent to the element, the application should wait for
|
|
an EOS message to be posted on the pipeline's bus. Once this EOS message is
|
|
received, it may safely shut down the entire pipeline.</doc>
|
|
|
|
<virtual-method name="alloc">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create">
|
|
<doc xml:space="preserve">Ask the subclass to create a buffer with @offset and @size, the default
|
|
implementation will call alloc and fill.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="buf" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="decide_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="do_seek">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="segment" transfer-ownership="none">
|
|
<type name="Gst.Segment" c:type="GstSegment*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="fill">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="fixate">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_caps">
|
|
<doc xml:space="preserve">Called to get the caps to report.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="filter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_size">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_times">
|
|
<doc xml:space="preserve">Given @buffer, return @start and @end time when it should be pushed
|
|
out. The base class will sync on the clock using these times.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="start" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
<parameter name="end" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_seekable">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="negotiate" invoker="negotiate" version="1.18">
|
|
<doc xml:space="preserve">Negotiates src pad caps with downstream elements.
|
|
Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again
|
|
if #GstBaseSrcClass.negotiate() fails.
|
|
|
|
Do not call this in the #GstBaseSrcClass.fill() vmethod. Call this in
|
|
#GstBaseSrcClass.create() or in #GstBaseSrcClass.alloc(), _before_ any
|
|
buffer is allocated.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the negotiation succeeded, else %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="prepare_seek_segment">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="seek" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
<parameter name="segment" transfer-ownership="none">
|
|
<type name="Gst.Segment" c:type="GstSegment*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_caps" invoker="set_caps">
|
|
<doc xml:space="preserve">Set new caps on the basesrc source pad.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the caps could be set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSrc</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstCaps</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unlock">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unlock_stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_allocator" c:identifier="gst_base_src_get_allocator">
|
|
<doc xml:space="preserve">Lets #GstBaseSrc sub-classes to know the memory @allocator
|
|
used by the base class and its @params.
|
|
|
|
Unref the @allocator after usage.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSrc</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="allocator" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the #GstAllocator
|
|
used</doc>
|
|
<type name="Gst.Allocator" c:type="GstAllocator**"/>
|
|
</parameter>
|
|
<parameter name="params" direction="out" caller-allocates="1" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the
|
|
#GstAllocationParams of @allocator</doc>
|
|
<type name="Gst.AllocationParams" c:type="GstAllocationParams*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_blocksize" c:identifier="gst_base_src_get_blocksize">
|
|
<doc xml:space="preserve">Get the number of bytes that @src will push out with each buffer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes pushed with each buffer.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">the source</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_buffer_pool" c:identifier="gst_base_src_get_buffer_pool">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the instance of the #GstBufferPool used
|
|
by the src; unref it after usage.</doc>
|
|
<type name="Gst.BufferPool" c:type="GstBufferPool*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSrc</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_do_timestamp" c:identifier="gst_base_src_get_do_timestamp">
|
|
<doc xml:space="preserve">Query if @src timestamps outgoing buffers based on the current running_time.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the base class will automatically timestamp outgoing buffers.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">the source</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_async" c:identifier="gst_base_src_is_async">
|
|
<doc xml:space="preserve">Get the current async behaviour of @src. See also gst_base_src_set_async().</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if @src is operating in async mode.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_live" c:identifier="gst_base_src_is_live">
|
|
<doc xml:space="preserve">Check if an element is in live mode.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if element is in live mode.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="negotiate" c:identifier="gst_base_src_negotiate" version="1.18">
|
|
<doc xml:space="preserve">Negotiates src pad caps with downstream elements.
|
|
Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again
|
|
if #GstBaseSrcClass.negotiate() fails.
|
|
|
|
Do not call this in the #GstBaseSrcClass.fill() vmethod. Call this in
|
|
#GstBaseSrcClass.create() or in #GstBaseSrcClass.alloc(), _before_ any
|
|
buffer is allocated.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the negotiation succeeded, else %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="new_seamless_segment" c:identifier="gst_base_src_new_seamless_segment">
|
|
<doc xml:space="preserve">Prepare a new seamless segment for emission downstream. This function must
|
|
only be called by derived sub-classes, and only from the #GstBaseSrcClass::create function,
|
|
as the stream-lock needs to be held.
|
|
|
|
The format for the new segment will be the current format of the source, as
|
|
configured with gst_base_src_set_format()</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if preparation of the seamless segment succeeded.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">The source</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="start" transfer-ownership="none">
|
|
<doc xml:space="preserve">The new start value for the segment</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="stop" transfer-ownership="none">
|
|
<doc xml:space="preserve">Stop value for the new segment</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="time" transfer-ownership="none">
|
|
<doc xml:space="preserve">The new time value for the start of the new segment</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_latency" c:identifier="gst_base_src_query_latency">
|
|
<doc xml:space="preserve">Query the source for the latency parameters. @live will be %TRUE when @src is
|
|
configured as a live source. @min_latency and @max_latency will be set
|
|
to the difference between the running time and the timestamp of the first
|
|
buffer.
|
|
|
|
This function is mostly used by subclasses.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the query succeeded.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">the source</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="live" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">if the source is live</doc>
|
|
<type name="gboolean" c:type="gboolean*"/>
|
|
</parameter>
|
|
<parameter name="min_latency" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the min latency of the source</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
<parameter name="max_latency" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the max latency of the source</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_async" c:identifier="gst_base_src_set_async">
|
|
<doc xml:space="preserve">Configure async behaviour in @src, no state change will block. The open,
|
|
close, start, stop, play and pause virtual methods will be executed in a
|
|
different thread and are thus allowed to perform blocking operations. Any
|
|
blocking operation should be unblocked with the unlock vmethod.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="async" transfer-ownership="none">
|
|
<doc xml:space="preserve">new async mode</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_automatic_eos" c:identifier="gst_base_src_set_automatic_eos" version="1.4">
|
|
<doc xml:space="preserve">If @automatic_eos is %TRUE, @src will automatically go EOS if a buffer
|
|
after the total size is returned. By default this is %TRUE but sources
|
|
that can't return an authoritative size and only know that they're EOS
|
|
when trying to read more should set this to %FALSE.
|
|
|
|
When @src operates in %GST_FORMAT_TIME, #GstBaseSrc will send an EOS
|
|
when a buffer outside of the currently configured segment is pushed if
|
|
@automatic_eos is %TRUE. Since 1.16, if @automatic_eos is %FALSE an
|
|
EOS will be pushed only when the #GstBaseSrcClass.create() implementation
|
|
returns %GST_FLOW_EOS.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="automatic_eos" transfer-ownership="none">
|
|
<doc xml:space="preserve">automatic eos</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_blocksize" c:identifier="gst_base_src_set_blocksize">
|
|
<doc xml:space="preserve">Set the number of bytes that @src will push out with each buffer. When
|
|
@blocksize is set to -1, a default length will be used.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">the source</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="blocksize" transfer-ownership="none">
|
|
<doc xml:space="preserve">the new blocksize in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_caps" c:identifier="gst_base_src_set_caps">
|
|
<doc xml:space="preserve">Set new caps on the basesrc source pad.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the caps could be set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSrc</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstCaps</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_do_timestamp" c:identifier="gst_base_src_set_do_timestamp">
|
|
<doc xml:space="preserve">Configure @src to automatically timestamp outgoing buffers based on the
|
|
current running_time of the pipeline. This property is mostly useful for live
|
|
sources.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">the source</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="timestamp" transfer-ownership="none">
|
|
<doc xml:space="preserve">enable or disable timestamping</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_dynamic_size" c:identifier="gst_base_src_set_dynamic_size">
|
|
<doc xml:space="preserve">If not @dynamic, size is only updated when needed, such as when trying to
|
|
read past current tracked size. Otherwise, size is checked for upon each
|
|
read.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="dynamic" transfer-ownership="none">
|
|
<doc xml:space="preserve">new dynamic size mode</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_format" c:identifier="gst_base_src_set_format">
|
|
<doc xml:space="preserve">Sets the default format of the source. This will be the format used
|
|
for sending SEGMENT events and for performing seeks.
|
|
|
|
If a format of GST_FORMAT_BYTES is set, the element will be able to
|
|
operate in pull mode if the #GstBaseSrcClass.is_seekable() returns %TRUE.
|
|
|
|
This function must only be called in states < %GST_STATE_PAUSED.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve">the format to use</doc>
|
|
<type name="Gst.Format" c:type="GstFormat"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_live" c:identifier="gst_base_src_set_live">
|
|
<doc xml:space="preserve">If the element listens to a live source, @live should
|
|
be set to %TRUE.
|
|
|
|
A live source will not produce data in the PAUSED state and
|
|
will therefore not be able to participate in the PREROLL phase
|
|
of a pipeline. To signal this fact to the application and the
|
|
pipeline, the state change return value of the live source will
|
|
be GST_STATE_CHANGE_NO_PREROLL.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="live" transfer-ownership="none">
|
|
<doc xml:space="preserve">new live-mode</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start_complete" c:identifier="gst_base_src_start_complete">
|
|
<doc xml:space="preserve">Complete an asynchronous start operation. When the subclass overrides the
|
|
start method, it should call gst_base_src_start_complete() when the start
|
|
operation completes either from the same thread or from an asynchronous
|
|
helper thread.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="basesrc" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="ret" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstFlowReturn</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start_wait" c:identifier="gst_base_src_start_wait">
|
|
<doc xml:space="preserve">Wait until the start operation completes.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstFlowReturn.</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="basesrc" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="submit_buffer_list" c:identifier="gst_base_src_submit_buffer_list" version="1.14">
|
|
<doc xml:space="preserve">Subclasses can call this from their create virtual method implementation
|
|
to submit a buffer list to be pushed out later. This is useful in
|
|
cases where the create function wants to produce multiple buffers to be
|
|
pushed out in one go in form of a #GstBufferList, which can reduce overhead
|
|
drastically, especially for packetised inputs (for data streams where
|
|
the packetisation/chunking is not important it is usually more efficient
|
|
to return larger buffers instead).
|
|
|
|
Subclasses that use this function from their create function must return
|
|
%GST_FLOW_OK and no buffer from their create virtual method implementation.
|
|
If a buffer is returned after a buffer list has also been submitted via this
|
|
function the behaviour is undefined.
|
|
|
|
Subclasses must only call this function once per create function call and
|
|
subclasses must only call this function when the source operates in push
|
|
mode.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSrc</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer_list" transfer-ownership="full">
|
|
<doc xml:space="preserve">a #GstBufferList</doc>
|
|
<type name="Gst.BufferList" c:type="GstBufferList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait_playing" c:identifier="gst_base_src_wait_playing">
|
|
<doc xml:space="preserve">If the #GstBaseSrcClass.create() method performs its own synchronisation
|
|
against the clock it must unblock when going from PLAYING to the PAUSED state
|
|
and call this method before continuing to produce the remaining data.
|
|
|
|
This function will block until a state change to PLAYING happens (in which
|
|
case this function returns %GST_FLOW_OK) or the processing must be stopped due
|
|
to a state change to READY or a FLUSH event (in which case this function
|
|
returns %GST_FLOW_FLUSHING).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%GST_FLOW_OK if @src is PLAYING and processing can
|
|
continue. Any other return value should be returned from the create vmethod.</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">the src</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="blocksize" writable="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="do-timestamp" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="num-buffers" writable="1" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<property name="typefind" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="element">
|
|
<type name="Gst.Element" c:type="GstElement"/>
|
|
</field>
|
|
<field name="srcpad">
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</field>
|
|
<field name="live_lock">
|
|
<type name="GLib.Mutex" c:type="GMutex"/>
|
|
</field>
|
|
<field name="live_cond">
|
|
<type name="GLib.Cond" c:type="GCond"/>
|
|
</field>
|
|
<field name="is_live">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="live_running">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="blocksize">
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="can_activate_push">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="random_access">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="clock_id">
|
|
<type name="Gst.ClockID" c:type="GstClockID"/>
|
|
</field>
|
|
<field name="segment">
|
|
<type name="Gst.Segment" c:type="GstSegment"/>
|
|
</field>
|
|
<field name="need_newsegment">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="num_buffers">
|
|
<type name="gint" c:type="gint"/>
|
|
</field>
|
|
<field name="num_buffers_left">
|
|
<type name="gint" c:type="gint"/>
|
|
</field>
|
|
<field name="typefind">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="running">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="pending_seek">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="BaseSrcPrivate" c:type="GstBaseSrcPrivate*"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="20">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</class>
|
|
<record name="BaseSrcClass" c:type="GstBaseSrcClass" glib:is-gtype-struct-for="BaseSrc">
|
|
<doc xml:space="preserve">Subclasses can override any of the available virtual methods or not, as
|
|
needed. At the minimum, the @create method should be overridden to produce
|
|
buffers.</doc>
|
|
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve">Element parent class</doc>
|
|
<type name="Gst.ElementClass" c:type="GstElementClass"/>
|
|
</field>
|
|
<field name="get_caps">
|
|
<callback name="get_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="filter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="negotiate">
|
|
<callback name="negotiate">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the negotiation succeeded, else %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">base source instance</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="fixate">
|
|
<callback name="fixate">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_caps">
|
|
<callback name="set_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the caps could be set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseSrc</doc>
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstCaps</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="decide_allocation">
|
|
<callback name="decide_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="start">
|
|
<callback name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop">
|
|
<callback name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_times">
|
|
<callback name="get_times">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="start" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
<parameter name="end" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.ClockTime" c:type="GstClockTime*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_size">
|
|
<callback name="get_size">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_seekable">
|
|
<callback name="is_seekable">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="prepare_seek_segment">
|
|
<callback name="prepare_seek_segment">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="seek" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
<parameter name="segment" transfer-ownership="none">
|
|
<type name="Gst.Segment" c:type="GstSegment*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="do_seek">
|
|
<callback name="do_seek">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="segment" transfer-ownership="none">
|
|
<type name="Gst.Segment" c:type="GstSegment*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unlock">
|
|
<callback name="unlock">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unlock_stop">
|
|
<callback name="unlock_stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query">
|
|
<callback name="query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="event">
|
|
<callback name="event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create">
|
|
<callback name="create">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="buf" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="alloc">
|
|
<callback name="alloc">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="fill">
|
|
<callback name="fill">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="BaseSrc" c:type="GstBaseSrc*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="20">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<bitfield name="BaseSrcFlags" c:type="GstBaseSrcFlags">
|
|
<doc xml:space="preserve">The #GstElement flags that a basesrc element may have.</doc>
|
|
|
|
<member name="starting" value="16384" c:identifier="GST_BASE_SRC_FLAG_STARTING">
|
|
<doc xml:space="preserve">has source is starting</doc>
|
|
</member>
|
|
<member name="started" value="32768" c:identifier="GST_BASE_SRC_FLAG_STARTED">
|
|
<doc xml:space="preserve">has source been started</doc>
|
|
</member>
|
|
<member name="last" value="1048576" c:identifier="GST_BASE_SRC_FLAG_LAST">
|
|
<doc xml:space="preserve">offset to define more flags</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="BaseSrcPrivate" c:type="GstBaseSrcPrivate" disguised="1">
|
|
|
|
</record>
|
|
<class name="BaseTransform" c:symbol-prefix="base_transform" c:type="GstBaseTransform" parent="Gst.Element" abstract="1" glib:type-name="GstBaseTransform" glib:get-type="gst_base_transform_get_type" glib:type-struct="BaseTransformClass">
|
|
<doc xml:space="preserve">This base class is for filter elements that process data. Elements
|
|
that are suitable for implementation using #GstBaseTransform are ones
|
|
where the size and caps of the output is known entirely from the input
|
|
caps and buffer sizes. These include elements that directly transform
|
|
one buffer into another, modify the contents of a buffer in-place, as
|
|
well as elements that collate multiple input buffers into one output buffer,
|
|
or that expand one input buffer into multiple output buffers. See below
|
|
for more concrete use cases.
|
|
|
|
It provides for:
|
|
|
|
* one sinkpad and one srcpad
|
|
* Possible formats on sink and source pad implemented
|
|
with custom transform_caps function. By default uses
|
|
same format on sink and source.
|
|
|
|
* Handles state changes
|
|
* Does flushing
|
|
* Push mode
|
|
* Pull mode if the sub-class transform can operate on arbitrary data
|
|
|
|
# Use Cases
|
|
|
|
## Passthrough mode
|
|
|
|
* Element has no interest in modifying the buffer. It may want to inspect it,
|
|
in which case the element should have a transform_ip function. If there
|
|
is no transform_ip function in passthrough mode, the buffer is pushed
|
|
intact.
|
|
|
|
* The #GstBaseTransformClass.passthrough_on_same_caps variable
|
|
will automatically set/unset passthrough based on whether the
|
|
element negotiates the same caps on both pads.
|
|
|
|
* #GstBaseTransformClass.passthrough_on_same_caps on an element that
|
|
doesn't implement a transform_caps function is useful for elements that
|
|
only inspect data (such as level)
|
|
|
|
* Example elements
|
|
|
|
* Level
|
|
* Videoscale, audioconvert, videoconvert, audioresample in certain modes.
|
|
|
|
## Modifications in-place - input buffer and output buffer are the same thing.
|
|
|
|
* The element must implement a transform_ip function.
|
|
* Output buffer size must <= input buffer size
|
|
* If the always_in_place flag is set, non-writable buffers will be copied
|
|
and passed to the transform_ip function, otherwise a new buffer will be
|
|
created and the transform function called.
|
|
|
|
* Incoming writable buffers will be passed to the transform_ip function
|
|
immediately.
|
|
* only implementing transform_ip and not transform implies always_in_place = %TRUE
|
|
|
|
* Example elements:
|
|
* Volume
|
|
* Audioconvert in certain modes (signed/unsigned conversion)
|
|
* videoconvert in certain modes (endianness swapping)
|
|
|
|
## Modifications only to the caps/metadata of a buffer
|
|
|
|
* The element does not require writable data, but non-writable buffers
|
|
should be subbuffered so that the meta-information can be replaced.
|
|
|
|
* Elements wishing to operate in this mode should replace the
|
|
prepare_output_buffer method to create subbuffers of the input buffer
|
|
and set always_in_place to %TRUE
|
|
|
|
* Example elements
|
|
* Capsfilter when setting caps on outgoing buffers that have
|
|
none.
|
|
* identity when it is going to re-timestamp buffers by
|
|
datarate.
|
|
|
|
## Normal mode
|
|
* always_in_place flag is not set, or there is no transform_ip function
|
|
* Element will receive an input buffer and output buffer to operate on.
|
|
* Output buffer is allocated by calling the prepare_output_buffer function.
|
|
* Example elements:
|
|
* Videoscale, videoconvert, audioconvert when doing
|
|
scaling/conversions
|
|
|
|
## Special output buffer allocations
|
|
* Elements which need to do special allocation of their output buffers
|
|
beyond allocating output buffers via the negotiated allocator or
|
|
buffer pool should implement the prepare_output_buffer method.
|
|
|
|
* Example elements:
|
|
* efence
|
|
|
|
# Sub-class settable flags on GstBaseTransform
|
|
|
|
* passthrough
|
|
|
|
* Implies that in the current configuration, the sub-class is not interested in modifying the buffers.
|
|
* Elements which are always in passthrough mode whenever the same caps has been negotiated on both pads can set the class variable passthrough_on_same_caps to have this behaviour automatically.
|
|
|
|
* always_in_place
|
|
* Determines whether a non-writable buffer will be copied before passing
|
|
to the transform_ip function.
|
|
|
|
* Implied %TRUE if no transform function is implemented.
|
|
* Implied %FALSE if ONLY transform function is implemented.</doc>
|
|
|
|
<virtual-method name="accept_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="before_transform">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="copy_metadata">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="input" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="decide_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="filter_meta">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
<parameter name="api" transfer-ownership="none">
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="params" transfer-ownership="none">
|
|
<type name="Gst.Structure" c:type="const GstStructure*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="fixate_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="othercaps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="generate_output">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="outbuf" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_unit_size">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="prepare_output_buffer">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="input" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="propose_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="decide_query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="incaps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="outcaps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="sink_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="src_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="submit_input_buffer">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="is_discont" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="input" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="transform">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="inbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="transform_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="filter" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="transform_ip">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="transform_meta">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="outbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="meta" transfer-ownership="none">
|
|
<type name="Gst.Meta" c:type="GstMeta*"/>
|
|
</parameter>
|
|
<parameter name="inbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="transform_size">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="othercaps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="othersize" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_allocator" c:identifier="gst_base_transform_get_allocator">
|
|
<doc xml:space="preserve">Lets #GstBaseTransform sub-classes know the memory @allocator
|
|
used by the base class and its @params.
|
|
|
|
Unref the @allocator after use.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="allocator" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the #GstAllocator
|
|
used</doc>
|
|
<type name="Gst.Allocator" c:type="GstAllocator**"/>
|
|
</parameter>
|
|
<parameter name="params" direction="out" caller-allocates="1" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">the
|
|
#GstAllocationParams of @allocator</doc>
|
|
<type name="Gst.AllocationParams" c:type="GstAllocationParams*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_buffer_pool" c:identifier="gst_base_transform_get_buffer_pool">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the instance of the #GstBufferPool used
|
|
by @trans; free it after use</doc>
|
|
<type name="Gst.BufferPool" c:type="GstBufferPool*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_in_place" c:identifier="gst_base_transform_is_in_place">
|
|
<doc xml:space="preserve">See if @trans is configured as a in_place transform.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the transform is configured in in_place mode.
|
|
|
|
MT safe.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstBaseTransform to query</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_passthrough" c:identifier="gst_base_transform_is_passthrough">
|
|
<doc xml:space="preserve">See if @trans is configured as a passthrough transform.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the transform is configured in passthrough mode.
|
|
|
|
MT safe.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstBaseTransform to query</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_qos_enabled" c:identifier="gst_base_transform_is_qos_enabled">
|
|
<doc xml:space="preserve">Queries if the transform will handle QoS.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if QoS is enabled.
|
|
|
|
MT safe.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reconfigure" c:identifier="gst_base_transform_reconfigure" version="1.18">
|
|
<doc xml:space="preserve">Negotiates src pad caps with downstream elements if the source pad is
|
|
marked as needing reconfiguring. Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in
|
|
any case. But marks it again if negotiation fails.
|
|
|
|
Do not call this in the #GstBaseTransformClass.transform() or
|
|
#GstBaseTransformClass.transform_ip() vmethod. Call this in
|
|
#GstBaseTransformClass.submit_input_buffer(),
|
|
#GstBaseTransformClass.prepare_output_buffer() or in
|
|
#GstBaseTransformClass.generate_output() _before_ any output buffer is
|
|
allocated.
|
|
|
|
It will be default be called when handling an ALLOCATION query or at the
|
|
very beginning of the default #GstBaseTransformClass.submit_input_buffer()
|
|
implementation.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the negotiation succeeded, else %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstBaseTransform to set</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reconfigure_sink" c:identifier="gst_base_transform_reconfigure_sink">
|
|
<doc xml:space="preserve">Instructs @trans to request renegotiation upstream. This function is
|
|
typically called after properties on the transform were set that
|
|
influence the input format.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reconfigure_src" c:identifier="gst_base_transform_reconfigure_src">
|
|
<doc xml:space="preserve">Instructs @trans to renegotiate a new downstream transform on the next
|
|
buffer. This function is typically called after properties on the transform
|
|
were set that influence the output format.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_gap_aware" c:identifier="gst_base_transform_set_gap_aware">
|
|
<doc xml:space="preserve">If @gap_aware is %FALSE (the default), output buffers will have the
|
|
%GST_BUFFER_FLAG_GAP flag unset.
|
|
|
|
If set to %TRUE, the element must handle output buffers with this flag set
|
|
correctly, i.e. it can assume that the buffer contains neutral data but must
|
|
unset the flag if the output is no neutral data.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="gap_aware" transfer-ownership="none">
|
|
<doc xml:space="preserve">New state</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_in_place" c:identifier="gst_base_transform_set_in_place">
|
|
<doc xml:space="preserve">Determines whether a non-writable buffer will be copied before passing
|
|
to the transform_ip function.
|
|
|
|
* Always %TRUE if no transform function is implemented.
|
|
* Always %FALSE if ONLY transform function is implemented.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstBaseTransform to modify</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="in_place" transfer-ownership="none">
|
|
<doc xml:space="preserve">Boolean value indicating that we would like to operate
|
|
on in_place buffers.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_passthrough" c:identifier="gst_base_transform_set_passthrough">
|
|
<doc xml:space="preserve">Set passthrough mode for this filter by default. This is mostly
|
|
useful for filters that do not care about negotiation.
|
|
|
|
Always %TRUE for filters which don't implement either a transform
|
|
or transform_ip or generate_output method.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstBaseTransform to set</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="passthrough" transfer-ownership="none">
|
|
<doc xml:space="preserve">boolean indicating passthrough mode.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_prefer_passthrough" c:identifier="gst_base_transform_set_prefer_passthrough" version="1.0.1">
|
|
<doc xml:space="preserve">If @prefer_passthrough is %TRUE (the default), @trans will check and
|
|
prefer passthrough caps from the list of caps returned by the
|
|
transform_caps vmethod.
|
|
|
|
If set to %FALSE, the element must order the caps returned from the
|
|
transform_caps function in such a way that the preferred format is
|
|
first in the list. This can be interesting for transforms that can do
|
|
passthrough transforms but prefer to do something else, like a
|
|
capsfilter.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="prefer_passthrough" transfer-ownership="none">
|
|
<doc xml:space="preserve">New state</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_qos_enabled" c:identifier="gst_base_transform_set_qos_enabled">
|
|
<doc xml:space="preserve">Enable or disable QoS handling in the transform.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve">new state</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="update_qos" c:identifier="gst_base_transform_update_qos">
|
|
<doc xml:space="preserve">Set the QoS parameters in the transform. This function is called internally
|
|
when a QOS event is received but subclasses can provide custom information
|
|
when needed.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="proportion" transfer-ownership="none">
|
|
<doc xml:space="preserve">the proportion</doc>
|
|
<type name="gdouble" c:type="gdouble"/>
|
|
</parameter>
|
|
<parameter name="diff" transfer-ownership="none">
|
|
<doc xml:space="preserve">the diff against the clock</doc>
|
|
<type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/>
|
|
</parameter>
|
|
<parameter name="timestamp" transfer-ownership="none">
|
|
<doc xml:space="preserve">the timestamp of the buffer generating the QoS expressed in
|
|
running_time.</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="update_src_caps" c:identifier="gst_base_transform_update_src_caps" version="1.6">
|
|
<doc xml:space="preserve">Updates the srcpad caps and sends the caps downstream. This function
|
|
can be used by subclasses when they have already negotiated their caps
|
|
but found a change in them (or computed new information). This way,
|
|
they can notify downstream about that change without losing any
|
|
buffer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the caps could be sent downstream %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="trans" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBaseTransform</doc>
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</instance-parameter>
|
|
<parameter name="updated_caps" transfer-ownership="none">
|
|
<doc xml:space="preserve">An updated version of the srcpad caps to be pushed
|
|
downstream</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="qos" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="element">
|
|
<type name="Gst.Element" c:type="GstElement"/>
|
|
</field>
|
|
<field name="sinkpad">
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</field>
|
|
<field name="srcpad">
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</field>
|
|
<field name="have_segment">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="segment">
|
|
<type name="Gst.Segment" c:type="GstSegment"/>
|
|
</field>
|
|
<field name="queued_buf">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="BaseTransformPrivate" c:type="GstBaseTransformPrivate*"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="19">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</class>
|
|
<record name="BaseTransformClass" c:type="GstBaseTransformClass" glib:is-gtype-struct-for="BaseTransform">
|
|
<doc xml:space="preserve">Subclasses can override any of the available virtual methods or not, as
|
|
needed. At minimum either @transform or @transform_ip need to be overridden.
|
|
If the element can overwrite the input data with the results (data is of the
|
|
same type and quantity) it should provide @transform_ip.</doc>
|
|
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve">Element parent class</doc>
|
|
<type name="Gst.ElementClass" c:type="GstElementClass"/>
|
|
</field>
|
|
<field name="passthrough_on_same_caps">
|
|
<doc xml:space="preserve">If set to %TRUE, passthrough mode will be
|
|
automatically enabled if the caps are the same.
|
|
Set to %FALSE by default.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="transform_ip_on_passthrough">
|
|
<doc xml:space="preserve">If set to %TRUE, @transform_ip will be called in
|
|
passthrough mode. The passed buffer might not be
|
|
writable. When %FALSE, neither @transform nor
|
|
@transform_ip will be called in passthrough mode.
|
|
Set to %TRUE by default.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="transform_caps">
|
|
<callback name="transform_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="filter" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="fixate_caps">
|
|
<callback name="fixate_caps">
|
|
|
|
<return-value transfer-ownership="full">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="othercaps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="accept_caps">
|
|
<callback name="accept_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_caps">
|
|
<callback name="set_caps">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="incaps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="outcaps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query">
|
|
<callback name="query">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="decide_allocation">
|
|
<callback name="decide_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="filter_meta">
|
|
<callback name="filter_meta">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
<parameter name="api" transfer-ownership="none">
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="params" transfer-ownership="none">
|
|
<type name="Gst.Structure" c:type="const GstStructure*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="propose_allocation">
|
|
<callback name="propose_allocation">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="decide_query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="transform_size">
|
|
<callback name="transform_size">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="direction" transfer-ownership="none">
|
|
<type name="Gst.PadDirection" c:type="GstPadDirection"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="othercaps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="othersize" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_unit_size">
|
|
<callback name="get_unit_size">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="caps" transfer-ownership="none">
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="start">
|
|
<callback name="start">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop">
|
|
<callback name="stop">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="sink_event">
|
|
<callback name="sink_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="src_event">
|
|
<callback name="src_event">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="prepare_output_buffer">
|
|
<callback name="prepare_output_buffer">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="input" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="copy_metadata">
|
|
<callback name="copy_metadata">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="input" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="transform_meta">
|
|
<callback name="transform_meta">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="meta" transfer-ownership="none">
|
|
<type name="Gst.Meta" c:type="GstMeta*"/>
|
|
</parameter>
|
|
<parameter name="inbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="before_transform">
|
|
<callback name="before_transform">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="transform">
|
|
<callback name="transform">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="inbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="transform_ip">
|
|
<callback name="transform_ip">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="submit_input_buffer">
|
|
<callback name="submit_input_buffer">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="is_discont" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="input" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="generate_output">
|
|
<callback name="generate_output">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="trans" transfer-ownership="none">
|
|
<type name="BaseTransform" c:type="GstBaseTransform*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="18">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="BaseTransformPrivate" c:type="GstBaseTransformPrivate" disguised="1">
|
|
|
|
</record>
|
|
<record name="BitReader" c:type="GstBitReader">
|
|
<doc xml:space="preserve">#GstBitReader provides a bit reader that can read any number of bits
|
|
from a memory buffer. It provides functions for reading any number of bits
|
|
into 8, 16, 32 and 64 bit variables.</doc>
|
|
|
|
<field name="data" writable="1">
|
|
<doc xml:space="preserve">Data from which the bit reader will
|
|
read</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</field>
|
|
<field name="size" writable="1">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="byte" writable="1">
|
|
<doc xml:space="preserve">Current byte position</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="bit" writable="1">
|
|
<doc xml:space="preserve">Bit position in the current byte</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<method name="free" c:identifier="gst_bit_reader_free">
|
|
<doc xml:space="preserve">Frees a #GstBitReader instance, which was previously allocated by
|
|
gst_bit_reader_new().</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="full">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_bits_uint16" c:identifier="gst_bit_reader_get_bits_uint16">
|
|
<doc xml:space="preserve">Read @nbits bits into @val and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint16 to store the result</doc>
|
|
<type name="guint16" c:type="guint16*"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_bits_uint32" c:identifier="gst_bit_reader_get_bits_uint32">
|
|
<doc xml:space="preserve">Read @nbits bits into @val and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_bits_uint64" c:identifier="gst_bit_reader_get_bits_uint64">
|
|
<doc xml:space="preserve">Read @nbits bits into @val and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint64 to store the result</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_bits_uint8" c:identifier="gst_bit_reader_get_bits_uint8">
|
|
<doc xml:space="preserve">Read @nbits bits into @val and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint8 to store the result</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_pos" c:identifier="gst_bit_reader_get_pos">
|
|
<doc xml:space="preserve">Returns the current position of a #GstBitReader instance in bits.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The current position of @reader in bits.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="const GstBitReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_remaining" c:identifier="gst_bit_reader_get_remaining">
|
|
<doc xml:space="preserve">Returns the remaining number of bits of a #GstBitReader instance.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The remaining number of bits of @reader instance.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="const GstBitReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_size" c:identifier="gst_bit_reader_get_size">
|
|
<doc xml:space="preserve">Returns the total number of bits of a #GstBitReader instance.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The total number of bits of @reader instance.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="const GstBitReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init" c:identifier="gst_bit_reader_init">
|
|
<doc xml:space="preserve">Initializes a #GstBitReader instance to read from @data. This function
|
|
can be called on already initialized instances.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">data from which the bit reader should read</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_bits_uint16" c:identifier="gst_bit_reader_peek_bits_uint16">
|
|
<doc xml:space="preserve">Read @nbits bits into @val but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="const GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint16 to store the result</doc>
|
|
<type name="guint16" c:type="guint16*"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_bits_uint32" c:identifier="gst_bit_reader_peek_bits_uint32">
|
|
<doc xml:space="preserve">Read @nbits bits into @val but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="const GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_bits_uint64" c:identifier="gst_bit_reader_peek_bits_uint64">
|
|
<doc xml:space="preserve">Read @nbits bits into @val but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="const GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint64 to store the result</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_bits_uint8" c:identifier="gst_bit_reader_peek_bits_uint8">
|
|
<doc xml:space="preserve">Read @nbits bits into @val but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="const GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint8 to store the result</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pos" c:identifier="gst_bit_reader_set_pos">
|
|
<doc xml:space="preserve">Sets the new position of a #GstBitReader instance to @pos in bits.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the position could be set successfully, %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="pos" transfer-ownership="none">
|
|
<doc xml:space="preserve">The new position in bits</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip" c:identifier="gst_bit_reader_skip">
|
|
<doc xml:space="preserve">Skips @nbits bits of the #GstBitReader instance.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if @nbits bits could be skipped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bits to skip</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip_to_byte" c:identifier="gst_bit_reader_skip_to_byte">
|
|
<doc xml:space="preserve">Skips until the next byte.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="new" c:identifier="gst_bit_reader_new" introspectable="0">
|
|
<doc xml:space="preserve">Create a new #GstBitReader instance, which will read from @data.
|
|
|
|
Free-function: gst_bit_reader_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Data from which the #GstBitReader
|
|
should read</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<record name="BitWriter" c:type="GstBitWriter" version="1.16">
|
|
<doc xml:space="preserve">#GstBitWriter provides a bit writer that can write any number of
|
|
bits into a memory buffer. It provides functions for writing any
|
|
number of bits into 8, 16, 32 and 64 bit variables.</doc>
|
|
|
|
<field name="data" writable="1">
|
|
<doc xml:space="preserve">Allocated @data for bit writer to write</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</field>
|
|
<field name="bit_size" writable="1">
|
|
<doc xml:space="preserve">Size of written @data in bits</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="bit_capacity" readable="0" private="1">
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="auto_grow" readable="0" private="1">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="owned" readable="0" private="1">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<method name="align_bytes" c:identifier="gst_bit_writer_align_bytes">
|
|
<doc xml:space="preserve">Write trailing bit to align last byte of @data. @trailing_bit can
|
|
only be 1 or 0.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="trailing_bit" transfer-ownership="none">
|
|
<doc xml:space="preserve">trailing bits of last byte, 0 or 1</doc>
|
|
<type name="guint8" c:type="guint8"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="gst_bit_writer_free">
|
|
<doc xml:space="preserve">Frees @bitwriter and the allocated data inside.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="full">
|
|
<doc xml:space="preserve">#GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free_and_get_buffer" c:identifier="gst_bit_writer_free_and_get_buffer">
|
|
<doc xml:space="preserve">Frees @bitwriter without destroying the internal data, which is
|
|
returned as #GstBuffer.
|
|
|
|
Free-function: gst_buffer_unref</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new allocated #GstBuffer wrapping the
|
|
data inside. gst_buffer_unref() after usage.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="full">
|
|
<doc xml:space="preserve">#GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free_and_get_data" c:identifier="gst_bit_writer_free_and_get_data">
|
|
<doc xml:space="preserve">Frees @bitwriter without destroying the internal data, which is
|
|
returned.
|
|
|
|
Free-function: g_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the current data. g_free() after
|
|
usage.</doc>
|
|
<array zero-terminated="0" c:type="guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="full">
|
|
<doc xml:space="preserve">#GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_data" c:identifier="gst_bit_writer_get_data">
|
|
<doc xml:space="preserve">Get written data pointer</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">data pointer</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="const GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_remaining" c:identifier="gst_bit_writer_get_remaining">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<type name="BitWriter" c:type="const GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_size" c:identifier="gst_bit_writer_get_size">
|
|
<doc xml:space="preserve">Get size of written @data</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">size of bits written in @data</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="const GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init" c:identifier="gst_bit_writer_init" introspectable="0">
|
|
<doc xml:space="preserve">Initializes @bitwriter to an empty instance.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init_with_data" c:identifier="gst_bit_writer_init_with_data" introspectable="0">
|
|
<doc xml:space="preserve">Initializes @bitwriter with the given memory area @data. IF
|
|
@initialized is %TRUE it is possible to read @size bits from the
|
|
#GstBitWriter from the beginning.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Memory area for writing</doc>
|
|
<array length="1" zero-terminated="0" c:type="guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="initialized" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the complete data can be read from the beginning</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init_with_size" c:identifier="gst_bit_writer_init_with_size" introspectable="0">
|
|
<doc xml:space="preserve">Initializes a #GstBitWriter instance and allocates the given data
|
|
@size.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">the size on bytes to allocate for data</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="fixed" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the data can't be reallocated</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_bits_uint16" c:identifier="gst_bit_writer_put_bits_uint16">
|
|
<doc xml:space="preserve">Write @nbits bits of @value to #GstBitWriter.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve">value of #guint16 to write</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to write</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_bits_uint32" c:identifier="gst_bit_writer_put_bits_uint32">
|
|
<doc xml:space="preserve">Write @nbits bits of @value to #GstBitWriter.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve">value of #guint32 to write</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to write</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_bits_uint64" c:identifier="gst_bit_writer_put_bits_uint64">
|
|
<doc xml:space="preserve">Write @nbits bits of @value to #GstBitWriter.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve">value of #guint64 to write</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to write</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_bits_uint8" c:identifier="gst_bit_writer_put_bits_uint8">
|
|
<doc xml:space="preserve">Write @nbits bits of @value to #GstBitWriter.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve">value of #guint8 to write</doc>
|
|
<type name="guint8" c:type="guint8"/>
|
|
</parameter>
|
|
<parameter name="nbits" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bits to write</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_bytes" c:identifier="gst_bit_writer_put_bytes">
|
|
<doc xml:space="preserve">Write @nbytes bytes of @data to #GstBitWriter.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">pointer of data to write</doc>
|
|
<type name="guint8" c:type="const guint8*"/>
|
|
</parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bytes to write</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset" c:identifier="gst_bit_writer_reset">
|
|
<doc xml:space="preserve">Resets @bitwriter and frees the data if it's owned by @bitwriter.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset_and_get_buffer" c:identifier="gst_bit_writer_reset_and_get_buffer">
|
|
<doc xml:space="preserve">Resets @bitwriter and returns the current data as #GstBuffer.
|
|
|
|
Free-function: gst_buffer_unref</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new allocated #GstBuffer wrapping the
|
|
current data. gst_buffer_unref() after usage.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset_and_get_data" c:identifier="gst_bit_writer_reset_and_get_data">
|
|
<doc xml:space="preserve">Resets @bitwriter and returns the current data.
|
|
|
|
Free-function: g_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the current data. g_free() after
|
|
usage.</doc>
|
|
<array zero-terminated="0" c:type="guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pos" c:identifier="gst_bit_writer_set_pos">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="bitwriter" transfer-ownership="none">
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="pos" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="new" c:identifier="gst_bit_writer_new" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new, empty #GstBitWriter instance.
|
|
|
|
Free-function: gst_bit_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new, empty #GstByteWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="new_with_data" c:identifier="gst_bit_writer_new_with_data" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new #GstBitWriter instance with the given memory area. If
|
|
@initialized is %TRUE it is possible to read @size bits from the
|
|
#GstBitWriter from the beginning.
|
|
|
|
Free-function: gst_bit_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Memory area for writing</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="initialized" transfer-ownership="none">
|
|
<doc xml:space="preserve">if %TRUE the complete data can be read from the beginning</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_with_size" c:identifier="gst_bit_writer_new_with_size" introspectable="0">
|
|
<doc xml:space="preserve">Creates a #GstBitWriter instance with the given initial data size.
|
|
|
|
Free-function: gst_bit_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of data in bytes</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="fixed" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the data can't be reallocated</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<record name="ByteReader" c:type="GstByteReader">
|
|
<doc xml:space="preserve">#GstByteReader provides a byte reader that can read different integer and
|
|
floating point types from a memory buffer. It provides functions for reading
|
|
signed/unsigned, little/big endian integers of 8, 16, 24, 32 and 64 bits
|
|
and functions for reading little/big endian floating points numbers of
|
|
32 and 64 bits. It also provides functions to read NUL-terminated strings
|
|
in various character encodings.</doc>
|
|
|
|
<field name="data" writable="1">
|
|
<doc xml:space="preserve">Data from which the bit reader will
|
|
read</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</field>
|
|
<field name="size" writable="1">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="byte" writable="1">
|
|
<doc xml:space="preserve">Current byte position</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<method name="dup_data" c:identifier="gst_byte_reader_dup_data">
|
|
<doc xml:space="preserve">Free-function: g_free
|
|
|
|
Returns a newly-allocated copy of the current data
|
|
position if at least @size bytes are left and
|
|
updates the current position. Free with g_free() when no longer needed.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Size in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">address of a
|
|
#guint8 pointer variable in which to store the result</doc>
|
|
<array length="0" zero-terminated="0" c:type="guint8**">
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="dup_string_utf16" c:identifier="gst_byte_reader_dup_string_utf16">
|
|
<doc xml:space="preserve">Free-function: g_free
|
|
|
|
Returns a newly-allocated copy of the current data position if there is
|
|
a NUL-terminated UTF-16 string in the data (this could be an empty string
|
|
as well), and advances the current position.
|
|
|
|
No input checking for valid UTF-16 is done. This function is endianness
|
|
agnostic - you should not assume the UTF-16 characters are in host
|
|
endianness.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.
|
|
|
|
Note: there is no peek or get variant of this function to ensure correct
|
|
byte alignment of the UTF-16 string.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if a string could be read, %FALSE otherwise. The
|
|
string put into @str must be freed with g_free() when no longer needed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="str" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">address of a
|
|
#guint16 pointer variable in which to store the result</doc>
|
|
<array c:type="guint16**">
|
|
<type name="guint16" c:type="guint16*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="dup_string_utf32" c:identifier="gst_byte_reader_dup_string_utf32">
|
|
<doc xml:space="preserve">Free-function: g_free
|
|
|
|
Returns a newly-allocated copy of the current data position if there is
|
|
a NUL-terminated UTF-32 string in the data (this could be an empty string
|
|
as well), and advances the current position.
|
|
|
|
No input checking for valid UTF-32 is done. This function is endianness
|
|
agnostic - you should not assume the UTF-32 characters are in host
|
|
endianness.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.
|
|
|
|
Note: there is no peek or get variant of this function to ensure correct
|
|
byte alignment of the UTF-32 string.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if a string could be read, %FALSE otherwise. The
|
|
string put into @str must be freed with g_free() when no longer needed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="str" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">address of a
|
|
#guint32 pointer variable in which to store the result</doc>
|
|
<array c:type="guint32**">
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="dup_string_utf8" c:identifier="gst_byte_reader_dup_string_utf8">
|
|
<doc xml:space="preserve">Free-function: g_free
|
|
|
|
FIXME:Reads (copies) a NUL-terminated string in the #GstByteReader instance,
|
|
advancing the current position to the byte after the string. This will work
|
|
for any NUL-terminated string with a character width of 8 bits, so ASCII,
|
|
UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if a string could be read into @str, %FALSE otherwise. The
|
|
string put into @str must be freed with g_free() when no longer needed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="str" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">address of a
|
|
#gchar pointer variable in which to store the result</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="gst_byte_reader_free">
|
|
<doc xml:space="preserve">Frees a #GstByteReader instance, which was previously allocated by
|
|
gst_byte_reader_new().</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="full">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_data" c:identifier="gst_byte_reader_get_data">
|
|
<doc xml:space="preserve">Returns a constant pointer to the current data
|
|
position if at least @size bytes are left and
|
|
updates the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Size in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="none">
|
|
<doc xml:space="preserve">address of a
|
|
#guint8 pointer variable in which to store the result</doc>
|
|
<array length="0" zero-terminated="0" c:type="const guint8**">
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_float32_be" c:identifier="gst_byte_reader_get_float32_be">
|
|
<doc xml:space="preserve">Read a 32 bit big endian floating point value into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gfloat to store the result</doc>
|
|
<type name="gfloat" c:type="gfloat*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_float32_le" c:identifier="gst_byte_reader_get_float32_le">
|
|
<doc xml:space="preserve">Read a 32 bit little endian floating point value into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gfloat to store the result</doc>
|
|
<type name="gfloat" c:type="gfloat*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_float64_be" c:identifier="gst_byte_reader_get_float64_be">
|
|
<doc xml:space="preserve">Read a 64 bit big endian floating point value into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gdouble to store the result</doc>
|
|
<type name="gdouble" c:type="gdouble*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_float64_le" c:identifier="gst_byte_reader_get_float64_le">
|
|
<doc xml:space="preserve">Read a 64 bit little endian floating point value into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gdouble to store the result</doc>
|
|
<type name="gdouble" c:type="gdouble*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int16_be" c:identifier="gst_byte_reader_get_int16_be">
|
|
<doc xml:space="preserve">Read a signed 16 bit big endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint16 to store the result</doc>
|
|
<type name="gint16" c:type="gint16*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int16_le" c:identifier="gst_byte_reader_get_int16_le">
|
|
<doc xml:space="preserve">Read a signed 16 bit little endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint16 to store the result</doc>
|
|
<type name="gint16" c:type="gint16*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int24_be" c:identifier="gst_byte_reader_get_int24_be">
|
|
<doc xml:space="preserve">Read a signed 24 bit big endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint32 to store the result</doc>
|
|
<type name="gint32" c:type="gint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int24_le" c:identifier="gst_byte_reader_get_int24_le">
|
|
<doc xml:space="preserve">Read a signed 24 bit little endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint32 to store the result</doc>
|
|
<type name="gint32" c:type="gint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int32_be" c:identifier="gst_byte_reader_get_int32_be">
|
|
<doc xml:space="preserve">Read a signed 32 bit big endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint32 to store the result</doc>
|
|
<type name="gint32" c:type="gint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int32_le" c:identifier="gst_byte_reader_get_int32_le">
|
|
<doc xml:space="preserve">Read a signed 32 bit little endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint32 to store the result</doc>
|
|
<type name="gint32" c:type="gint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int64_be" c:identifier="gst_byte_reader_get_int64_be">
|
|
<doc xml:space="preserve">Read a signed 64 bit big endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint64 to store the result</doc>
|
|
<type name="gint64" c:type="gint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int64_le" c:identifier="gst_byte_reader_get_int64_le">
|
|
<doc xml:space="preserve">Read a signed 64 bit little endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint64 to store the result</doc>
|
|
<type name="gint64" c:type="gint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int8" c:identifier="gst_byte_reader_get_int8">
|
|
<doc xml:space="preserve">Read a signed 8 bit integer into @val and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint8 to store the result</doc>
|
|
<type name="gint8" c:type="gint8*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_pos" c:identifier="gst_byte_reader_get_pos">
|
|
<doc xml:space="preserve">Returns the current position of a #GstByteReader instance in bytes.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The current position of @reader in bytes.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_remaining" c:identifier="gst_byte_reader_get_remaining">
|
|
<doc xml:space="preserve">Returns the remaining number of bytes of a #GstByteReader instance.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The remaining number of bytes of @reader instance.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_size" c:identifier="gst_byte_reader_get_size">
|
|
<doc xml:space="preserve">Returns the total number of bytes of a #GstByteReader instance.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The total number of bytes of @reader instance.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_string_utf8" c:identifier="gst_byte_reader_get_string_utf8">
|
|
<doc xml:space="preserve">Returns a constant pointer to the current data position if there is
|
|
a NUL-terminated string in the data (this could be just a NUL terminator),
|
|
advancing the current position to the byte after the string. This will work
|
|
for any NUL-terminated string with a character width of 8 bits, so ASCII,
|
|
UTF-8, ISO-8859-N etc.
|
|
|
|
No input checking for valid UTF-8 is done.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if a string could be found, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="str" direction="out" caller-allocates="0" transfer-ownership="none">
|
|
<doc xml:space="preserve">address of a
|
|
#gchar pointer variable in which to store the result</doc>
|
|
<array c:type="const gchar**">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_sub_reader" c:identifier="gst_byte_reader_get_sub_reader" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Initializes a #GstByteReader sub-reader instance to contain @size bytes of
|
|
data from the current position of @reader. This is useful to read chunked
|
|
formats and make sure that one doesn't read beyond the size of the sub-chunk.
|
|
|
|
Unlike gst_byte_reader_peek_sub_reader(), this function also modifies the
|
|
position of @reader and moves it forward by @size bytes.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">FALSE on error or if @reader does not contain @size more bytes from
|
|
the current position, and otherwise TRUE</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">an existing and initialized #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="sub_reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance to initialize as sub-reader</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">size of @sub_reader in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint16_be" c:identifier="gst_byte_reader_get_uint16_be">
|
|
<doc xml:space="preserve">Read an unsigned 16 bit big endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint16 to store the result</doc>
|
|
<type name="guint16" c:type="guint16*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint16_le" c:identifier="gst_byte_reader_get_uint16_le">
|
|
<doc xml:space="preserve">Read an unsigned 16 bit little endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint16 to store the result</doc>
|
|
<type name="guint16" c:type="guint16*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint24_be" c:identifier="gst_byte_reader_get_uint24_be">
|
|
<doc xml:space="preserve">Read an unsigned 24 bit big endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint24_le" c:identifier="gst_byte_reader_get_uint24_le">
|
|
<doc xml:space="preserve">Read an unsigned 24 bit little endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint32_be" c:identifier="gst_byte_reader_get_uint32_be">
|
|
<doc xml:space="preserve">Read an unsigned 32 bit big endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint32_le" c:identifier="gst_byte_reader_get_uint32_le">
|
|
<doc xml:space="preserve">Read an unsigned 32 bit little endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint64_be" c:identifier="gst_byte_reader_get_uint64_be">
|
|
<doc xml:space="preserve">Read an unsigned 64 bit big endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint64 to store the result</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint64_le" c:identifier="gst_byte_reader_get_uint64_le">
|
|
<doc xml:space="preserve">Read an unsigned 64 bit little endian integer into @val
|
|
and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint64 to store the result</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint8" c:identifier="gst_byte_reader_get_uint8">
|
|
<doc xml:space="preserve">Read an unsigned 8 bit integer into @val and update the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint8 to store the result</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init" c:identifier="gst_byte_reader_init">
|
|
<doc xml:space="preserve">Initializes a #GstByteReader instance to read from @data. This function
|
|
can be called on already initialized instances.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">data from which
|
|
the #GstByteReader should read</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="masked_scan_uint32" c:identifier="gst_byte_reader_masked_scan_uint32">
|
|
<doc xml:space="preserve">Scan for pattern @pattern with applied mask @mask in the byte reader data,
|
|
starting from offset @offset relative to the current position.
|
|
|
|
The bytes in @pattern and @mask are interpreted left-to-right, regardless
|
|
of endianness. All four bytes of the pattern must be present in the
|
|
byte reader data for it to match, even if the first or last bytes are masked
|
|
out.
|
|
|
|
It is an error to call this function without making sure that there is
|
|
enough data (offset+size bytes) in the byte reader.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">offset of the first match, or -1 if no match was found.
|
|
|
|
Example:
|
|
|[
|
|
// Assume the reader contains 0x00 0x01 0x02 ... 0xfe 0xff
|
|
|
|
gst_byte_reader_masked_scan_uint32 (reader, 0xffffffff, 0x00010203, 0, 256);
|
|
// -> returns 0
|
|
gst_byte_reader_masked_scan_uint32 (reader, 0xffffffff, 0x00010203, 1, 255);
|
|
// -> returns -1
|
|
gst_byte_reader_masked_scan_uint32 (reader, 0xffffffff, 0x01020304, 1, 255);
|
|
// -> returns 1
|
|
gst_byte_reader_masked_scan_uint32 (reader, 0xffff, 0x0001, 0, 256);
|
|
// -> returns -1
|
|
gst_byte_reader_masked_scan_uint32 (reader, 0xffff, 0x0203, 0, 256);
|
|
// -> returns 0
|
|
gst_byte_reader_masked_scan_uint32 (reader, 0xffff0000, 0x02030000, 0, 256);
|
|
// -> returns 2
|
|
gst_byte_reader_masked_scan_uint32 (reader, 0xffff0000, 0x02030000, 0, 4);
|
|
// -> returns -1
|
|
]|</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve">mask to apply to data before matching against @pattern</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="pattern" transfer-ownership="none">
|
|
<doc xml:space="preserve">pattern to match (after mask is applied)</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">offset from which to start scanning, relative to the current
|
|
position</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bytes to scan from offset</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="masked_scan_uint32_peek" c:identifier="gst_byte_reader_masked_scan_uint32_peek" version="1.6">
|
|
<doc xml:space="preserve">Scan for pattern @pattern with applied mask @mask in the byte reader data,
|
|
starting from offset @offset relative to the current position.
|
|
|
|
The bytes in @pattern and @mask are interpreted left-to-right, regardless
|
|
of endianness. All four bytes of the pattern must be present in the
|
|
byte reader data for it to match, even if the first or last bytes are masked
|
|
out.
|
|
|
|
It is an error to call this function without making sure that there is
|
|
enough data (offset+size bytes) in the byte reader.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">offset of the first match, or -1 if no match was found.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve">mask to apply to data before matching against @pattern</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="pattern" transfer-ownership="none">
|
|
<doc xml:space="preserve">pattern to match (after mask is applied)</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">offset from which to start scanning, relative to the current
|
|
position</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">number of bytes to scan from offset</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">pointer to uint32 to return matching data</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_data" c:identifier="gst_byte_reader_peek_data">
|
|
<doc xml:space="preserve">Returns a constant pointer to the current data
|
|
position if at least @size bytes are left and
|
|
keeps the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Size in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="none">
|
|
<doc xml:space="preserve">address of a
|
|
#guint8 pointer variable in which to store the result</doc>
|
|
<array length="0" zero-terminated="0" c:type="const guint8**">
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_float32_be" c:identifier="gst_byte_reader_peek_float32_be">
|
|
<doc xml:space="preserve">Read a 32 bit big endian floating point value into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gfloat to store the result</doc>
|
|
<type name="gfloat" c:type="gfloat*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_float32_le" c:identifier="gst_byte_reader_peek_float32_le">
|
|
<doc xml:space="preserve">Read a 32 bit little endian floating point value into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gfloat to store the result</doc>
|
|
<type name="gfloat" c:type="gfloat*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_float64_be" c:identifier="gst_byte_reader_peek_float64_be">
|
|
<doc xml:space="preserve">Read a 64 bit big endian floating point value into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gdouble to store the result</doc>
|
|
<type name="gdouble" c:type="gdouble*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_float64_le" c:identifier="gst_byte_reader_peek_float64_le">
|
|
<doc xml:space="preserve">Read a 64 bit little endian floating point value into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gdouble to store the result</doc>
|
|
<type name="gdouble" c:type="gdouble*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int16_be" c:identifier="gst_byte_reader_peek_int16_be">
|
|
<doc xml:space="preserve">Read a signed 16 bit big endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint16 to store the result</doc>
|
|
<type name="gint16" c:type="gint16*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int16_le" c:identifier="gst_byte_reader_peek_int16_le">
|
|
<doc xml:space="preserve">Read a signed 16 bit little endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint16 to store the result</doc>
|
|
<type name="gint16" c:type="gint16*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int24_be" c:identifier="gst_byte_reader_peek_int24_be">
|
|
<doc xml:space="preserve">Read a signed 24 bit big endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint32 to store the result</doc>
|
|
<type name="gint32" c:type="gint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int24_le" c:identifier="gst_byte_reader_peek_int24_le">
|
|
<doc xml:space="preserve">Read a signed 24 bit little endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint32 to store the result</doc>
|
|
<type name="gint32" c:type="gint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int32_be" c:identifier="gst_byte_reader_peek_int32_be">
|
|
<doc xml:space="preserve">Read a signed 32 bit big endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint32 to store the result</doc>
|
|
<type name="gint32" c:type="gint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int32_le" c:identifier="gst_byte_reader_peek_int32_le">
|
|
<doc xml:space="preserve">Read a signed 32 bit little endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint32 to store the result</doc>
|
|
<type name="gint32" c:type="gint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int64_be" c:identifier="gst_byte_reader_peek_int64_be">
|
|
<doc xml:space="preserve">Read a signed 64 bit big endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint64 to store the result</doc>
|
|
<type name="gint64" c:type="gint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int64_le" c:identifier="gst_byte_reader_peek_int64_le">
|
|
<doc xml:space="preserve">Read a signed 64 bit little endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint64 to store the result</doc>
|
|
<type name="gint64" c:type="gint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_int8" c:identifier="gst_byte_reader_peek_int8">
|
|
<doc xml:space="preserve">Read a signed 8 bit integer into @val but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #gint8 to store the result</doc>
|
|
<type name="gint8" c:type="gint8*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_string_utf8" c:identifier="gst_byte_reader_peek_string_utf8">
|
|
<doc xml:space="preserve">Returns a constant pointer to the current data position if there is
|
|
a NUL-terminated string in the data (this could be just a NUL terminator).
|
|
The current position will be maintained. This will work for any
|
|
NUL-terminated string with a character width of 8 bits, so ASCII,
|
|
UTF-8, ISO-8859-N etc.
|
|
|
|
No input checking for valid UTF-8 is done.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if a string could be skipped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="str" direction="out" caller-allocates="0" transfer-ownership="none">
|
|
<doc xml:space="preserve">address of a
|
|
#gchar pointer variable in which to store the result</doc>
|
|
<array c:type="const gchar**">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_sub_reader" c:identifier="gst_byte_reader_peek_sub_reader" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Initializes a #GstByteReader sub-reader instance to contain @size bytes of
|
|
data from the current position of @reader. This is useful to read chunked
|
|
formats and make sure that one doesn't read beyond the size of the sub-chunk.
|
|
|
|
Unlike gst_byte_reader_get_sub_reader(), this function does not modify the
|
|
current position of @reader.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">FALSE on error or if @reader does not contain @size more bytes from
|
|
the current position, and otherwise TRUE</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">an existing and initialized #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="sub_reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance to initialize as sub-reader</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">size of @sub_reader in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint16_be" c:identifier="gst_byte_reader_peek_uint16_be">
|
|
<doc xml:space="preserve">Read an unsigned 16 bit big endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint16 to store the result</doc>
|
|
<type name="guint16" c:type="guint16*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint16_le" c:identifier="gst_byte_reader_peek_uint16_le">
|
|
<doc xml:space="preserve">Read an unsigned 16 bit little endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint16 to store the result</doc>
|
|
<type name="guint16" c:type="guint16*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint24_be" c:identifier="gst_byte_reader_peek_uint24_be">
|
|
<doc xml:space="preserve">Read an unsigned 24 bit big endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint24_le" c:identifier="gst_byte_reader_peek_uint24_le">
|
|
<doc xml:space="preserve">Read an unsigned 24 bit little endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint32_be" c:identifier="gst_byte_reader_peek_uint32_be">
|
|
<doc xml:space="preserve">Read an unsigned 32 bit big endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint32_le" c:identifier="gst_byte_reader_peek_uint32_le">
|
|
<doc xml:space="preserve">Read an unsigned 32 bit little endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint32 to store the result</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint64_be" c:identifier="gst_byte_reader_peek_uint64_be">
|
|
<doc xml:space="preserve">Read an unsigned 64 bit big endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint64 to store the result</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint64_le" c:identifier="gst_byte_reader_peek_uint64_le">
|
|
<doc xml:space="preserve">Read an unsigned 64 bit little endian integer into @val
|
|
but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint64 to store the result</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_uint8" c:identifier="gst_byte_reader_peek_uint8">
|
|
<doc xml:space="preserve">Read an unsigned 8 bit integer into @val but keep the current position.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if successful, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="const GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">Pointer to a #guint8 to store the result</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pos" c:identifier="gst_byte_reader_set_pos">
|
|
<doc xml:space="preserve">Sets the new position of a #GstByteReader instance to @pos in bytes.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the position could be set successfully, %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="pos" transfer-ownership="none">
|
|
<doc xml:space="preserve">The new position in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip" c:identifier="gst_byte_reader_skip">
|
|
<doc xml:space="preserve">Skips @nbytes bytes of the #GstByteReader instance.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if @nbytes bytes could be skipped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
<parameter name="nbytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to skip</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip_string_utf16" c:identifier="gst_byte_reader_skip_string_utf16">
|
|
<doc xml:space="preserve">Skips a NUL-terminated UTF-16 string in the #GstByteReader instance,
|
|
advancing the current position to the byte after the string.
|
|
|
|
No input checking for valid UTF-16 is done.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if a string could be skipped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip_string_utf32" c:identifier="gst_byte_reader_skip_string_utf32">
|
|
<doc xml:space="preserve">Skips a NUL-terminated UTF-32 string in the #GstByteReader instance,
|
|
advancing the current position to the byte after the string.
|
|
|
|
No input checking for valid UTF-32 is done.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if a string could be skipped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip_string_utf8" c:identifier="gst_byte_reader_skip_string_utf8">
|
|
<doc xml:space="preserve">Skips a NUL-terminated string in the #GstByteReader instance, advancing
|
|
the current position to the byte after the string. This will work for
|
|
any NUL-terminated string with a character width of 8 bits, so ASCII,
|
|
UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if a string could be skipped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="reader" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="new" c:identifier="gst_byte_reader_new" introspectable="0">
|
|
<doc xml:space="preserve">Create a new #GstByteReader instance, which will read from @data.
|
|
|
|
Free-function: gst_byte_reader_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">data from which the
|
|
#GstByteReader should read</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<record name="ByteWriter" c:type="GstByteWriter">
|
|
<doc xml:space="preserve">#GstByteWriter provides a byte writer and reader that can write/read different
|
|
integer and floating point types to/from a memory buffer. It provides functions
|
|
for writing/reading signed/unsigned, little/big endian integers of 8, 16, 24,
|
|
32 and 64 bits and functions for reading little/big endian floating points numbers of
|
|
32 and 64 bits. It also provides functions to write/read NUL-terminated strings
|
|
in various character encodings.</doc>
|
|
|
|
<field name="parent" writable="1">
|
|
<doc xml:space="preserve">#GstByteReader parent</doc>
|
|
<type name="ByteReader" c:type="GstByteReader"/>
|
|
</field>
|
|
<field name="alloc_size" writable="1">
|
|
<doc xml:space="preserve">Allocation size of the data</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="fixed" writable="1">
|
|
<doc xml:space="preserve">If %TRUE no reallocations are allowed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="owned" writable="1">
|
|
<doc xml:space="preserve">If %FALSE no reallocations are allowed and copies of data are returned</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<method name="ensure_free_space" c:identifier="gst_byte_writer_ensure_free_space">
|
|
<doc xml:space="preserve">Checks if enough free space from the current write cursor is
|
|
available and reallocates if necessary.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if at least @size bytes are still available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Number of bytes that should be available</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="fill" c:identifier="gst_byte_writer_fill">
|
|
<doc xml:space="preserve">Writes @size bytes containing @value to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to be written</doc>
|
|
<type name="guint8" c:type="guint8"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Number of bytes to be written</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="gst_byte_writer_free">
|
|
<doc xml:space="preserve">Frees @writer and all memory allocated by it.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="full">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free_and_get_buffer" c:identifier="gst_byte_writer_free_and_get_buffer">
|
|
<doc xml:space="preserve">Frees @writer and all memory allocated by it except
|
|
the current data, which is returned as #GstBuffer.
|
|
|
|
Free-function: gst_buffer_unref</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the current data as buffer. gst_buffer_unref()
|
|
after usage.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="full">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free_and_get_data" c:identifier="gst_byte_writer_free_and_get_data">
|
|
<doc xml:space="preserve">Frees @writer and all memory allocated by it except
|
|
the current data, which is returned.
|
|
|
|
Free-function: g_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the current data. g_free() after usage.</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="full">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_remaining" c:identifier="gst_byte_writer_get_remaining">
|
|
<doc xml:space="preserve">Returns the remaining size of data that can still be written. If
|
|
-1 is returned the remaining size is only limited by system resources.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the remaining size of data that can still be written</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="const GstByteWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init" c:identifier="gst_byte_writer_init">
|
|
<doc xml:space="preserve">Initializes @writer to an empty instance</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init_with_data" c:identifier="gst_byte_writer_init_with_data">
|
|
<doc xml:space="preserve">Initializes @writer with the given
|
|
memory area. If @initialized is %TRUE it is possible to
|
|
read @size bytes from the #GstByteWriter from the beginning.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Memory area for writing</doc>
|
|
<array length="1" zero-terminated="0" c:type="guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="initialized" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the complete data can be read from the beginning</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init_with_size" c:identifier="gst_byte_writer_init_with_size">
|
|
<doc xml:space="preserve">Initializes @writer with the given initial data size.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of data</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="fixed" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the data can't be reallocated</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_buffer" c:identifier="gst_byte_writer_put_buffer">
|
|
<doc xml:space="preserve">Writes @size bytes of @data to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the data could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve">source #GstBuffer</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">offset to copy from</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">total size to copy. If -1, all data is copied</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_data" c:identifier="gst_byte_writer_put_data">
|
|
<doc xml:space="preserve">Writes @size bytes of @data to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Data to write</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_float32_be" c:identifier="gst_byte_writer_put_float32_be">
|
|
<doc xml:space="preserve">Writes a big endian 32 bit float to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gfloat" c:type="gfloat"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_float32_le" c:identifier="gst_byte_writer_put_float32_le">
|
|
<doc xml:space="preserve">Writes a little endian 32 bit float to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gfloat" c:type="gfloat"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_float64_be" c:identifier="gst_byte_writer_put_float64_be">
|
|
<doc xml:space="preserve">Writes a big endian 64 bit float to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gdouble" c:type="gdouble"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_float64_le" c:identifier="gst_byte_writer_put_float64_le">
|
|
<doc xml:space="preserve">Writes a little endian 64 bit float to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gdouble" c:type="gdouble"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int16_be" c:identifier="gst_byte_writer_put_int16_be">
|
|
<doc xml:space="preserve">Writes a signed big endian 16 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint16" c:type="gint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int16_le" c:identifier="gst_byte_writer_put_int16_le">
|
|
<doc xml:space="preserve">Writes a signed little endian 16 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint16" c:type="gint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int24_be" c:identifier="gst_byte_writer_put_int24_be">
|
|
<doc xml:space="preserve">Writes a signed big endian 24 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int24_le" c:identifier="gst_byte_writer_put_int24_le">
|
|
<doc xml:space="preserve">Writes a signed little endian 24 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int32_be" c:identifier="gst_byte_writer_put_int32_be">
|
|
<doc xml:space="preserve">Writes a signed big endian 32 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int32_le" c:identifier="gst_byte_writer_put_int32_le">
|
|
<doc xml:space="preserve">Writes a signed little endian 32 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int64_be" c:identifier="gst_byte_writer_put_int64_be">
|
|
<doc xml:space="preserve">Writes a signed big endian 64 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int64_le" c:identifier="gst_byte_writer_put_int64_le">
|
|
<doc xml:space="preserve">Writes a signed little endian 64 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int8" c:identifier="gst_byte_writer_put_int8">
|
|
<doc xml:space="preserve">Writes a signed 8 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="gint8" c:type="gint8"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_string_utf16" c:identifier="gst_byte_writer_put_string_utf16">
|
|
<doc xml:space="preserve">Writes a NUL-terminated UTF16 string to @writer (including the terminator).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">UTF16 string to write</doc>
|
|
<array c:type="const guint16*">
|
|
<type name="guint16" c:type="guint16"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_string_utf32" c:identifier="gst_byte_writer_put_string_utf32">
|
|
<doc xml:space="preserve">Writes a NUL-terminated UTF32 string to @writer (including the terminator).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">UTF32 string to write</doc>
|
|
<array c:type="const guint32*">
|
|
<type name="guint32" c:type="guint32"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_string_utf8" c:identifier="gst_byte_writer_put_string_utf8">
|
|
<doc xml:space="preserve">Writes a NUL-terminated UTF8 string to @writer (including the terminator).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">UTF8 string to write</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint16_be" c:identifier="gst_byte_writer_put_uint16_be">
|
|
<doc xml:space="preserve">Writes a unsigned big endian 16 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint16_le" c:identifier="gst_byte_writer_put_uint16_le">
|
|
<doc xml:space="preserve">Writes a unsigned little endian 16 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint24_be" c:identifier="gst_byte_writer_put_uint24_be">
|
|
<doc xml:space="preserve">Writes a unsigned big endian 24 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint24_le" c:identifier="gst_byte_writer_put_uint24_le">
|
|
<doc xml:space="preserve">Writes a unsigned little endian 24 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint32_be" c:identifier="gst_byte_writer_put_uint32_be">
|
|
<doc xml:space="preserve">Writes a unsigned big endian 32 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint32_le" c:identifier="gst_byte_writer_put_uint32_le">
|
|
<doc xml:space="preserve">Writes a unsigned little endian 32 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint64_be" c:identifier="gst_byte_writer_put_uint64_be">
|
|
<doc xml:space="preserve">Writes a unsigned big endian 64 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint64_le" c:identifier="gst_byte_writer_put_uint64_le">
|
|
<doc xml:space="preserve">Writes a unsigned little endian 64 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint8" c:identifier="gst_byte_writer_put_uint8">
|
|
<doc xml:space="preserve">Writes a unsigned 8 bit integer to @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the value could be written</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
<parameter name="val" transfer-ownership="none">
|
|
<doc xml:space="preserve">Value to write</doc>
|
|
<type name="guint8" c:type="guint8"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset" c:identifier="gst_byte_writer_reset">
|
|
<doc xml:space="preserve">Resets @writer and frees the data if it's
|
|
owned by @writer.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset_and_get_buffer" c:identifier="gst_byte_writer_reset_and_get_buffer">
|
|
<doc xml:space="preserve">Resets @writer and returns the current data as buffer.
|
|
|
|
Free-function: gst_buffer_unref</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the current data as buffer. gst_buffer_unref()
|
|
after usage.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset_and_get_data" c:identifier="gst_byte_writer_reset_and_get_data">
|
|
<doc xml:space="preserve">Resets @writer and returns the current data.
|
|
|
|
Free-function: g_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the current data. g_free() after
|
|
usage.</doc>
|
|
<array zero-terminated="0" c:type="guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="writer" transfer-ownership="none">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="new" c:identifier="gst_byte_writer_new" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new, empty #GstByteWriter instance
|
|
|
|
Free-function: gst_byte_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new, empty #GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="new_with_data" c:identifier="gst_byte_writer_new_with_data" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new #GstByteWriter instance with the given
|
|
memory area. If @initialized is %TRUE it is possible to
|
|
read @size bytes from the #GstByteWriter from the beginning.
|
|
|
|
Free-function: gst_byte_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Memory area for writing</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="initialized" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the complete data can be read from the beginning</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_with_size" c:identifier="gst_byte_writer_new_with_size" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new #GstByteWriter instance with the given
|
|
initial data size.
|
|
|
|
Free-function: gst_byte_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of data</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="fixed" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the data can't be reallocated</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<function-macro name="COLLECT_PADS" c:identifier="GST_COLLECT_PADS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_CLASS" c:identifier="GST_COLLECT_PADS_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_DTS" c:identifier="GST_COLLECT_PADS_DTS" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Returns the DTS that has been converted to running time when using
|
|
gst_collect_pads_clip_running_time(). Unlike the value saved into
|
|
the buffer, this value is of type gint64 and may be negative. This allow
|
|
properly handling streams with frame reordering where the first DTS may
|
|
be negative. If the initial DTS was not set, this value will be
|
|
set to %G_MININT64.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">A #GstCollectData.</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_DTS_IS_VALID" c:identifier="GST_COLLECT_PADS_DTS_IS_VALID" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Check if running DTS value store is valid.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">A #GstCollectData.</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_GET_CLASS" c:identifier="GST_COLLECT_PADS_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_GET_STREAM_LOCK" c:identifier="GST_COLLECT_PADS_GET_STREAM_LOCK" introspectable="0">
|
|
<doc xml:space="preserve">Get the stream lock of @pads. The stream lock is used to coordinate and
|
|
serialize execution among the various streams being collected, and in
|
|
protecting the resources used to accomplish this.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="pads">
|
|
<doc xml:space="preserve">a #GstCollectPads</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_STATE" c:identifier="GST_COLLECT_PADS_STATE" introspectable="0">
|
|
<doc xml:space="preserve">A flags word containing #GstCollectPadsStateFlags flags set
|
|
on this collected pad.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">a #GstCollectData.</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_STATE_IS_SET" c:identifier="GST_COLLECT_PADS_STATE_IS_SET" introspectable="0">
|
|
<doc xml:space="preserve">Gives the status of a specific flag on a collected pad.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">a #GstCollectData.</doc>
|
|
</parameter>
|
|
<parameter name="flag">
|
|
<doc xml:space="preserve">the #GstCollectPadsStateFlags to check.</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_STATE_SET" c:identifier="GST_COLLECT_PADS_STATE_SET" introspectable="0">
|
|
<doc xml:space="preserve">Sets a state flag on a collected pad.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">a #GstCollectData.</doc>
|
|
</parameter>
|
|
<parameter name="flag">
|
|
<doc xml:space="preserve">the #GstCollectPadsStateFlags to set.</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_STATE_UNSET" c:identifier="GST_COLLECT_PADS_STATE_UNSET" introspectable="0">
|
|
<doc xml:space="preserve">Clears a state flag on a collected pad.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">a #GstCollectData.</doc>
|
|
</parameter>
|
|
<parameter name="flag">
|
|
<doc xml:space="preserve">the #GstCollectPadsStateFlags to clear.</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_STREAM_LOCK" c:identifier="GST_COLLECT_PADS_STREAM_LOCK" introspectable="0">
|
|
<doc xml:space="preserve">Lock the stream lock of @pads.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="pads">
|
|
<doc xml:space="preserve">a #GstCollectPads</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="COLLECT_PADS_STREAM_UNLOCK" c:identifier="GST_COLLECT_PADS_STREAM_UNLOCK" introspectable="0">
|
|
<doc xml:space="preserve">Unlock the stream lock of @pads.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="pads">
|
|
<doc xml:space="preserve">a #GstCollectPads</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<record name="CollectData" c:type="GstCollectData">
|
|
<doc xml:space="preserve">Structure used by the collect_pads.</doc>
|
|
|
|
<field name="collect" writable="1">
|
|
<doc xml:space="preserve">owner #GstCollectPads</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</field>
|
|
<field name="pad" writable="1">
|
|
<doc xml:space="preserve">#GstPad managed by this data</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</field>
|
|
<field name="buffer" writable="1">
|
|
<doc xml:space="preserve">currently queued buffer.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</field>
|
|
<field name="pos" writable="1">
|
|
<doc xml:space="preserve">position in the buffer</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="segment" writable="1">
|
|
<doc xml:space="preserve">last segment received.</doc>
|
|
<type name="Gst.Segment" c:type="GstSegment"/>
|
|
</field>
|
|
<field name="state" readable="0" private="1">
|
|
<type name="CollectPadsStateFlags" c:type="GstCollectPadsStateFlags"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="CollectDataPrivate" c:type="GstCollectDataPrivate*"/>
|
|
</field>
|
|
<union name="ABI" c:type="ABI">
|
|
|
|
<record name="abi" c:type="abi">
|
|
|
|
<field name="dts" writable="1">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</field>
|
|
</record>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</union>
|
|
</record>
|
|
<callback name="CollectDataDestroyNotify" c:type="GstCollectDataDestroyNotify">
|
|
<doc xml:space="preserve">A function that will be called when the #GstCollectData will be freed.
|
|
It is passed the pointer to the structure and should free any custom
|
|
memory and resources allocated for it.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstCollectData that will be freed</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="CollectDataPrivate" c:type="GstCollectDataPrivate" disguised="1">
|
|
|
|
</record>
|
|
<class name="CollectPads" c:symbol-prefix="collect_pads" c:type="GstCollectPads" parent="Gst.Object" glib:type-name="GstCollectPads" glib:get-type="gst_collect_pads_get_type" glib:type-struct="CollectPadsClass">
|
|
<doc xml:space="preserve">Manages a set of pads that operate in collect mode. This means that control
|
|
is given to the manager of this object when all pads have data.
|
|
|
|
* Collectpads are created with gst_collect_pads_new(). A callback should then
|
|
be installed with gst_collect_pads_set_function ().
|
|
|
|
* Pads are added to the collection with gst_collect_pads_add_pad()/
|
|
gst_collect_pads_remove_pad(). The pad has to be a sinkpad. When added,
|
|
the chain, event and query functions of the pad are overridden. The
|
|
element_private of the pad is used to store private information for the
|
|
collectpads.
|
|
|
|
* For each pad, data is queued in the _chain function or by
|
|
performing a pull_range.
|
|
|
|
* When data is queued on all pads in waiting mode, the callback function is called.
|
|
|
|
* Data can be dequeued from the pad with the gst_collect_pads_pop() method.
|
|
One can peek at the data with the gst_collect_pads_peek() function.
|
|
These functions will return %NULL if the pad received an EOS event. When all
|
|
pads return %NULL from a gst_collect_pads_peek(), the element can emit an EOS
|
|
event itself.
|
|
|
|
* Data can also be dequeued in byte units using the gst_collect_pads_available(),
|
|
gst_collect_pads_read_buffer() and gst_collect_pads_flush() calls.
|
|
|
|
* Elements should call gst_collect_pads_start() and gst_collect_pads_stop() in
|
|
their state change functions to start and stop the processing of the collectpads.
|
|
The gst_collect_pads_stop() call should be called before calling the parent
|
|
element state change function in the PAUSED_TO_READY state change to ensure
|
|
no pad is blocked and the element can finish streaming.
|
|
|
|
* gst_collect_pads_set_waiting() sets a pad to waiting or non-waiting mode.
|
|
CollectPads element is not waiting for data to be collected on non-waiting pads.
|
|
Thus these pads may but need not have data when the callback is called.
|
|
All pads are in waiting mode by default.</doc>
|
|
|
|
<constructor name="new" c:identifier="gst_collect_pads_new">
|
|
<doc xml:space="preserve">Create a new instance of #GstCollectPads.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstCollectPads, or %NULL in case of an error.</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="add_pad" c:identifier="gst_collect_pads_add_pad">
|
|
<doc xml:space="preserve">Add a pad to the collection of collect pads. The pad has to be
|
|
a sinkpad. The refcount of the pad is incremented. Use
|
|
gst_collect_pads_remove_pad() to remove the pad from the collection
|
|
again.
|
|
|
|
You specify a size for the returned #GstCollectData structure
|
|
so that you can use it to store additional information.
|
|
|
|
You can also specify a #GstCollectDataDestroyNotify that will be called
|
|
just before the #GstCollectData structure is freed. It is passed the
|
|
pointer to the structure and should free any custom memory and resources
|
|
allocated for it.
|
|
|
|
Keeping a pad locked in waiting state is only relevant when using
|
|
the default collection algorithm (providing the oldest buffer).
|
|
It ensures a buffer must be available on this pad for a collection
|
|
to take place. This is of typical use to a muxer element where
|
|
non-subtitle streams should always be in waiting state,
|
|
e.g. to assure that caps information is available on all these streams
|
|
when initial headers have to be written.
|
|
|
|
The pad will be automatically activated in push mode when @pads is
|
|
started.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">a new #GstCollectData to identify the
|
|
new pad. Or %NULL if wrong parameters are supplied.</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the pad to add</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">the size of the returned #GstCollectData structure</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="destroy_notify" transfer-ownership="none" scope="async">
|
|
<doc xml:space="preserve">function to be called before the returned
|
|
#GstCollectData structure is freed</doc>
|
|
<type name="CollectDataDestroyNotify" c:type="GstCollectDataDestroyNotify"/>
|
|
</parameter>
|
|
<parameter name="lock" transfer-ownership="none">
|
|
<doc xml:space="preserve">whether to lock this pad in usual waiting state</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="available" c:identifier="gst_collect_pads_available">
|
|
<doc xml:space="preserve">Query how much bytes can be read from each queued buffer. This means
|
|
that the result of this call is the maximum number of bytes that can
|
|
be read from each of the pads.
|
|
|
|
This function should be called with @pads STREAM_LOCK held, such as
|
|
in the callback.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The maximum number of bytes queued on all pads. This function
|
|
returns 0 if a pad has no queued buffer.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to query</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="clip_running_time" c:identifier="gst_collect_pads_clip_running_time">
|
|
<doc xml:space="preserve">Convenience clipping function that converts incoming buffer's timestamp
|
|
to running time, or clips the buffer if outside configured segment.
|
|
|
|
Since 1.6, this clipping function also sets the DTS parameter of the
|
|
GstCollectData structure. This version of the running time DTS can be
|
|
negative. G_MININT64 is used to indicate invalid value.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="cdata" transfer-ownership="none">
|
|
<doc xml:space="preserve">collect data of corresponding pad</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<doc xml:space="preserve">buffer being clipped</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="outbuf" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">output buffer with running time, or NULL if clipped</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">user data (unused)</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="event_default" c:identifier="gst_collect_pads_event_default">
|
|
<doc xml:space="preserve">Default #GstCollectPads event handling that elements should always
|
|
chain up to to ensure proper operation. Element might however indicate
|
|
event should not be forwarded downstream.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">collect data of corresponding pad</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<doc xml:space="preserve">event being processed</doc>
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
<parameter name="discard" transfer-ownership="none">
|
|
<doc xml:space="preserve">process but do not send event downstream</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush" c:identifier="gst_collect_pads_flush">
|
|
<doc xml:space="preserve">Flush @size bytes from the pad @data.
|
|
|
|
This function should be called with @pads STREAM_LOCK held, such as
|
|
in the callback.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The number of bytes flushed This can be less than @size and
|
|
is 0 if the pad was end-of-stream.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to query</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">the data to use</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to flush</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek" c:identifier="gst_collect_pads_peek">
|
|
<doc xml:space="preserve">Peek at the buffer currently queued in @data. This function
|
|
should be called with the @pads STREAM_LOCK held, such as in the callback
|
|
handler.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">The buffer in @data or %NULL if no
|
|
buffer is queued. should unref the buffer after usage.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to peek</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">the data to use</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pop" c:identifier="gst_collect_pads_pop">
|
|
<doc xml:space="preserve">Pop the buffer currently queued in @data. This function
|
|
should be called with the @pads STREAM_LOCK held, such as in the callback
|
|
handler.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">The buffer in @data or %NULL if no
|
|
buffer was queued. You should unref the buffer after usage.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to pop</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">the data to use</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_default" c:identifier="gst_collect_pads_query_default">
|
|
<doc xml:space="preserve">Default #GstCollectPads query handling that elements should always
|
|
chain up to to ensure proper operation. Element might however indicate
|
|
query should not be forwarded downstream.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">collect data of corresponding pad</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<doc xml:space="preserve">query being processed</doc>
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
<parameter name="discard" transfer-ownership="none">
|
|
<doc xml:space="preserve">process but do not send event downstream</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_buffer" c:identifier="gst_collect_pads_read_buffer">
|
|
<doc xml:space="preserve">Get a subbuffer of @size bytes from the given pad @data.
|
|
|
|
This function should be called with @pads STREAM_LOCK held, such as in the
|
|
callback.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">A sub buffer. The size of the buffer can
|
|
be less that requested. A return of %NULL signals that the pad is
|
|
end-of-stream. Unref the buffer after use.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to query</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">the data to use</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_pad" c:identifier="gst_collect_pads_remove_pad">
|
|
<doc xml:space="preserve">Remove a pad from the collection of collect pads. This function will also
|
|
free the #GstCollectData and all the resources that were allocated with
|
|
gst_collect_pads_add_pad().
|
|
|
|
The pad will be deactivated automatically when @pads is stopped.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the pad could be removed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the pad to remove</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_buffer_function" c:identifier="gst_collect_pads_set_buffer_function">
|
|
<doc xml:space="preserve">Set the callback function and user data that will be called with
|
|
the oldest buffer when all pads have been collected, or %NULL on EOS.
|
|
If a buffer is passed, the callback owns a reference and must unref
|
|
it.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="call" closure="1">
|
|
<doc xml:space="preserve">the function to set</doc>
|
|
<type name="CollectPadsBufferFunction" c:type="GstCollectPadsBufferFunction"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">user data passed to the function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_clip_function" c:identifier="gst_collect_pads_set_clip_function">
|
|
<doc xml:space="preserve">Install a clipping function that is called right after a buffer is received
|
|
on a pad managed by @pads. See #GstCollectPadsClipFunction for more info.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="clipfunc" transfer-ownership="none" scope="call" closure="1">
|
|
<doc xml:space="preserve">clip function to install</doc>
|
|
<type name="CollectPadsClipFunction" c:type="GstCollectPadsClipFunction"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">user data to pass to @clip_func</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_compare_function" c:identifier="gst_collect_pads_set_compare_function">
|
|
<doc xml:space="preserve">Set the timestamp comparison function.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the pads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="call" closure="1">
|
|
<doc xml:space="preserve">the function to set</doc>
|
|
<type name="CollectPadsCompareFunction" c:type="GstCollectPadsCompareFunction"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">user data passed to the function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_event_function" c:identifier="gst_collect_pads_set_event_function">
|
|
<doc xml:space="preserve">Set the event callback function and user data that will be called when
|
|
collectpads has received an event originating from one of the collected
|
|
pads. If the event being processed is a serialized one, this callback is
|
|
called with @pads STREAM_LOCK held, otherwise not. As this lock should be
|
|
held when calling a number of CollectPads functions, it should be acquired
|
|
if so (unusually) needed.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="call" closure="1">
|
|
<doc xml:space="preserve">the function to set</doc>
|
|
<type name="CollectPadsEventFunction" c:type="GstCollectPadsEventFunction"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">user data passed to the function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flush_function" c:identifier="gst_collect_pads_set_flush_function" version="1.4">
|
|
<doc xml:space="preserve">Install a flush function that is called when the internal
|
|
state of all pads should be flushed as part of flushing seek
|
|
handling. See #GstCollectPadsFlushFunction for more info.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="call" closure="1">
|
|
<doc xml:space="preserve">flush function to install</doc>
|
|
<type name="CollectPadsFlushFunction" c:type="GstCollectPadsFlushFunction"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">user data to pass to @func</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flushing" c:identifier="gst_collect_pads_set_flushing">
|
|
<doc xml:space="preserve">Change the flushing state of all the pads in the collection. No pad
|
|
is able to accept anymore data when @flushing is %TRUE. Calling this
|
|
function with @flushing %FALSE makes @pads accept data again.
|
|
Caller must ensure that downstream streaming (thread) is not blocked,
|
|
e.g. by sending a FLUSH_START downstream.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="flushing" transfer-ownership="none">
|
|
<doc xml:space="preserve">desired state of the pads</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_function" c:identifier="gst_collect_pads_set_function">
|
|
<doc xml:space="preserve">CollectPads provides a default collection algorithm that will determine
|
|
the oldest buffer available on all of its pads, and then delegate
|
|
to a configured callback.
|
|
However, if circumstances are more complicated and/or more control
|
|
is desired, this sets a callback that will be invoked instead when
|
|
all the pads added to the collection have buffers queued.
|
|
Evidently, this callback is not compatible with
|
|
gst_collect_pads_set_buffer_function() callback.
|
|
If this callback is set, the former will be unset.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="call" closure="1">
|
|
<doc xml:space="preserve">the function to set</doc>
|
|
<type name="CollectPadsFunction" c:type="GstCollectPadsFunction"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">user data passed to the function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_query_function" c:identifier="gst_collect_pads_set_query_function">
|
|
<doc xml:space="preserve">Set the query callback function and user data that will be called after
|
|
collectpads has received a query originating from one of the collected
|
|
pads. If the query being processed is a serialized one, this callback is
|
|
called with @pads STREAM_LOCK held, otherwise not. As this lock should be
|
|
held when calling a number of CollectPads functions, it should be acquired
|
|
if so (unusually) needed.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="call" closure="1">
|
|
<doc xml:space="preserve">the function to set</doc>
|
|
<type name="CollectPadsQueryFunction" c:type="GstCollectPadsQueryFunction"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">user data passed to the function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_waiting" c:identifier="gst_collect_pads_set_waiting">
|
|
<doc xml:space="preserve">Sets a pad to waiting or non-waiting mode, if at least this pad
|
|
has not been created with locked waiting state,
|
|
in which case nothing happens.
|
|
|
|
This function should be called with @pads STREAM_LOCK held, such as
|
|
in the callback.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">the data to use</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="waiting" transfer-ownership="none">
|
|
<doc xml:space="preserve">boolean indicating whether this pad should operate
|
|
in waiting or non-waiting mode</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="src_event_default" c:identifier="gst_collect_pads_src_event_default" version="1.4">
|
|
<doc xml:space="preserve">Default #GstCollectPads event handling for the src pad of elements.
|
|
Elements can chain up to this to let flushing seek event handling
|
|
be done by #GstCollectPads.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstCollectPads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">src #GstPad that received the event</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<doc xml:space="preserve">event being processed</doc>
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start" c:identifier="gst_collect_pads_start">
|
|
<doc xml:space="preserve">Starts the processing of data in the collect_pads.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="stop" c:identifier="gst_collect_pads_stop">
|
|
<doc xml:space="preserve">Stops the processing of data in the collect_pads. this function
|
|
will also unblock any blocking operations.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to use</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_buffer" c:identifier="gst_collect_pads_take_buffer">
|
|
<doc xml:space="preserve">Get a subbuffer of @size bytes from the given pad @data. Flushes the amount
|
|
of read bytes.
|
|
|
|
This function should be called with @pads STREAM_LOCK held, such as in the
|
|
callback.
|
|
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">A sub buffer. The size of the buffer can
|
|
be less that requested. A return of %NULL signals that the pad is
|
|
end-of-stream. Unref the buffer after use.</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the collectpads to query</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">the data to use</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">the number of bytes to read</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="object">
|
|
<type name="Gst.Object" c:type="GstObject"/>
|
|
</field>
|
|
<field name="data">
|
|
<doc xml:space="preserve">#GList of #GstCollectData managed
|
|
by this #GstCollectPads.</doc>
|
|
<type name="GLib.SList" c:type="GSList*">
|
|
<type name="CollectData"/>
|
|
</type>
|
|
</field>
|
|
<field name="stream_lock" readable="0" private="1">
|
|
<type name="GLib.RecMutex" c:type="GRecMutex"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="CollectPadsPrivate" c:type="GstCollectPadsPrivate*"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</class>
|
|
<callback name="CollectPadsBufferFunction" c:type="GstCollectPadsBufferFunction">
|
|
<doc xml:space="preserve">A function that will be called when a (considered oldest) buffer can be muxed.
|
|
If all pads have reached EOS, this function is called with %NULL @buffer
|
|
and %NULL @data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%GST_FLOW_OK for success</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstCollectPads that triggered the callback</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstCollectData of pad that has received the buffer</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="full">
|
|
<doc xml:space="preserve">the #GstBuffer</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve">user data passed to gst_collect_pads_set_buffer_function()</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="CollectPadsClass" c:type="GstCollectPadsClass" glib:is-gtype-struct-for="CollectPads">
|
|
|
|
<field name="parent_class">
|
|
<type name="Gst.ObjectClass" c:type="GstObjectClass"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<callback name="CollectPadsClipFunction" c:type="GstCollectPadsClipFunction">
|
|
<doc xml:space="preserve">A function that will be called when @inbuffer is received on the pad managed
|
|
by @data in the collectpad object @pads.
|
|
|
|
The function should use the segment of @data and the negotiated media type on
|
|
the pad to perform clipping of @inbuffer.
|
|
|
|
This function takes ownership of @inbuffer and should output a buffer in
|
|
@outbuffer or return %NULL in @outbuffer if the buffer should be dropped.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstFlowReturn that corresponds to the result of clipping.</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstCollectPads</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstCollectData</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="inbuffer" transfer-ownership="full">
|
|
<doc xml:space="preserve">the input #GstBuffer</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="outbuffer" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">the output #GstBuffer</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve">user data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="CollectPadsCompareFunction" c:type="GstCollectPadsCompareFunction">
|
|
<doc xml:space="preserve">A function for comparing two timestamps of buffers or newsegments collected on one pad.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">Integer less than zero when first timestamp is deemed older than the second one.
|
|
Zero if the timestamps are deemed equally old.
|
|
Integer greater than zero when second timestamp is deemed older than the first one.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstCollectPads that is comparing the timestamps</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</parameter>
|
|
<parameter name="data1" transfer-ownership="none">
|
|
<doc xml:space="preserve">the first #GstCollectData</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="timestamp1" transfer-ownership="none">
|
|
<doc xml:space="preserve">the first timestamp</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
<parameter name="data2" transfer-ownership="none">
|
|
<doc xml:space="preserve">the second #GstCollectData</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="timestamp2" transfer-ownership="none">
|
|
<doc xml:space="preserve">the second timestamp</doc>
|
|
<type name="Gst.ClockTime" c:type="GstClockTime"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve">user data passed to gst_collect_pads_set_compare_function()</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="CollectPadsEventFunction" c:type="GstCollectPadsEventFunction">
|
|
<doc xml:space="preserve">A function that will be called while processing an event. It takes
|
|
ownership of the event and is responsible for chaining up (to
|
|
gst_collect_pads_event_default()) or dropping events (such typical cases
|
|
being handled by the default handler).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the pad could handle the event</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstCollectPads that triggered the callback</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstPad that received an event</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstEvent received</doc>
|
|
<type name="Gst.Event" c:type="GstEvent*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve">user data passed to gst_collect_pads_set_event_function()</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="CollectPadsFlushFunction" c:type="GstCollectPadsFlushFunction" version="1.4">
|
|
<doc xml:space="preserve">A function that will be called while processing a flushing seek event.
|
|
|
|
The function should flush any internal state of the element and the state of
|
|
all the pads. It should clear only the state not directly managed by the
|
|
@pads object. It is therefore not necessary to call
|
|
gst_collect_pads_set_flushing nor gst_collect_pads_clear from this function.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstCollectPads</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
|
|
<doc xml:space="preserve">user data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="CollectPadsFunction" c:type="GstCollectPadsFunction">
|
|
<doc xml:space="preserve">A function that will be called when all pads have received data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%GST_FLOW_OK for success</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstCollectPads that triggered the callback</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
|
|
<doc xml:space="preserve">user data passed to gst_collect_pads_set_function()</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="CollectPadsPrivate" c:type="GstCollectPadsPrivate" disguised="1">
|
|
|
|
</record>
|
|
<callback name="CollectPadsQueryFunction" c:type="GstCollectPadsQueryFunction">
|
|
<doc xml:space="preserve">A function that will be called while processing a query. It takes
|
|
ownership of the query and is responsible for chaining up (to
|
|
events downstream (with gst_pad_event_default()).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the pad could handle the event</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pads" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstCollectPads that triggered the callback</doc>
|
|
<type name="CollectPads" c:type="GstCollectPads*"/>
|
|
</parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstPad that received an event</doc>
|
|
<type name="CollectData" c:type="GstCollectData*"/>
|
|
</parameter>
|
|
<parameter name="query" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstEvent received</doc>
|
|
<type name="Gst.Query" c:type="GstQuery*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve">user data passed to gst_collect_pads_set_query_function()</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<bitfield name="CollectPadsStateFlags" c:type="GstCollectPadsStateFlags">
|
|
|
|
<member name="eos" value="1" c:identifier="GST_COLLECT_PADS_STATE_EOS">
|
|
<doc xml:space="preserve">Set if collectdata's pad is EOS.</doc>
|
|
</member>
|
|
<member name="flushing" value="2" c:identifier="GST_COLLECT_PADS_STATE_FLUSHING">
|
|
<doc xml:space="preserve">Set if collectdata's pad is flushing.</doc>
|
|
</member>
|
|
<member name="new_segment" value="4" c:identifier="GST_COLLECT_PADS_STATE_NEW_SEGMENT">
|
|
<doc xml:space="preserve">Set if collectdata's pad received a
|
|
new_segment event.</doc>
|
|
</member>
|
|
<member name="waiting" value="8" c:identifier="GST_COLLECT_PADS_STATE_WAITING">
|
|
<doc xml:space="preserve">Set if collectdata's pad must be waited
|
|
for when collecting.</doc>
|
|
</member>
|
|
<member name="locked" value="16" c:identifier="GST_COLLECT_PADS_STATE_LOCKED">
|
|
<doc xml:space="preserve">Set collectdata's pad WAITING state must
|
|
not be changed.
|
|
#GstCollectPadsStateFlags indicate private state of a collectdata('s pad).</doc>
|
|
</member>
|
|
</bitfield>
|
|
<function-macro name="DATA_QUEUE" c:identifier="GST_DATA_QUEUE" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DATA_QUEUE_CLASS" c:identifier="GST_DATA_QUEUE_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="DataQueue" c:symbol-prefix="data_queue" c:type="GstDataQueue" parent="GObject.Object" glib:type-name="GstDataQueue" glib:get-type="gst_data_queue_get_type" glib:type-struct="DataQueueClass">
|
|
<doc xml:space="preserve">#GstDataQueue is an object that handles threadsafe queueing of objects. It
|
|
also provides size-related functionality. This object should be used for
|
|
any #GstElement that wishes to provide some sort of queueing functionality.</doc>
|
|
|
|
<constructor name="new" c:identifier="gst_data_queue_new" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new #GstDataQueue. If @fullcallback or @emptycallback are supplied, then
|
|
the #GstDataQueue will call the respective callback to signal full or empty condition.
|
|
If the callbacks are NULL the #GstDataQueue will instead emit 'full' and 'empty'
|
|
signals.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="checkfull" transfer-ownership="none">
|
|
<doc xml:space="preserve">the callback used to tell if the element considers the queue full
|
|
or not.</doc>
|
|
<type name="DataQueueCheckFullFunction" c:type="GstDataQueueCheckFullFunction"/>
|
|
</parameter>
|
|
<parameter name="fullcallback" transfer-ownership="none">
|
|
<doc xml:space="preserve">the callback which will be called when the queue is considered full.</doc>
|
|
<type name="DataQueueFullCallback" c:type="GstDataQueueFullCallback"/>
|
|
</parameter>
|
|
<parameter name="emptycallback" transfer-ownership="none" closure="3">
|
|
<doc xml:space="preserve">the callback which will be called when the queue is considered empty.</doc>
|
|
<type name="DataQueueEmptyCallback" c:type="GstDataQueueEmptyCallback"/>
|
|
</parameter>
|
|
<parameter name="checkdata" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">a #gpointer that will be passed to the @checkfull, @fullcallback,
|
|
and @emptycallback callbacks.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<virtual-method name="empty">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="full">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="drop_head" c:identifier="gst_data_queue_drop_head" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Pop and unref the head-most #GstMiniObject with the given #GType.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if an element was removed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GstDataQueue to drop an item from.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GType of the item to drop.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush" c:identifier="gst_data_queue_flush" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Flushes all the contents of the @queue. Any call to #gst_data_queue_push and
|
|
#gst_data_queue_pop will be released.
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_level" c:identifier="gst_data_queue_get_level" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Get the current level of the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GstDataQueue</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
<parameter name="level" direction="out" caller-allocates="1" transfer-ownership="none">
|
|
<doc xml:space="preserve">the location to store the result</doc>
|
|
<type name="DataQueueSize" c:type="GstDataQueueSize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_empty" c:identifier="gst_data_queue_is_empty" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Queries if there are any items in the @queue.
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if @queue is empty.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_full" c:identifier="gst_data_queue_is_full" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Queries if @queue is full. This check will be done using the
|
|
#GstDataQueueCheckFullFunction registered with @queue.
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if @queue is full.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="limits_changed" c:identifier="gst_data_queue_limits_changed" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Inform the queue that the limits for the fullness check have changed and that
|
|
any blocking gst_data_queue_push() should be unblocked to recheck the limits.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">The #GstDataQueue</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek" c:identifier="gst_data_queue_peek" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Retrieves the first @item available on the @queue without removing it.
|
|
If the queue is currently empty, the call will block until at least
|
|
one item is available, OR the @queue is set to the flushing state.
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if an @item was successfully retrieved from the @queue.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
<parameter name="item" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">pointer to store the returned #GstDataQueueItem.</doc>
|
|
<type name="DataQueueItem" c:type="GstDataQueueItem**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pop" c:identifier="gst_data_queue_pop" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Retrieves the first @item available on the @queue. If the queue is currently
|
|
empty, the call will block until at least one item is available, OR the
|
|
@queue is set to the flushing state.
|
|
MT safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if an @item was successfully retrieved from the @queue.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
<parameter name="item" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">pointer to store the returned #GstDataQueueItem.</doc>
|
|
<type name="DataQueueItem" c:type="GstDataQueueItem**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="push" c:identifier="gst_data_queue_push" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Pushes a #GstDataQueueItem (or a structure that begins with the same fields)
|
|
on the @queue. If the @queue is full, the call will block until space is
|
|
available, OR the @queue is set to flushing state.
|
|
MT safe.
|
|
|
|
Note that this function has slightly different semantics than gst_pad_push()
|
|
and gst_pad_push_event(): this function only takes ownership of @item and
|
|
the #GstMiniObject contained in @item if the push was successful. If %FALSE
|
|
is returned, the caller is responsible for freeing @item and its contents.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the @item was successfully pushed on the @queue.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
<parameter name="item" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueueItem.</doc>
|
|
<type name="DataQueueItem" c:type="GstDataQueueItem*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="push_force" c:identifier="gst_data_queue_push_force" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Pushes a #GstDataQueueItem (or a structure that begins with the same fields)
|
|
on the @queue. It ignores if the @queue is full or not and forces the @item
|
|
to be pushed anyway.
|
|
MT safe.
|
|
|
|
Note that this function has slightly different semantics than gst_pad_push()
|
|
and gst_pad_push_event(): this function only takes ownership of @item and
|
|
the #GstMiniObject contained in @item if the push was successful. If %FALSE
|
|
is returned, the caller is responsible for freeing @item and its contents.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the @item was successfully pushed on the @queue.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
<parameter name="item" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueueItem.</doc>
|
|
<type name="DataQueueItem" c:type="GstDataQueueItem*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flushing" c:identifier="gst_data_queue_set_flushing" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Sets the queue to flushing state if @flushing is %TRUE. If set to flushing
|
|
state, any incoming data on the @queue will be discarded. Any call currently
|
|
blocking on #gst_data_queue_push or #gst_data_queue_pop will return straight
|
|
away with a return value of %FALSE. While the @queue is in flushing state,
|
|
all calls to those two functions will return %FALSE.
|
|
|
|
MT Safe.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</instance-parameter>
|
|
<parameter name="flushing" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #gboolean stating if the queue will be flushing or not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="current-level-bytes" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="current-level-time" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</property>
|
|
<property name="current-level-visible" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<field name="object">
|
|
<doc xml:space="preserve">the parent structure</doc>
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DataQueuePrivate" c:type="GstDataQueuePrivate*"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<glib:signal name="empty" when="first" introspectable="0">
|
|
<doc xml:space="preserve">Reports that the queue became empty (empty).
|
|
A queue is empty if the total amount of visible items inside it (num-visible, time,
|
|
size) is lower than the boundary values which can be set through the GObject
|
|
properties.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="full" when="first" introspectable="0">
|
|
<doc xml:space="preserve">Reports that the queue became full (full).
|
|
A queue is full if the total amount of data inside it (num-visible, time,
|
|
size) is higher than the boundary values which can be set through the GObject
|
|
properties.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</class>
|
|
<callback name="DataQueueCheckFullFunction" c:type="GstDataQueueCheckFullFunction" introspectable="0">
|
|
<doc xml:space="preserve">The prototype of the function used to inform the queue that it should be
|
|
considered as full.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the queue should be considered full.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="queue" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstDataQueue.</doc>
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</parameter>
|
|
<parameter name="visible" transfer-ownership="none">
|
|
<doc xml:space="preserve">The number of visible items currently in the queue.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve">The amount of bytes currently in the queue.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="time" transfer-ownership="none">
|
|
<doc xml:space="preserve">The accumulated duration of the items currently in the queue.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="checkdata" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">The #gpointer registered when the #GstDataQueue was created.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="DataQueueClass" c:type="GstDataQueueClass" glib:is-gtype-struct-for="DataQueue">
|
|
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="empty">
|
|
<callback name="empty">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="queue" transfer-ownership="none">
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="full">
|
|
<callback name="full">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="queue" transfer-ownership="none">
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_gst_reserved">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<callback name="DataQueueEmptyCallback" c:type="GstDataQueueEmptyCallback">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="queue" transfer-ownership="none">
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</parameter>
|
|
<parameter name="checkdata" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="DataQueueFullCallback" c:type="GstDataQueueFullCallback">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="queue" transfer-ownership="none">
|
|
<type name="DataQueue" c:type="GstDataQueue*"/>
|
|
</parameter>
|
|
<parameter name="checkdata" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="DataQueueItem" c:type="GstDataQueueItem" introspectable="0">
|
|
<doc xml:space="preserve">Structure used by #GstDataQueue. You can supply a different structure, as
|
|
long as the top of the structure is identical to this structure.</doc>
|
|
|
|
<field name="object" writable="1">
|
|
<doc xml:space="preserve">the #GstMiniObject to queue.</doc>
|
|
<type name="Gst.MiniObject" c:type="GstMiniObject*"/>
|
|
</field>
|
|
<field name="size" writable="1">
|
|
<doc xml:space="preserve">the size in bytes of the miniobject.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="duration" writable="1">
|
|
<doc xml:space="preserve">the duration in #GstClockTime of the miniobject. Can not be
|
|
%GST_CLOCK_TIME_NONE.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</field>
|
|
<field name="visible" writable="1">
|
|
<doc xml:space="preserve">%TRUE if @object should be considered as a visible object.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="destroy" writable="1">
|
|
<doc xml:space="preserve">The #GDestroyNotify function to use to free the #GstDataQueueItem.
|
|
This function should also drop the reference to @object the owner of the
|
|
#GstDataQueueItem is assumed to hold.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="DataQueuePrivate" c:type="GstDataQueuePrivate" disguised="1">
|
|
|
|
</record>
|
|
<record name="DataQueueSize" c:type="GstDataQueueSize" introspectable="0">
|
|
<doc xml:space="preserve">Structure describing the size of a queue.</doc>
|
|
|
|
<field name="visible" writable="1">
|
|
<doc xml:space="preserve">number of buffers</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="bytes" writable="1">
|
|
<doc xml:space="preserve">number of bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="time" writable="1">
|
|
<doc xml:space="preserve">amount of time</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</field>
|
|
</record>
|
|
<record name="FlowCombiner" c:type="GstFlowCombiner" version="1.4" glib:type-name="GstFlowCombiner" glib:get-type="gst_flow_combiner_get_type" c:symbol-prefix="flow_combiner">
|
|
<doc xml:space="preserve">Utility struct to help handling #GstFlowReturn combination. Useful for
|
|
#GstElement<!-- -->s that have multiple source pads and need to combine
|
|
the different #GstFlowReturn for those pads.
|
|
|
|
#GstFlowCombiner works by using the last #GstFlowReturn for all #GstPad
|
|
it has in its list and computes the combined return value and provides
|
|
it to the caller.
|
|
|
|
To add a new pad to the #GstFlowCombiner use gst_flow_combiner_add_pad().
|
|
The new #GstPad is stored with a default value of %GST_FLOW_OK.
|
|
|
|
In case you want a #GstPad to be removed, use gst_flow_combiner_remove_pad().
|
|
|
|
Please be aware that this struct isn't thread safe as its designed to be
|
|
used by demuxers, those usually will have a single thread operating it.
|
|
|
|
These functions will take refs on the passed #GstPad<!-- -->s.
|
|
|
|
Aside from reducing the user's code size, the main advantage of using this
|
|
helper struct is to follow the standard rules for #GstFlowReturn combination.
|
|
These rules are:
|
|
|
|
* %GST_FLOW_EOS: only if all returns are EOS too
|
|
* %GST_FLOW_NOT_LINKED: only if all returns are NOT_LINKED too
|
|
* %GST_FLOW_ERROR or below: if at least one returns an error return
|
|
* %GST_FLOW_NOT_NEGOTIATED: if at least one returns a not-negotiated return
|
|
* %GST_FLOW_FLUSHING: if at least one returns flushing
|
|
* %GST_FLOW_OK: otherwise
|
|
|
|
%GST_FLOW_ERROR or below, GST_FLOW_NOT_NEGOTIATED and GST_FLOW_FLUSHING are
|
|
returned immediately from the gst_flow_combiner_update_flow() function.</doc>
|
|
|
|
<constructor name="new" c:identifier="gst_flow_combiner_new" version="1.4">
|
|
<doc xml:space="preserve">Creates a new #GstFlowCombiner, use gst_flow_combiner_free() to free it.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">A new #GstFlowCombiner</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="add_pad" c:identifier="gst_flow_combiner_add_pad" version="1.4">
|
|
<doc xml:space="preserve">Adds a new #GstPad to the #GstFlowCombiner.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstPad that is being added</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="clear" c:identifier="gst_flow_combiner_clear" version="1.6">
|
|
<doc xml:space="preserve">Removes all pads from a #GstFlowCombiner and resets it to its initial state.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner to clear</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="gst_flow_combiner_free" version="1.4">
|
|
<doc xml:space="preserve">Frees a #GstFlowCombiner struct and all its internal data.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner to free</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="gst_flow_combiner_ref" version="1.12.1">
|
|
<doc xml:space="preserve">Increments the reference count on the #GstFlowCombiner.</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">the #GstFlowCombiner.</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner to add a reference to.</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_pad" c:identifier="gst_flow_combiner_remove_pad" version="1.4">
|
|
<doc xml:space="preserve">Removes a #GstPad from the #GstFlowCombiner.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstPad to remove</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset" c:identifier="gst_flow_combiner_reset" version="1.6">
|
|
<doc xml:space="preserve">Reset flow combiner and all pads to their initial state without removing pads.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner to clear</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="gst_flow_combiner_unref" version="1.12.1">
|
|
<doc xml:space="preserve">Decrements the reference count on the #GstFlowCombiner.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner to unreference.</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="update_flow" c:identifier="gst_flow_combiner_update_flow" version="1.4">
|
|
<doc xml:space="preserve">Computes the combined flow return for the pads in it.
|
|
|
|
The #GstFlowReturn parameter should be the last flow return update for a pad
|
|
in this #GstFlowCombiner. It will use this value to be able to shortcut some
|
|
combinations and avoid looking over all pads again. e.g. The last combined
|
|
return is the same as the latest obtained #GstFlowReturn.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The combined #GstFlowReturn</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
<parameter name="fret" transfer-ownership="none">
|
|
<doc xml:space="preserve">the latest #GstFlowReturn received for a pad in this #GstFlowCombiner</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="update_pad_flow" c:identifier="gst_flow_combiner_update_pad_flow" version="1.6">
|
|
<doc xml:space="preserve">Sets the provided pad's last flow return to provided value and computes
|
|
the combined flow return for the pads in it.
|
|
|
|
The #GstFlowReturn parameter should be the last flow return update for a pad
|
|
in this #GstFlowCombiner. It will use this value to be able to shortcut some
|
|
combinations and avoid looking over all pads again. e.g. The last combined
|
|
return is the same as the latest obtained #GstFlowReturn.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">The combined #GstFlowReturn</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="combiner" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstFlowCombiner</doc>
|
|
<type name="FlowCombiner" c:type="GstFlowCombiner*"/>
|
|
</instance-parameter>
|
|
<parameter name="pad" transfer-ownership="none">
|
|
<doc xml:space="preserve">the #GstPad whose #GstFlowReturn to update</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</parameter>
|
|
<parameter name="fret" transfer-ownership="none">
|
|
<doc xml:space="preserve">the latest #GstFlowReturn received for a pad in this #GstFlowCombiner</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<function-macro name="IS_ADAPTER" c:identifier="GST_IS_ADAPTER" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ADAPTER_CLASS" c:identifier="GST_IS_ADAPTER_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_AGGREGATOR" c:identifier="GST_IS_AGGREGATOR" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_AGGREGATOR_CLASS" c:identifier="GST_IS_AGGREGATOR_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_AGGREGATOR_PAD" c:identifier="GST_IS_AGGREGATOR_PAD" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_AGGREGATOR_PAD_CLASS" c:identifier="GST_IS_AGGREGATOR_PAD_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BASE_PARSE" c:identifier="GST_IS_BASE_PARSE" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BASE_PARSE_CLASS" c:identifier="GST_IS_BASE_PARSE_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BASE_SINK" c:identifier="GST_IS_BASE_SINK" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BASE_SINK_CLASS" c:identifier="GST_IS_BASE_SINK_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BASE_SRC" c:identifier="GST_IS_BASE_SRC" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BASE_SRC_CLASS" c:identifier="GST_IS_BASE_SRC_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BASE_TRANSFORM" c:identifier="GST_IS_BASE_TRANSFORM" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BASE_TRANSFORM_CLASS" c:identifier="GST_IS_BASE_TRANSFORM_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_COLLECT_PADS" c:identifier="GST_IS_COLLECT_PADS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_COLLECT_PADS_CLASS" c:identifier="GST_IS_COLLECT_PADS_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DATA_QUEUE" c:identifier="GST_IS_DATA_QUEUE" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DATA_QUEUE_CLASS" c:identifier="GST_IS_DATA_QUEUE_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PUSH_SRC" c:identifier="GST_IS_PUSH_SRC" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PUSH_SRC_CLASS" c:identifier="GST_IS_PUSH_SRC_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PUSH_SRC" c:identifier="GST_PUSH_SRC" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PUSH_SRC_CLASS" c:identifier="GST_PUSH_SRC_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="klass">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PUSH_SRC_GET_CLASS" c:identifier="GST_PUSH_SRC_GET_CLASS" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="PushSrc" c:symbol-prefix="push_src" c:type="GstPushSrc" parent="BaseSrc" glib:type-name="GstPushSrc" glib:get-type="gst_push_src_get_type" glib:type-struct="PushSrcClass">
|
|
<doc xml:space="preserve">This class is mostly useful for elements that cannot do
|
|
random access, or at least very slowly. The source usually
|
|
prefers to push out a fixed size buffer.
|
|
|
|
Subclasses usually operate in a format that is different from the
|
|
default GST_FORMAT_BYTES format of #GstBaseSrc.
|
|
|
|
Classes extending this base class will usually be scheduled
|
|
in a push based mode. If the peer accepts to operate without
|
|
offsets and within the limits of the allowed block size, this
|
|
class can operate in getrange based mode automatically. To make
|
|
this possible, the subclass should implement and override the
|
|
SCHEDULING query.
|
|
|
|
The subclass should extend the methods from the baseclass in
|
|
addition to the ::create method.
|
|
|
|
Seeking, flushing, scheduling and sync is all handled by this
|
|
base class.</doc>
|
|
|
|
<virtual-method name="alloc">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="PushSrc" c:type="GstPushSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="PushSrc" c:type="GstPushSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="fill">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src" transfer-ownership="none">
|
|
<type name="PushSrc" c:type="GstPushSrc*"/>
|
|
</instance-parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<field name="parent">
|
|
<type name="BaseSrc" c:type="GstBaseSrc"/>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</class>
|
|
<record name="PushSrcClass" c:type="GstPushSrcClass" glib:is-gtype-struct-for="PushSrc">
|
|
<doc xml:space="preserve">Subclasses can override any of the available virtual methods or not, as
|
|
needed. At the minimum, the @fill method should be overridden to produce
|
|
buffers.</doc>
|
|
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve">Element parent class</doc>
|
|
<type name="BaseSrcClass" c:type="GstBaseSrcClass"/>
|
|
</field>
|
|
<field name="create">
|
|
<callback name="create">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="PushSrc" c:type="GstPushSrc*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="alloc">
|
|
<callback name="alloc">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="PushSrc" c:type="GstPushSrc*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="fill">
|
|
<callback name="fill">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<type name="PushSrc" c:type="GstPushSrc*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_gst_reserved" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="QueueArray" c:type="GstQueueArray" disguised="1" introspectable="0">
|
|
<doc xml:space="preserve">#GstQueueArray is an object that provides standard queue functionality
|
|
based on an array instead of linked lists. This reduces the overhead
|
|
caused by memory management by a large factor.</doc>
|
|
|
|
<method name="clear" c:identifier="gst_queue_array_clear" version="1.16" introspectable="0">
|
|
<doc xml:space="preserve">Clears queue @array and frees all memory associated to it.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="drop_element" c:identifier="gst_queue_array_drop_element" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Drops the queue element at position @idx from queue @array.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">the dropped element</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
<parameter name="idx" transfer-ownership="none">
|
|
<doc xml:space="preserve">index to drop</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="drop_struct" c:identifier="gst_queue_array_drop_struct" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Drops the queue element at position @idx from queue @array and copies the
|
|
data of the element or structure that was removed into @p_struct if
|
|
@p_struct is set (not NULL).</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">TRUE on success, or FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
<parameter name="idx" transfer-ownership="none">
|
|
<doc xml:space="preserve">index to drop</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="p_struct" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">address into which to store the data of the dropped structure, or NULL</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="find" c:identifier="gst_queue_array_find" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Finds an element in the queue @array, either by comparing every element
|
|
with @func or by looking up @data if no compare function @func is provided,
|
|
and returning the index of the found element.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">Index of the found element or -1 if nothing was found.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
|
|
<doc xml:space="preserve">comparison function, or %NULL to find @data by value</doc>
|
|
<type name="GLib.CompareFunc" c:type="GCompareFunc"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">data for comparison function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="gst_queue_array_free" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Frees queue @array and all memory associated to it.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_length" c:identifier="gst_queue_array_get_length" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Returns the length of the queue @array</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the length of the queue @array.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_empty" c:identifier="gst_queue_array_is_empty" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Checks if the queue @array is empty.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">%TRUE if the queue @array is empty</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_head" c:identifier="gst_queue_array_peek_head" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Returns the head of the queue @array and does not
|
|
remove it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">The head of the queue</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_head_struct" c:identifier="gst_queue_array_peek_head_struct" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Returns the head of the queue @array without removing it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">pointer to element or struct, or NULL if @array was empty. The
|
|
data pointed to by the returned pointer stays valid only as long as
|
|
the queue array is not modified further!</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_nth" c:identifier="gst_queue_array_peek_nth" version="1.16" introspectable="0">
|
|
<doc xml:space="preserve">Returns the item at @idx in @array, but does not remove it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">The item, or %NULL if @idx was out of bounds</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
<parameter name="idx" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_nth_struct" c:identifier="gst_queue_array_peek_nth_struct" version="1.16" introspectable="0">
|
|
<doc xml:space="preserve">Returns the item at @idx in @array, but does not remove it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">The item, or %NULL if @idx was out of bounds</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
<parameter name="idx" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_tail" c:identifier="gst_queue_array_peek_tail" version="1.14" introspectable="0">
|
|
<doc xml:space="preserve">Returns the tail of the queue @array, but does not remove it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">The tail of the queue</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_tail_struct" c:identifier="gst_queue_array_peek_tail_struct" version="1.14" introspectable="0">
|
|
<doc xml:space="preserve">Returns the tail of the queue @array, but does not remove it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">The tail of the queue</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pop_head" c:identifier="gst_queue_array_pop_head" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Returns and head of the queue @array and removes
|
|
it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">The head of the queue</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pop_head_struct" c:identifier="gst_queue_array_pop_head_struct" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Returns the head of the queue @array and removes it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">pointer to element or struct, or NULL if @array was empty. The
|
|
data pointed to by the returned pointer stays valid only as long as
|
|
the queue array is not modified further!</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pop_tail" c:identifier="gst_queue_array_pop_tail" version="1.14" introspectable="0">
|
|
<doc xml:space="preserve">Returns the tail of the queue @array and removes
|
|
it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">The tail of the queue</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pop_tail_struct" c:identifier="gst_queue_array_pop_tail_struct" version="1.14" introspectable="0">
|
|
<doc xml:space="preserve">Returns the tail of the queue @array and removes
|
|
it from the queue.</doc>
|
|
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve">The tail of the queue</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="push_tail" c:identifier="gst_queue_array_push_tail" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Pushes @data to the tail of the queue @array.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">object to push</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="push_tail_struct" c:identifier="gst_queue_array_push_tail_struct">
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
<parameter name="p_struct" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_clear_func" c:identifier="gst_queue_array_set_clear_func" version="1.16" introspectable="0">
|
|
<doc xml:space="preserve">Sets a function to clear an element of @array.
|
|
|
|
The @clear_func will be called when an element in the array
|
|
data segment is removed and when the array is freed and data
|
|
segment is deallocated as well. @clear_func will be passed a
|
|
pointer to the element to clear, rather than the element itself.
|
|
|
|
Note that in contrast with other uses of #GDestroyNotify
|
|
functions, @clear_func is expected to clear the contents of
|
|
the array element it is given, but not free the element itself.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="array" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</instance-parameter>
|
|
<parameter name="clear_func" transfer-ownership="none" scope="async">
|
|
<doc xml:space="preserve">a function to clear an element of @array</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="new" c:identifier="gst_queue_array_new" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Allocates a new #GstQueueArray object with an initial
|
|
queue size of @initial_size.</doc>
|
|
|
|
<return-value>
|
|
<doc xml:space="preserve">a new #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="initial_size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of the new queue</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_struct" c:identifier="gst_queue_array_new_for_struct" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Allocates a new #GstQueueArray object for elements (e.g. structures)
|
|
of size @struct_size, with an initial queue size of @initial_size.</doc>
|
|
|
|
<return-value>
|
|
<doc xml:space="preserve">a new #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="struct_size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of each element (e.g. structure) in the array</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="initial_size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of the new queue</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<callback name="TypeFindHelperGetRangeFunction" c:type="GstTypeFindHelperGetRangeFunction">
|
|
<doc xml:space="preserve">This function will be called by gst_type_find_helper_get_range() when
|
|
typefinding functions request to peek at the data of a stream at certain
|
|
offsets. If this function returns GST_FLOW_OK, the result buffer will be
|
|
stored in @buffer. The contents of @buffer is invalid for any other
|
|
return value.
|
|
|
|
This function is supposed to behave exactly like a #GstPadGetRangeFunction.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">GST_FLOW_OK for success</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="obj" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstObject that will handle the getrange request</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="parent" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">the parent of @obj or %NULL</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve">the offset of the range</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve">the length of the range</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="buffer" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">a memory location to hold the result buffer</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<function name="bit_reader_new" c:identifier="gst_bit_reader_new" moved-to="BitReader.new" introspectable="0">
|
|
<doc xml:space="preserve">Create a new #GstBitReader instance, which will read from @data.
|
|
|
|
Free-function: gst_bit_reader_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstBitReader instance</doc>
|
|
<type name="BitReader" c:type="GstBitReader*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Data from which the #GstBitReader
|
|
should read</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bit_writer_new" c:identifier="gst_bit_writer_new" moved-to="BitWriter.new" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new, empty #GstBitWriter instance.
|
|
|
|
Free-function: gst_bit_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new, empty #GstByteWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="bit_writer_new_with_data" c:identifier="gst_bit_writer_new_with_data" moved-to="BitWriter.new_with_data" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new #GstBitWriter instance with the given memory area. If
|
|
@initialized is %TRUE it is possible to read @size bits from the
|
|
#GstBitWriter from the beginning.
|
|
|
|
Free-function: gst_bit_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Memory area for writing</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="initialized" transfer-ownership="none">
|
|
<doc xml:space="preserve">if %TRUE the complete data can be read from the beginning</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bit_writer_new_with_size" c:identifier="gst_bit_writer_new_with_size" moved-to="BitWriter.new_with_size" introspectable="0">
|
|
<doc xml:space="preserve">Creates a #GstBitWriter instance with the given initial data size.
|
|
|
|
Free-function: gst_bit_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstBitWriter instance</doc>
|
|
<type name="BitWriter" c:type="GstBitWriter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of data in bytes</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="fixed" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the data can't be reallocated</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function-macro name="byte_reader_dup_string" c:identifier="gst_byte_reader_dup_string" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="reader">
|
|
</parameter>
|
|
<parameter name="str">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="byte_reader_get_string" c:identifier="gst_byte_reader_get_string" introspectable="0">
|
|
|
|
<parameters>
|
|
<parameter name="reader">
|
|
</parameter>
|
|
<parameter name="str">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function name="byte_reader_new" c:identifier="gst_byte_reader_new" moved-to="ByteReader.new" introspectable="0">
|
|
<doc xml:space="preserve">Create a new #GstByteReader instance, which will read from @data.
|
|
|
|
Free-function: gst_byte_reader_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstByteReader instance</doc>
|
|
<type name="ByteReader" c:type="GstByteReader*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">data from which the
|
|
#GstByteReader should read</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function-macro name="byte_reader_peek_string" c:identifier="gst_byte_reader_peek_string" introspectable="0">
|
|
<doc xml:space="preserve">Returns a constant pointer to the current data position if there is
|
|
a NUL-terminated string in the data (this could be just a NUL terminator).
|
|
The current position will be maintained. This will work for any
|
|
NUL-terminated string with a character width of 8 bits, so ASCII,
|
|
UTF-8, ISO-8859-N etc.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="reader">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
</parameter>
|
|
<parameter name="str">
|
|
<doc xml:space="preserve">address of a
|
|
#gchar pointer variable in which to store the result</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="byte_reader_skip_string" c:identifier="gst_byte_reader_skip_string" introspectable="0">
|
|
<doc xml:space="preserve">Skips a NUL-terminated string in the #GstByteReader instance, advancing
|
|
the current position to the byte after the string. This will work for
|
|
any NUL-terminated string with a character width of 8 bits, so ASCII,
|
|
UTF-8, ISO-8859-N etc.
|
|
|
|
This function will fail if no NUL-terminator was found in in the data.</doc>
|
|
|
|
<parameters>
|
|
<parameter name="reader">
|
|
<doc xml:space="preserve">a #GstByteReader instance</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function name="byte_writer_new" c:identifier="gst_byte_writer_new" moved-to="ByteWriter.new" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new, empty #GstByteWriter instance
|
|
|
|
Free-function: gst_byte_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new, empty #GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="byte_writer_new_with_data" c:identifier="gst_byte_writer_new_with_data" moved-to="ByteWriter.new_with_data" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new #GstByteWriter instance with the given
|
|
memory area. If @initialized is %TRUE it is possible to
|
|
read @size bytes from the #GstByteWriter from the beginning.
|
|
|
|
Free-function: gst_byte_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">Memory area for writing</doc>
|
|
<type name="guint8" c:type="guint8*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of @data in bytes</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="initialized" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the complete data can be read from the beginning</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="byte_writer_new_with_size" c:identifier="gst_byte_writer_new_with_size" moved-to="ByteWriter.new_with_size" introspectable="0">
|
|
<doc xml:space="preserve">Creates a new #GstByteWriter instance with the given
|
|
initial data size.
|
|
|
|
Free-function: gst_byte_writer_free</doc>
|
|
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve">a new #GstByteWriter instance</doc>
|
|
<type name="ByteWriter" c:type="GstByteWriter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of data</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="fixed" transfer-ownership="none">
|
|
<doc xml:space="preserve">If %TRUE the data can't be reallocated</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function-macro name="byte_writer_put_string" c:identifier="gst_byte_writer_put_string" introspectable="0">
|
|
<doc xml:space="preserve">Write a NUL-terminated string to @writer (including the terminator). The
|
|
string is assumed to be in an 8-bit encoding (e.g. ASCII,UTF-8 or
|
|
ISO-8859-1).</doc>
|
|
|
|
<parameters>
|
|
<parameter name="writer">
|
|
<doc xml:space="preserve">#GstByteWriter instance</doc>
|
|
</parameter>
|
|
<parameter name="data">
|
|
<doc xml:space="preserve">Null terminated string</doc>
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function name="queue_array_new" c:identifier="gst_queue_array_new" moved-to="QueueArray.new" version="1.2" introspectable="0">
|
|
<doc xml:space="preserve">Allocates a new #GstQueueArray object with an initial
|
|
queue size of @initial_size.</doc>
|
|
|
|
<return-value>
|
|
<doc xml:space="preserve">a new #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="initial_size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of the new queue</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="queue_array_new_for_struct" c:identifier="gst_queue_array_new_for_struct" moved-to="QueueArray.new_for_struct" version="1.6" introspectable="0">
|
|
<doc xml:space="preserve">Allocates a new #GstQueueArray object for elements (e.g. structures)
|
|
of size @struct_size, with an initial queue size of @initial_size.</doc>
|
|
|
|
<return-value>
|
|
<doc xml:space="preserve">a new #GstQueueArray object</doc>
|
|
<type name="QueueArray" c:type="GstQueueArray*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="struct_size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Size of each element (e.g. structure) in the array</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="initial_size" transfer-ownership="none">
|
|
<doc xml:space="preserve">Initial size of the new queue</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="type_find_helper" c:identifier="gst_type_find_helper">
|
|
<doc xml:space="preserve">Tries to find what type of data is flowing from the given source #GstPad.
|
|
|
|
Free-function: gst_caps_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">the #GstCaps corresponding to the data
|
|
stream. Returns %NULL if no #GstCaps matches the data stream.</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="src" transfer-ownership="none">
|
|
<doc xml:space="preserve">A source #GstPad</doc>
|
|
<type name="Gst.Pad" c:type="GstPad*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">The length in bytes</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="type_find_helper_for_buffer" c:identifier="gst_type_find_helper_for_buffer">
|
|
<doc xml:space="preserve">Tries to find what type of data is contained in the given #GstBuffer, the
|
|
assumption being that the buffer represents the beginning of the stream or
|
|
file.
|
|
|
|
All available typefinders will be called on the data in order of rank. If
|
|
a typefinding function returns a probability of %GST_TYPE_FIND_MAXIMUM,
|
|
typefinding is stopped immediately and the found caps will be returned
|
|
right away. Otherwise, all available typefind functions will the tried,
|
|
and the caps with the highest probability will be returned, or %NULL if
|
|
the content of the buffer could not be identified.
|
|
|
|
Free-function: gst_caps_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">the #GstCaps corresponding to the data,
|
|
or %NULL if no type could be found. The caller should free the caps
|
|
returned with gst_caps_unref().</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="obj" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">object doing the typefinding, or %NULL (used for logging)</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBuffer with data to typefind</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="prob" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">location to store the probability of the found
|
|
caps, or %NULL</doc>
|
|
<type name="Gst.TypeFindProbability" c:type="GstTypeFindProbability*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="type_find_helper_for_buffer_with_extension" c:identifier="gst_type_find_helper_for_buffer_with_extension" version="1.16">
|
|
<doc xml:space="preserve">Tries to find what type of data is contained in the given #GstBuffer, the
|
|
assumption being that the buffer represents the beginning of the stream or
|
|
file.
|
|
|
|
All available typefinders will be called on the data in order of rank. If
|
|
a typefinding function returns a probability of %GST_TYPE_FIND_MAXIMUM,
|
|
typefinding is stopped immediately and the found caps will be returned
|
|
right away. Otherwise, all available typefind functions will the tried,
|
|
and the caps with the highest probability will be returned, or %NULL if
|
|
the content of the buffer could not be identified.
|
|
|
|
When @extension is not %NULL, this function will first try the typefind
|
|
functions for the given extension, which might speed up the typefinding
|
|
in many cases.
|
|
|
|
Free-function: gst_caps_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">the #GstCaps corresponding to the data,
|
|
or %NULL if no type could be found. The caller should free the caps
|
|
returned with gst_caps_unref().</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="obj" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">object doing the typefinding, or %NULL (used for logging)</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="buf" transfer-ownership="none">
|
|
<doc xml:space="preserve">a #GstBuffer with data to typefind</doc>
|
|
<type name="Gst.Buffer" c:type="GstBuffer*"/>
|
|
</parameter>
|
|
<parameter name="extension" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">extension of the media, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="prob" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">location to store the probability of the found
|
|
caps, or %NULL</doc>
|
|
<type name="Gst.TypeFindProbability" c:type="GstTypeFindProbability*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="type_find_helper_for_data" c:identifier="gst_type_find_helper_for_data">
|
|
<doc xml:space="preserve">Tries to find what type of data is contained in the given @data, the
|
|
assumption being that the data represents the beginning of the stream or
|
|
file.
|
|
|
|
All available typefinders will be called on the data in order of rank. If
|
|
a typefinding function returns a probability of %GST_TYPE_FIND_MAXIMUM,
|
|
typefinding is stopped immediately and the found caps will be returned
|
|
right away. Otherwise, all available typefind functions will the tried,
|
|
and the caps with the highest probability will be returned, or %NULL if
|
|
the content of @data could not be identified.
|
|
|
|
Free-function: gst_caps_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">the #GstCaps corresponding to the data,
|
|
or %NULL if no type could be found. The caller should free the caps
|
|
returned with gst_caps_unref().</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="obj" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">object doing the typefinding, or %NULL (used for logging)</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">* a pointer with data to typefind</doc>
|
|
<array length="2" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">the size of @data</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="prob" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">location to store the probability of the found
|
|
caps, or %NULL</doc>
|
|
<type name="Gst.TypeFindProbability" c:type="GstTypeFindProbability*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="type_find_helper_for_data_with_extension" c:identifier="gst_type_find_helper_for_data_with_extension" version="1.16">
|
|
<doc xml:space="preserve">Tries to find what type of data is contained in the given @data, the
|
|
assumption being that the data represents the beginning of the stream or
|
|
file.
|
|
|
|
All available typefinders will be called on the data in order of rank. If
|
|
a typefinding function returns a probability of %GST_TYPE_FIND_MAXIMUM,
|
|
typefinding is stopped immediately and the found caps will be returned
|
|
right away. Otherwise, all available typefind functions will the tried,
|
|
and the caps with the highest probability will be returned, or %NULL if
|
|
the content of @data could not be identified.
|
|
|
|
When @extension is not %NULL, this function will first try the typefind
|
|
functions for the given extension, which might speed up the typefinding
|
|
in many cases.
|
|
|
|
Free-function: gst_caps_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">the #GstCaps corresponding to the data,
|
|
or %NULL if no type could be found. The caller should free the caps
|
|
returned with gst_caps_unref().</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="obj" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">object doing the typefinding, or %NULL (used for logging)</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve">* a pointer with data to typefind</doc>
|
|
<array length="2" zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">the size of @data</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="extension" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">extension of the media, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="prob" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">location to store the probability of the found
|
|
caps, or %NULL</doc>
|
|
<type name="Gst.TypeFindProbability" c:type="GstTypeFindProbability*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="type_find_helper_for_extension" c:identifier="gst_type_find_helper_for_extension">
|
|
<doc xml:space="preserve">Tries to find the best #GstCaps associated with @extension.
|
|
|
|
All available typefinders will be checked against the extension in order
|
|
of rank. The caps of the first typefinder that can handle @extension will be
|
|
returned.
|
|
|
|
Free-function: gst_caps_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">the #GstCaps corresponding to
|
|
@extension, or %NULL if no type could be found. The caller should free
|
|
the caps returned with gst_caps_unref().</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="obj" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">object doing the typefinding, or %NULL (used for logging)</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="extension" transfer-ownership="none">
|
|
<doc xml:space="preserve">an extension</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="type_find_helper_get_range" c:identifier="gst_type_find_helper_get_range">
|
|
<doc xml:space="preserve">Utility function to do pull-based typefinding. Unlike gst_type_find_helper()
|
|
however, this function will use the specified function @func to obtain the
|
|
data needed by the typefind functions, rather than operating on a given
|
|
source pad. This is useful mostly for elements like tag demuxers which
|
|
strip off data at the beginning and/or end of a file and want to typefind
|
|
the stripped data stream before adding their own source pad (the specified
|
|
callback can then call the upstream peer pad with offsets adjusted for the
|
|
tag size, for example).
|
|
|
|
When @extension is not %NULL, this function will first try the typefind
|
|
functions for the given extension, which might speed up the typefinding
|
|
in many cases.
|
|
|
|
Free-function: gst_caps_unref</doc>
|
|
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve">the #GstCaps corresponding to the data
|
|
stream. Returns %NULL if no #GstCaps matches the data stream.</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="obj" transfer-ownership="none">
|
|
<doc xml:space="preserve">A #GstObject that will be passed as first argument to @func</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="parent" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">the parent of @obj or %NULL</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="call">
|
|
<doc xml:space="preserve">A generic #GstTypeFindHelperGetRangeFunction that will
|
|
be used to access data at random offsets when doing the typefinding</doc>
|
|
<type name="TypeFindHelperGetRangeFunction" c:type="GstTypeFindHelperGetRangeFunction"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">The length in bytes</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="extension" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">extension of the media, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="prob" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">location to store the probability of the found
|
|
caps, or %NULL</doc>
|
|
<type name="Gst.TypeFindProbability" c:type="GstTypeFindProbability*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="type_find_helper_get_range_full" c:identifier="gst_type_find_helper_get_range_full" version="1.14.3">
|
|
<doc xml:space="preserve">Utility function to do pull-based typefinding. Unlike gst_type_find_helper()
|
|
however, this function will use the specified function @func to obtain the
|
|
data needed by the typefind functions, rather than operating on a given
|
|
source pad. This is useful mostly for elements like tag demuxers which
|
|
strip off data at the beginning and/or end of a file and want to typefind
|
|
the stripped data stream before adding their own source pad (the specified
|
|
callback can then call the upstream peer pad with offsets adjusted for the
|
|
tag size, for example).
|
|
|
|
When @extension is not %NULL, this function will first try the typefind
|
|
functions for the given extension, which might speed up the typefinding
|
|
in many cases.</doc>
|
|
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve">the last %GstFlowReturn from pulling a buffer or %GST_FLOW_OK if
|
|
typefinding was successful.</doc>
|
|
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="obj" transfer-ownership="none">
|
|
<doc xml:space="preserve">A #GstObject that will be passed as first argument to @func</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="parent" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">the parent of @obj or %NULL</doc>
|
|
<type name="Gst.Object" c:type="GstObject*"/>
|
|
</parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="call">
|
|
<doc xml:space="preserve">A generic #GstTypeFindHelperGetRangeFunction that will
|
|
be used to access data at random offsets when doing the typefinding</doc>
|
|
<type name="TypeFindHelperGetRangeFunction" c:type="GstTypeFindHelperGetRangeFunction"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve">The length in bytes</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="extension" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve">extension of the media, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="caps" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve">returned caps</doc>
|
|
<type name="Gst.Caps" c:type="GstCaps**"/>
|
|
</parameter>
|
|
<parameter name="prob" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve">location to store the probability of the found
|
|
caps, or %NULL</doc>
|
|
<type name="Gst.TypeFindProbability" c:type="GstTypeFindProbability*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</namespace>
|
|
</repository>
|