gstreamer-rs/gir-files/GstCheck-1.0.gir
2019-04-23 18:33:01 +03:00

2719 lines
130 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="Gst" version="1.0"/>
<package name="gstreamer-check-1.0"/>
<c:include name="gst/check/check.h"/>
<namespace name="GstCheck" version="1.0" shared-library="libgstcheck-1.0.so.0" c:identifier-prefixes="Gst" c:symbol-prefixes="gst">
<record name="Harness" c:type="GstHarness" version="1.6">
<doc xml:space="preserve">#GstHarness is meant to make writing unit test for GStreamer much easier.
It can be thought of as a way of treating a #GstElement as a black box,
deterministically feeding it data, and controlling what data it outputs.
The basic structure of #GstHarness is two "floating" #GstPads that connect
to the harnessed #GstElement src and sink #GstPads like so:
|[
__________________________
_____ | _____ _____ | _____
| | | | | | | | | |
| src |--+-| sink| Element | src |-+--| sink|
|_____| | |_____| |_____| | |_____|
|__________________________|
]|
With this, you can now simulate any environment the #GstElement might find
itself in. By specifying the #GstCaps of the harness #GstPads, using
functions like gst_harness_set_src_caps() or gst_harness_set_sink_caps_str(),
you can test how the #GstElement interacts with different caps sets.
Your harnessed #GstElement can of course also be a bin, and using
gst_harness_new_parse() supporting standard gst-launch syntax, you can
easily test a whole pipeline instead of just one element.
You can then go on to push #GstBuffers and #GstEvents on to the srcpad,
using functions like gst_harness_push() and gst_harness_push_event(), and
then pull them out to examine them with gst_harness_pull() and
gst_harness_pull_event().
## A simple buffer-in buffer-out example
|[&lt;!-- language="C" --&gt;
#include &lt;gst/gst.h&gt;
#include &lt;gst/check/gstharness.h&gt;
GstHarness *h;
GstBuffer *in_buf;
GstBuffer *out_buf;
// attach the harness to the src and sink pad of GstQueue
h = gst_harness_new ("queue");
// we must specify a caps before pushing buffers
gst_harness_set_src_caps_str (h, "mycaps");
// create a buffer of size 42
in_buf = gst_harness_create_buffer (h, 42);
// push the buffer into the queue
gst_harness_push (h, in_buf);
// pull the buffer from the queue
out_buf = gst_harness_pull (h);
// validate the buffer in is the same as buffer out
fail_unless (in_buf == out_buf);
// cleanup
gst_buffer_unref (out_buf);
gst_harness_teardown (h);
]|
Another main feature of the #GstHarness is its integration with the
#GstTestClock. Operating the #GstTestClock can be very challenging, but
#GstHarness simplifies some of the most desired actions a lot, like wanting
to manually advance the clock while at the same time releasing a #GstClockID
that is waiting, with functions like gst_harness_crank_single_clock_wait().
#GstHarness also supports sub-harnesses, as a way of generating and
validating data. A sub-harness is another #GstHarness that is managed by
the "parent" harness, and can either be created by using the standard
gst_harness_new type functions directly on the (GstHarness *)-&gt;src_harness,
or using the much more convenient gst_harness_add_src() or
gst_harness_add_sink_parse(). If you have a decoder-element you want to test,
(like vp8dec) it can be very useful to add a src-harness with both a
src-element (videotestsrc) and an encoder (vp8enc) to feed the decoder data
with different configurations, by simply doing:
|[&lt;!-- language="C" --&gt;
GstHarness * h = gst_harness_new (h, "vp8dec");
gst_harness_add_src_parse (h, "videotestsrc is-live=1 ! vp8enc", TRUE);
]|
and then feeding it data with:
|[&lt;!-- language="C" --&gt;
gst_harness_push_from_src (h);
]|</doc>
<field name="element" writable="1">
<doc xml:space="preserve">the element inside the harness</doc>
<type name="Gst.Element" c:type="GstElement*"/>
</field>
<field name="srcpad" writable="1">
<doc xml:space="preserve">the internal harness source pad</doc>
<type name="Gst.Pad" c:type="GstPad*"/>
</field>
<field name="sinkpad" writable="1">
<doc xml:space="preserve">the internal harness sink pad</doc>
<type name="Gst.Pad" c:type="GstPad*"/>
</field>
<field name="src_harness" writable="1">
<doc xml:space="preserve">the source (input) harness (if any)</doc>
<type name="Harness" c:type="GstHarness*"/>
</field>
<field name="sink_harness" writable="1">
<doc xml:space="preserve">the sink (output) harness (if any)</doc>
<type name="Harness" c:type="GstHarness*"/>
</field>
<field name="priv" readable="0" private="1">
<type name="HarnessPrivate" c:type="GstHarnessPrivate*"/>
</field>
<method name="add_element_full" c:identifier="gst_harness_add_element_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Adds a #GstElement to an empty #GstHarness
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="element" transfer-ownership="none">
<doc xml:space="preserve">a #GstElement to add to the harness (transfer none)</doc>
<type name="Gst.Element" c:type="GstElement*"/>
</parameter>
<parameter name="hsrc" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness srcpad.
%NULL will not create a harness srcpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
<parameter name="element_sinkpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
sinkpad that is then linked to the harness srcpad. Can be a static or request
or a sometimes pad that has been added. %NULL will not get/request a sinkpad
from the element. (Like if the element is a src.)</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="hsink" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness sinkpad.
%NULL will not create a harness sinkpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
<parameter name="element_srcpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
srcpad that is then linked to the harness sinkpad, similar to the
@element_sinkpad_name.</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="add_element_sink_pad" c:identifier="gst_harness_add_element_sink_pad" version="1.6">
<doc xml:space="preserve">Links the specified #GstPad the @GstHarness srcpad.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="sinkpad" transfer-ownership="none">
<doc xml:space="preserve">a #GstPad to link to the harness srcpad</doc>
<type name="Gst.Pad" c:type="GstPad*"/>
</parameter>
</parameters>
</method>
<method name="add_element_src_pad" c:identifier="gst_harness_add_element_src_pad" version="1.6">
<doc xml:space="preserve">Links the specified #GstPad the @GstHarness sinkpad. This can be useful if
perhaps the srcpad did not exist at the time of creating the harness,
like a demuxer that provides a sometimes-pad after receiving data.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="srcpad" transfer-ownership="none">
<doc xml:space="preserve">a #GstPad to link to the harness sinkpad</doc>
<type name="Gst.Pad" c:type="GstPad*"/>
</parameter>
</parameters>
</method>
<method name="add_parse" c:identifier="gst_harness_add_parse" version="1.6" introspectable="0">
<doc xml:space="preserve">Parses the @launchline and puts that in a #GstBin,
and then attches the supplied #GstHarness to the bin.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="launchline" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing a gst-launch type line</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="add_probe" c:identifier="gst_harness_add_probe" version="1.6">
<doc xml:space="preserve">A convenience function to allows you to call gst_pad_add_probe on a
#GstPad of a #GstElement that are residing inside the #GstHarness,
by using normal gst_pad_add_probe syntax
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with a #GstElementFactory name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="pad_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with the name of the pad to attach the probe to</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="mask" transfer-ownership="none">
<doc xml:space="preserve">a #GstPadProbeType (see gst_pad_add_probe)</doc>
<type name="Gst.PadProbeType" c:type="GstPadProbeType"/>
</parameter>
<parameter name="callback" transfer-ownership="none" scope="notified" closure="4" destroy="5">
<doc xml:space="preserve">a #GstPadProbeCallback (see gst_pad_add_probe)</doc>
<type name="Gst.PadProbeCallback" c:type="GstPadProbeCallback"/>
</parameter>
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gpointer (see gst_pad_add_probe)</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="destroy_data" transfer-ownership="none" scope="async">
<doc xml:space="preserve">a #GDestroyNotify (see gst_pad_add_probe)</doc>
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
</parameter>
</parameters>
</method>
<method name="add_propose_allocation_meta" c:identifier="gst_harness_add_propose_allocation_meta" version="1.16">
<doc xml:space="preserve">Add api with params as one of the supported metadata API to propose when
receiving an allocation query.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="api" transfer-ownership="none">
<doc xml:space="preserve">a metadata API</doc>
<type name="GType" c:type="GType"/>
</parameter>
<parameter name="params" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">API specific parameters</doc>
<type name="Gst.Structure" c:type="const GstStructure*"/>
</parameter>
</parameters>
</method>
<method name="add_sink" c:identifier="gst_harness_add_sink" version="1.6">
<doc xml:space="preserve">Similar to gst_harness_add_sink_harness, this is a convenience to
directly create a sink-harness using the @sink_element_name name specified.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="sink_element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with the name of a #GstElement</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="add_sink_harness" c:identifier="gst_harness_add_sink_harness" version="1.6">
<doc xml:space="preserve">Similar to gst_harness_add_src, this allows you to send the data coming out
of your harnessed #GstElement to a sink-element, allowing to test different
responses the element output might create in sink elements. An example might
be an existing sink providing some analytical data on the input it receives that
can be useful to your testing. If the goal is to test a sink-element itself,
this is better achieved using gst_harness_new directly on the sink.
If a sink-harness already exists it will be replaced.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="sink_harness" transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness to be added as a sink-harness.</doc>
<type name="Harness" c:type="GstHarness*"/>
</parameter>
</parameters>
</method>
<method name="add_sink_parse" c:identifier="gst_harness_add_sink_parse" version="1.6">
<doc xml:space="preserve">Similar to gst_harness_add_sink, this allows you to specify a launch-line
instead of just an element name. See gst_harness_add_src_parse for details.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="launchline" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with the name of a #GstElement</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="add_src" c:identifier="gst_harness_add_src" version="1.6">
<doc xml:space="preserve">Similar to gst_harness_add_src_harness, this is a convenience to
directly create a src-harness using the @src_element_name name specified.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="src_element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with the name of a #GstElement</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="has_clock_wait" transfer-ownership="none">
<doc xml:space="preserve">a #gboolean specifying if the #GstElement uses
gst_clock_wait_id internally.</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</method>
<method name="add_src_harness" c:identifier="gst_harness_add_src_harness" version="1.6">
<doc xml:space="preserve">A src-harness is a great way of providing the #GstHarness with data.
By adding a src-type #GstElement, it is then easy to use functions like
gst_harness_push_from_src or gst_harness_src_crank_and_push_many
to provide your harnessed element with input. The @has_clock_wait variable
is a great way to control you src-element with, in that you can have it
produce a buffer for you by simply cranking the clock, and not have it
spin out of control producing buffers as fast as possible.
If a src-harness already exists it will be replaced.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="src_harness" transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness to be added as a src-harness.</doc>
<type name="Harness" c:type="GstHarness*"/>
</parameter>
<parameter name="has_clock_wait" transfer-ownership="none">
<doc xml:space="preserve">a #gboolean specifying if the #GstElement uses
gst_clock_wait_id internally.</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</method>
<method name="add_src_parse" c:identifier="gst_harness_add_src_parse" version="1.6">
<doc xml:space="preserve">Similar to gst_harness_add_src, this allows you to specify a launch-line,
which can be useful for both having more then one #GstElement acting as your
src (Like a src producing raw buffers, and then an encoder, providing encoded
data), but also by allowing you to set properties like "is-live" directly on
the elements.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="launchline" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing a gst-launch type line</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="has_clock_wait" transfer-ownership="none">
<doc xml:space="preserve">a #gboolean specifying if the #GstElement uses
gst_clock_wait_id internally.</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</method>
<method name="buffers_in_queue" c:identifier="gst_harness_buffers_in_queue" version="1.6">
<doc xml:space="preserve">The number of #GstBuffers currently in the #GstHarness sinkpad #GAsyncQueue
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #guint number of buffers in the queue</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="buffers_received" c:identifier="gst_harness_buffers_received" version="1.6">
<doc xml:space="preserve">The total number of #GstBuffers that has arrived on the #GstHarness sinkpad.
This number includes buffers that have been dropped as well as buffers
that have already been pulled out.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #guint number of buffers received</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="crank_multiple_clock_waits" c:identifier="gst_harness_crank_multiple_clock_waits" version="1.6">
<doc xml:space="preserve">Similar to gst_harness_crank_single_clock_wait(), this is the function to use
if your harnessed element(s) are using more then one gst_clock_id_wait.
Failing to do so can (and will) make it racy which #GstClockID you actually
are releasing, where as this function will process all the waits at the
same time, ensuring that one thread can't register another wait before
both are released.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a @gboolean %TRUE if the "crank" was successful, %FALSE if not.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="waits" transfer-ownership="none">
<doc xml:space="preserve">a #guint describing the number of #GstClockIDs to crank</doc>
<type name="guint" c:type="guint"/>
</parameter>
</parameters>
</method>
<method name="crank_single_clock_wait" c:identifier="gst_harness_crank_single_clock_wait" version="1.6">
<doc xml:space="preserve">A "crank" consists of three steps:
1: Wait for a #GstClockID to be registered with the #GstTestClock.
2: Advance the #GstTestClock to the time the #GstClockID is waiting for.
3: Release the #GstClockID wait.
Together, this provides an easy way to not have to think about the details
around clocks and time, but still being able to write deterministic tests
that are dependent on this. A "crank" can be though of as the notion of
manually driving the clock forward to its next logical step.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a @gboolean %TRUE if the "crank" was successful, %FALSE if not.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="create_buffer" c:identifier="gst_harness_create_buffer" version="1.6">
<doc xml:space="preserve">Allocates a buffer using a #GstBufferPool if present, or else using the
configured #GstAllocator and #GstAllocationParams
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstBuffer of size @size</doc>
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="size" transfer-ownership="none">
<doc xml:space="preserve">a #gsize specifying the size of the buffer</doc>
<type name="gsize" c:type="gsize"/>
</parameter>
</parameters>
</method>
<method name="dump_to_file" c:identifier="gst_harness_dump_to_file" version="1.6">
<doc xml:space="preserve">Allows you to dump the #GstBuffers the #GstHarness sinkpad #GAsyncQueue
to a file.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="filename" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with a the name of a file</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="events_in_queue" c:identifier="gst_harness_events_in_queue" version="1.6">
<doc xml:space="preserve">The number of #GstEvents currently in the #GstHarness sinkpad #GAsyncQueue
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #guint number of events in the queue</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="events_received" c:identifier="gst_harness_events_received" version="1.6">
<doc xml:space="preserve">The total number of #GstEvents that has arrived on the #GstHarness sinkpad
This number includes events handled by the harness as well as events
that have already been pulled out.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #guint number of events received</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="find_element" c:identifier="gst_harness_find_element" version="1.6">
<doc xml:space="preserve">Most useful in conjunction with gst_harness_new_parse, this will scan the
#GstElements inside the #GstHarness, and check if any of them matches
@element_name. Typical usecase being that you need to access one of the
harnessed elements for properties and/or signals.
MT safe.</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve">a #GstElement or %NULL if not found</doc>
<type name="Gst.Element" c:type="GstElement*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with a #GstElementFactory name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="get" c:identifier="gst_harness_get" version="1.6" introspectable="0">
<doc xml:space="preserve">A convenience function to allows you to call g_object_get on a #GstElement
that are residing inside the #GstHarness, by using normal g_object_get
syntax.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with a #GstElementFactory name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="first_property_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with the first property name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="..." transfer-ownership="none">
<doc xml:space="preserve">return location for the first property, followed optionally by more
name/return location pairs, followed by %NULL</doc>
<varargs/>
</parameter>
</parameters>
</method>
<method name="get_allocator" c:identifier="gst_harness_get_allocator" version="1.6">
<doc xml:space="preserve">Gets the @allocator and its @params that has been decided to use after an
allocation query.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="allocator" direction="out" caller-allocates="0" transfer-ownership="none" 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_last_pushed_timestamp" c:identifier="gst_harness_get_last_pushed_timestamp" version="1.6">
<doc xml:space="preserve">Get the timestamp of the last #GstBuffer pushed on the #GstHarness srcpad,
typically with gst_harness_push or gst_harness_push_from_src.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #GstClockTime with the timestamp or %GST_CLOCK_TIME_NONE if no
#GstBuffer has been pushed on the #GstHarness srcpad</doc>
<type name="Gst.ClockTime" c:type="GstClockTime"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="get_testclock" c:identifier="gst_harness_get_testclock" version="1.6">
<doc xml:space="preserve">Get the #GstTestClock. Useful if specific operations on the testclock is
needed.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstTestClock, or %NULL if the testclock is not
present.</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="play" c:identifier="gst_harness_play" version="1.6">
<doc xml:space="preserve">This will set the harnessed #GstElement to %GST_STATE_PLAYING.
#GstElements without a sink-#GstPad and with the %GST_ELEMENT_FLAG_SOURCE
flag set is considered a src #GstElement
Non-src #GstElements (like sinks and filters) are automatically set to
playing by the #GstHarness, but src #GstElements are not to avoid them
starting to produce buffers.
Hence, for src #GstElement you must call gst_harness_play() explicitly.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="pull" c:identifier="gst_harness_pull" version="1.6">
<doc xml:space="preserve">Pulls a #GstBuffer from the #GAsyncQueue on the #GstHarness sinkpad. The pull
will timeout in 60 seconds. This is the standard way of getting a buffer
from a harnessed #GstElement.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstBuffer or %NULL if timed out.</doc>
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="pull_event" c:identifier="gst_harness_pull_event" version="1.6">
<doc xml:space="preserve">Pulls an #GstEvent from the #GAsyncQueue on the #GstHarness sinkpad.
Timeouts after 60 seconds similar to gst_harness_pull.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstEvent or %NULL if timed out.</doc>
<type name="Gst.Event" c:type="GstEvent*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="pull_upstream_event" c:identifier="gst_harness_pull_upstream_event" version="1.6">
<doc xml:space="preserve">Pulls an #GstEvent from the #GAsyncQueue on the #GstHarness srcpad.
Timeouts after 60 seconds similar to gst_harness_pull.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstEvent or %NULL if timed out.</doc>
<type name="Gst.Event" c:type="GstEvent*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="push" c:identifier="gst_harness_push" version="1.6">
<doc xml:space="preserve">Pushes a #GstBuffer on the #GstHarness srcpad. The standard way of
interacting with an harnessed element.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #GstFlowReturn with the result from the push</doc>
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="buffer" transfer-ownership="full">
<doc xml:space="preserve">a #GstBuffer to push</doc>
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</parameter>
</parameters>
</method>
<method name="push_and_pull" c:identifier="gst_harness_push_and_pull" version="1.6">
<doc xml:space="preserve">Basically a gst_harness_push and a gst_harness_pull in one line. Reflects
the fact that you often want to do exactly this in your test: Push one buffer
in, and inspect the outcome.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstBuffer or %NULL if timed out.</doc>
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="buffer" transfer-ownership="full">
<doc xml:space="preserve">a #GstBuffer to push</doc>
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</parameter>
</parameters>
</method>
<method name="push_event" c:identifier="gst_harness_push_event" version="1.6">
<doc xml:space="preserve">Pushes an #GstEvent on the #GstHarness srcpad.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #gboolean with the result from the push</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="event" transfer-ownership="none">
<doc xml:space="preserve">a #GstEvent to push</doc>
<type name="Gst.Event" c:type="GstEvent*"/>
</parameter>
</parameters>
</method>
<method name="push_from_src" c:identifier="gst_harness_push_from_src" version="1.6">
<doc xml:space="preserve">Transfer data from the src-#GstHarness to the main-#GstHarness. It consists
of 4 steps:
1: Make sure the src is started. (see: gst_harness_play)
2: Crank the clock (see: gst_harness_crank_single_clock_wait)
3: Pull a #GstBuffer from the src-#GstHarness (see: gst_harness_pull)
4: Push the same #GstBuffer into the main-#GstHarness (see: gst_harness_push)
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #GstFlowReturn with the result of the push</doc>
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="push_to_sink" c:identifier="gst_harness_push_to_sink" version="1.6">
<doc xml:space="preserve">Transfer one #GstBuffer from the main-#GstHarness to the sink-#GstHarness.
See gst_harness_push_from_src for details.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #GstFlowReturn with the result of the push</doc>
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="push_upstream_event" c:identifier="gst_harness_push_upstream_event" version="1.6">
<doc xml:space="preserve">Pushes an #GstEvent on the #GstHarness sinkpad.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #gboolean with the result from the push</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="event" transfer-ownership="none">
<doc xml:space="preserve">a #GstEvent to push</doc>
<type name="Gst.Event" c:type="GstEvent*"/>
</parameter>
</parameters>
</method>
<method name="query_latency" c:identifier="gst_harness_query_latency" version="1.6">
<doc xml:space="preserve">Get the min latency reported by any harnessed #GstElement.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #GstClockTime with min latency</doc>
<type name="Gst.ClockTime" c:type="GstClockTime"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="set" c:identifier="gst_harness_set" version="1.6" introspectable="0">
<doc xml:space="preserve">A convenience function to allows you to call g_object_set on a #GstElement
that are residing inside the #GstHarness, by using normal g_object_set
syntax.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with a #GstElementFactory name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="first_property_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar with the first property name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="..." transfer-ownership="none">
<doc xml:space="preserve">value for the first property, followed optionally by more
name/value pairs, followed by %NULL</doc>
<varargs/>
</parameter>
</parameters>
</method>
<method name="set_blocking_push_mode" c:identifier="gst_harness_set_blocking_push_mode" version="1.6">
<doc xml:space="preserve">Setting this will make the harness block in the chain-function, and
then release when gst_harness_pull() or gst_harness_try_pull() is called.
Can be useful when wanting to control a src-element that is not implementing
gst_clock_id_wait() so it can't be controlled by the #GstTestClock, since
it otherwise would produce buffers as fast as possible.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="set_caps" c:identifier="gst_harness_set_caps" version="1.6">
<doc xml:space="preserve">Sets the @GstHarness srcpad and sinkpad caps.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="in" transfer-ownership="full">
<doc xml:space="preserve">a #GstCaps to set on the harness srcpad</doc>
<type name="Gst.Caps" c:type="GstCaps*"/>
</parameter>
<parameter name="out" transfer-ownership="full">
<doc xml:space="preserve">a #GstCaps to set on the harness sinkpad</doc>
<type name="Gst.Caps" c:type="GstCaps*"/>
</parameter>
</parameters>
</method>
<method name="set_caps_str" c:identifier="gst_harness_set_caps_str" version="1.6">
<doc xml:space="preserve">Sets the @GstHarness srcpad and sinkpad caps using strings.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="in" transfer-ownership="none">
<doc xml:space="preserve">a @gchar describing a #GstCaps to set on the harness srcpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="out" transfer-ownership="none">
<doc xml:space="preserve">a @gchar describing a #GstCaps to set on the harness sinkpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="set_drop_buffers" c:identifier="gst_harness_set_drop_buffers" version="1.6">
<doc xml:space="preserve">When set to %TRUE, instead of placing the buffers arriving from the harnessed
#GstElement inside the sinkpads #GAsyncQueue, they are instead unreffed.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="drop_buffers" transfer-ownership="none">
<doc xml:space="preserve">a #gboolean specifying to drop outgoing buffers or not</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</method>
<method name="set_forwarding" c:identifier="gst_harness_set_forwarding" version="1.6">
<doc xml:space="preserve">As a convenience, a src-harness will forward %GST_EVENT_STREAM_START,
%GST_EVENT_CAPS and %GST_EVENT_SEGMENT to the main-harness if forwarding
is enabled, and forward any sticky-events from the main-harness to
the sink-harness. It will also forward the %GST_QUERY_ALLOCATION.
If forwarding is disabled, the user will have to either manually push
these events from the src-harness using gst_harness_src_push_event(), or
create and push them manually. While this will allow full control and
inspection of these events, for the most cases having forwarding enabled
will be sufficient when writing a test where the src-harness' main function
is providing data for the main-harness.
Forwarding is enabled by default.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="forwarding" transfer-ownership="none">
<doc xml:space="preserve">a #gboolean to enable/disable forwarding</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</method>
<method name="set_propose_allocator" c:identifier="gst_harness_set_propose_allocator" version="1.6">
<doc xml:space="preserve">Sets the @allocator and @params to propose when receiving an allocation
query.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="allocator" transfer-ownership="full" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstAllocator</doc>
<type name="Gst.Allocator" c:type="GstAllocator*"/>
</parameter>
<parameter name="params" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstAllocationParams</doc>
<type name="Gst.AllocationParams" c:type="const GstAllocationParams*"/>
</parameter>
</parameters>
</method>
<method name="set_sink_caps" c:identifier="gst_harness_set_sink_caps" version="1.6">
<doc xml:space="preserve">Sets the @GstHarness sinkpad caps.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="caps" transfer-ownership="full">
<doc xml:space="preserve">a #GstCaps to set on the harness sinkpad</doc>
<type name="Gst.Caps" c:type="GstCaps*"/>
</parameter>
</parameters>
</method>
<method name="set_sink_caps_str" c:identifier="gst_harness_set_sink_caps_str" version="1.6">
<doc xml:space="preserve">Sets the @GstHarness sinkpad caps using a string.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:space="preserve">a @gchar describing a #GstCaps to set on the harness sinkpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="set_src_caps" c:identifier="gst_harness_set_src_caps" version="1.6">
<doc xml:space="preserve">Sets the @GstHarness srcpad caps. This must be done before any buffers
can legally be pushed from the harness to the element.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="caps" transfer-ownership="full">
<doc xml:space="preserve">a #GstCaps to set on the harness srcpad</doc>
<type name="Gst.Caps" c:type="GstCaps*"/>
</parameter>
</parameters>
</method>
<method name="set_src_caps_str" c:identifier="gst_harness_set_src_caps_str" version="1.6">
<doc xml:space="preserve">Sets the @GstHarness srcpad caps using a string. This must be done before
any buffers can legally be pushed from the harness to the element.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:space="preserve">a @gchar describing a #GstCaps to set on the harness srcpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<method name="set_time" c:identifier="gst_harness_set_time" version="1.6">
<doc xml:space="preserve">Advance the #GstTestClock to a specific time.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a @gboolean %TRUE if the time could be set. %FALSE if not.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="time" transfer-ownership="none">
<doc xml:space="preserve">a #GstClockTime to advance the clock to</doc>
<type name="Gst.ClockTime" c:type="GstClockTime"/>
</parameter>
</parameters>
</method>
<method name="set_upstream_latency" c:identifier="gst_harness_set_upstream_latency" version="1.6">
<doc xml:space="preserve">Sets the min latency reported by #GstHarness when receiving a latency-query</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="latency" transfer-ownership="none">
<doc xml:space="preserve">a #GstClockTime specifying the latency</doc>
<type name="Gst.ClockTime" c:type="GstClockTime"/>
</parameter>
</parameters>
</method>
<method name="sink_push_many" c:identifier="gst_harness_sink_push_many" version="1.6">
<doc xml:space="preserve">Convenience that calls gst_harness_push_to_sink @pushes number of times.
Will abort the pushing if any one push fails.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #GstFlowReturn with the result of the push</doc>
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="pushes" transfer-ownership="none">
<doc xml:space="preserve">a #gint with the number of calls to gst_harness_push_to_sink</doc>
<type name="gint" c:type="gint"/>
</parameter>
</parameters>
</method>
<method name="src_crank_and_push_many" c:identifier="gst_harness_src_crank_and_push_many" version="1.6">
<doc xml:space="preserve">Transfer data from the src-#GstHarness to the main-#GstHarness. Similar to
gst_harness_push_from_src, this variant allows you to specify how many cranks
and how many pushes to perform. This can be useful for both moving a lot
of data at the same time, as well as cases when one crank does not equal one
buffer to push and v.v.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #GstFlowReturn with the result of the push</doc>
<type name="Gst.FlowReturn" c:type="GstFlowReturn"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="cranks" transfer-ownership="none">
<doc xml:space="preserve">a #gint with the number of calls to gst_harness_crank_single_clock_wait</doc>
<type name="gint" c:type="gint"/>
</parameter>
<parameter name="pushes" transfer-ownership="none">
<doc xml:space="preserve">a #gint with the number of calls to gst_harness_push</doc>
<type name="gint" c:type="gint"/>
</parameter>
</parameters>
</method>
<method name="src_push_event" c:identifier="gst_harness_src_push_event" version="1.6">
<doc xml:space="preserve">Similar to what gst_harness_src_push does with #GstBuffers, this transfers
a #GstEvent from the src-#GstHarness to the main-#GstHarness. Note that
some #GstEvents are being transferred automagically. Look at sink_forward_pad
for details.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #gboolean with the result of the push</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="stress_custom_start" c:identifier="gst_harness_stress_custom_start" version="1.6" introspectable="0">
<doc xml:space="preserve">Start a custom stress-thread that will call your @callback for every
iteration allowing you to do something nasty.
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="init" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GFunc that is called initially and only once</doc>
<type name="GLib.Func" c:type="GFunc"/>
</parameter>
<parameter name="callback" transfer-ownership="none" closure="2">
<doc xml:space="preserve">a #GFunc that is called as often as possible</doc>
<type name="GLib.Func" c:type="GFunc"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gpointer with custom data to pass to the @callback function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each call to the @callback</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_property_start_full" c:identifier="gst_harness_stress_property_start_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Call g_object_set with @name and @value in intervals of @sleep microseconds
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar specifying a property name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:space="preserve">a #GValue to set the property to</doc>
<type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each g_object_set with @name and @value</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_push_buffer_start_full" c:identifier="gst_harness_stress_push_buffer_start_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Push a #GstBuffer in intervals of @sleep microseconds.
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="caps" transfer-ownership="none">
<doc xml:space="preserve">a #GstCaps for the #GstBuffer</doc>
<type name="Gst.Caps" c:type="GstCaps*"/>
</parameter>
<parameter name="segment" transfer-ownership="none">
<doc xml:space="preserve">a #GstSegment</doc>
<type name="Gst.Segment" c:type="const GstSegment*"/>
</parameter>
<parameter name="buf" transfer-ownership="none">
<doc xml:space="preserve">a #GstBuffer to push</doc>
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each call to gst_pad_push</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_push_buffer_with_cb_start_full" c:identifier="gst_harness_stress_push_buffer_with_cb_start_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Push a #GstBuffer returned by @func in intervals of @sleep microseconds.
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="caps" transfer-ownership="none">
<doc xml:space="preserve">a #GstCaps for the #GstBuffer</doc>
<type name="Gst.Caps" c:type="GstCaps*"/>
</parameter>
<parameter name="segment" transfer-ownership="none">
<doc xml:space="preserve">a #GstSegment</doc>
<type name="Gst.Segment" c:type="const GstSegment*"/>
</parameter>
<parameter name="func" transfer-ownership="none" scope="notified" closure="3" destroy="4">
<doc xml:space="preserve">a #GstHarnessPrepareBufferFunc function called before every iteration
to prepare / create a #GstBuffer for pushing</doc>
<type name="HarnessPrepareBufferFunc" c:type="GstHarnessPrepareBufferFunc"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gpointer with data to the #GstHarnessPrepareBufferFunc function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="notify" transfer-ownership="none" scope="async">
<doc xml:space="preserve">a #GDestroyNotify that is called when thread is stopped</doc>
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each call to gst_pad_push</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_push_event_start_full" c:identifier="gst_harness_stress_push_event_start_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Push the @event onto the harnessed #GstElement sinkpad in intervals of
@sleep microseconds
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="event" transfer-ownership="none">
<doc xml:space="preserve">a #GstEvent to push</doc>
<type name="Gst.Event" c:type="GstEvent*"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each gst_event_push with @event</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_push_event_with_cb_start_full" c:identifier="gst_harness_stress_push_event_with_cb_start_full" version="1.8" introspectable="0">
<doc xml:space="preserve">Push a #GstEvent returned by @func onto the harnessed #GstElement sinkpad
in intervals of @sleep microseconds.
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="func" transfer-ownership="none" scope="notified" closure="1" destroy="2">
<doc xml:space="preserve">a #GstHarnessPrepareEventFunc function called before every iteration
to prepare / create a #GstEvent for pushing</doc>
<type name="HarnessPrepareEventFunc" c:type="GstHarnessPrepareEventFunc"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gpointer with data to the #GstHarnessPrepareEventFunc function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="notify" transfer-ownership="none" scope="async">
<doc xml:space="preserve">a #GDestroyNotify that is called when thread is stopped</doc>
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each call to gst_pad_push</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_push_upstream_event_start_full" c:identifier="gst_harness_stress_push_upstream_event_start_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Push the @event onto the harnessed #GstElement srcpad in intervals of
@sleep microseconds.
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="event" transfer-ownership="none">
<doc xml:space="preserve">a #GstEvent to push</doc>
<type name="Gst.Event" c:type="GstEvent*"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each gst_event_push with @event</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_push_upstream_event_with_cb_start_full" c:identifier="gst_harness_stress_push_upstream_event_with_cb_start_full" version="1.8" introspectable="0">
<doc xml:space="preserve">Push a #GstEvent returned by @func onto the harnessed #GstElement srcpad
in intervals of @sleep microseconds.
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="func" transfer-ownership="none" scope="notified" closure="1" destroy="2">
<doc xml:space="preserve">a #GstHarnessPrepareEventFunc function called before every iteration
to prepare / create a #GstEvent for pushing</doc>
<type name="HarnessPrepareEventFunc" c:type="GstHarnessPrepareEventFunc"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gpointer with data to the #GstHarnessPrepareEventFunc function</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="notify" transfer-ownership="none" scope="async">
<doc xml:space="preserve">a #GDestroyNotify that is called when thread is stopped</doc>
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each call to gst_pad_push</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_requestpad_start_full" c:identifier="gst_harness_stress_requestpad_start_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Call gst_element_request_pad in intervals of @sleep microseconds
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="templ" transfer-ownership="none">
<doc xml:space="preserve">a #GstPadTemplate</doc>
<type name="Gst.PadTemplate" c:type="GstPadTemplate*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="caps" transfer-ownership="none">
<doc xml:space="preserve">a #GstCaps</doc>
<type name="Gst.Caps" c:type="GstCaps*"/>
</parameter>
<parameter name="release" transfer-ownership="none">
<doc xml:space="preserve">a #gboolean</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each gst_element_request_pad</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="stress_statechange_start_full" c:identifier="gst_harness_stress_statechange_start_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Change the state of your harnessed #GstElement from NULL to PLAYING and
back again, only pausing for @sleep microseconds every time.
MT safe.</doc>
<return-value>
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="sleep" transfer-ownership="none">
<doc xml:space="preserve">a #gulong specifying how long to sleep in (microseconds) for
each state-change</doc>
<type name="gulong" c:type="gulong"/>
</parameter>
</parameters>
</method>
<method name="take_all_data" c:identifier="gst_harness_take_all_data" shadowed-by="take_all_data_as_bytes" version="1.14" introspectable="0">
<doc xml:space="preserve">Pulls all pending data from the harness and returns it as a single
data slice.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a pointer to the data, newly allocated. Free
with g_free() when no longer needed. Will return %NULL if there is no
data.</doc>
<type name="guint8" c:type="guint8*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">the size of the data in bytes</doc>
<type name="gsize" c:type="gsize*"/>
</parameter>
</parameters>
</method>
<method name="take_all_data_as_buffer" c:identifier="gst_harness_take_all_data_as_buffer" version="1.14">
<doc xml:space="preserve">Pulls all pending data from the harness and returns it as a single buffer.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">the data as a buffer. Unref with gst_buffer_unref()
when no longer needed.</doc>
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="take_all_data_as_bytes" c:identifier="gst_harness_take_all_data_as_bytes" shadows="take_all_data" version="1.14">
<doc xml:space="preserve">Pulls all pending data from the harness and returns it as a single #GBytes.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a pointer to the data, newly allocated. Free
with g_free() when no longer needed.</doc>
<type name="GLib.Bytes" c:type="GBytes*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="teardown" c:identifier="gst_harness_teardown" version="1.6">
<doc xml:space="preserve">Tears down a @GstHarness, freeing all resources allocated using it.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="try_pull" c:identifier="gst_harness_try_pull" version="1.6">
<doc xml:space="preserve">Pulls a #GstBuffer from the #GAsyncQueue on the #GstHarness sinkpad. Unlike
gst_harness_pull this will not wait for any buffers if not any are present,
and return %NULL straight away.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstBuffer or %NULL if no buffers are present in the #GAsyncQueue</doc>
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="try_pull_event" c:identifier="gst_harness_try_pull_event" version="1.6">
<doc xml:space="preserve">Pulls an #GstEvent from the #GAsyncQueue on the #GstHarness sinkpad.
See gst_harness_try_pull for details.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstEvent or %NULL if no buffers are present in the #GAsyncQueue</doc>
<type name="Gst.Event" c:type="GstEvent*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="try_pull_upstream_event" c:identifier="gst_harness_try_pull_upstream_event" version="1.6">
<doc xml:space="preserve">Pulls an #GstEvent from the #GAsyncQueue on the #GstHarness srcpad.
See gst_harness_try_pull for details.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstEvent or %NULL if no buffers are present in the #GAsyncQueue</doc>
<type name="Gst.Event" c:type="GstEvent*"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="upstream_events_in_queue" c:identifier="gst_harness_upstream_events_in_queue" version="1.6">
<doc xml:space="preserve">The number of #GstEvents currently in the #GstHarness srcpad #GAsyncQueue
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #guint number of events in the queue</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="upstream_events_received" c:identifier="gst_harness_upstream_events_received" version="1.6">
<doc xml:space="preserve">The total number of #GstEvents that has arrived on the #GstHarness srcpad
This number includes events handled by the harness as well as events
that have already been pulled out.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #guint number of events received</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="use_systemclock" c:identifier="gst_harness_use_systemclock" version="1.6">
<doc xml:space="preserve">Sets the system #GstClock on the @GstHarness #GstElement
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="use_testclock" c:identifier="gst_harness_use_testclock" version="1.6">
<doc xml:space="preserve">Sets the #GstTestClock on the #GstHarness #GstElement
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
</parameters>
</method>
<method name="wait_for_clock_id_waits" c:identifier="gst_harness_wait_for_clock_id_waits" version="1.6">
<doc xml:space="preserve">Waits for @timeout seconds until @waits number of #GstClockID waits is
registered with the #GstTestClock. Useful for writing deterministic tests,
where you want to make sure that an expected number of waits have been
reached.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a @gboolean %TRUE if the waits have been registered, %FALSE if not.
(Could be that it timed out waiting or that more waits than waits was found)</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</instance-parameter>
<parameter name="waits" transfer-ownership="none">
<doc xml:space="preserve">a #guint describing the numbers of #GstClockID registered with
the #GstTestClock</doc>
<type name="guint" c:type="guint"/>
</parameter>
<parameter name="timeout" transfer-ownership="none">
<doc xml:space="preserve">a #guint describing how many seconds to wait for @waits to be true</doc>
<type name="guint" c:type="guint"/>
</parameter>
</parameters>
</method>
<function name="new" c:identifier="gst_harness_new" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness. Works like gst_harness_new_with_padnames(), except it
assumes the #GstElement sinkpad is named "sink" and srcpad is named "src"
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing the #GstElement name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="new_empty" c:identifier="gst_harness_new_empty" version="1.8" introspectable="0">
<doc xml:space="preserve">Creates a new empty harness. Use gst_harness_add_element_full() to add
an #GstElement to it.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
</function>
<function name="new_full" c:identifier="gst_harness_new_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element" transfer-ownership="none">
<doc xml:space="preserve">a #GstElement to attach the harness to (transfer none)</doc>
<type name="Gst.Element" c:type="GstElement*"/>
</parameter>
<parameter name="hsrc" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness srcpad.
%NULL will not create a harness srcpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
<parameter name="element_sinkpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
sinkpad that is then linked to the harness srcpad. Can be a static or request
or a sometimes pad that has been added. %NULL will not get/request a sinkpad
from the element. (Like if the element is a src.)</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="hsink" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness sinkpad.
%NULL will not create a harness sinkpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
<parameter name="element_srcpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
srcpad that is then linked to the harness sinkpad, similar to the
@element_sinkpad_name.</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="new_parse" c:identifier="gst_harness_new_parse" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness, parsing the @launchline and putting that in a #GstBin,
and then attches the harness to the bin.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="launchline" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing a gst-launch type line</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="new_with_element" c:identifier="gst_harness_new_with_element" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness. Works in the same way as gst_harness_new_full(), only
that generic padtemplates are used for the harness src and sinkpads, which
will be sufficient in most usecases.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element" transfer-ownership="none">
<doc xml:space="preserve">a #GstElement to attach the harness to (transfer none)</doc>
<type name="Gst.Element" c:type="GstElement*"/>
</parameter>
<parameter name="element_sinkpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
sinkpad that is then linked to the harness srcpad. %NULL does not attach a
sinkpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="element_srcpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
srcpad that is then linked to the harness sinkpad. %NULL does not attach a
srcpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="new_with_padnames" c:identifier="gst_harness_new_with_padnames" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness. Works like gst_harness_new_with_element(),
except you specify the factoryname of the #GstElement
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing the #GstElement name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="element_sinkpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
sinkpad that is then linked to the harness srcpad. %NULL does not attach a
sinkpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="element_srcpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
srcpad that is then linked to the harness sinkpad. %NULL does not attach a
srcpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="new_with_templates" c:identifier="gst_harness_new_with_templates" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness, like gst_harness_new_full(), except it
assumes the #GstElement sinkpad is named "sink" and srcpad is named "src"
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing the #GstElement name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="hsrc" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness srcpad.
%NULL will not create a harness srcpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
<parameter name="hsink" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness sinkpad.
%NULL will not create a harness sinkpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
</parameters>
</function>
<function name="stress_thread_stop" c:identifier="gst_harness_stress_thread_stop" version="1.6">
<doc xml:space="preserve">Stop the running #GstHarnessThread
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<parameter name="t" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</parameter>
</parameters>
</function>
</record>
<callback name="HarnessPrepareBufferFunc" c:type="GstHarnessPrepareBufferFunc" version="1.6">
<return-value transfer-ownership="full">
<type name="Gst.Buffer" c:type="GstBuffer*"/>
</return-value>
<parameters>
<parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">user data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</callback>
<callback name="HarnessPrepareEventFunc" c:type="GstHarnessPrepareEventFunc" version="1.8">
<return-value transfer-ownership="full">
<type name="Gst.Event" c:type="GstEvent*"/>
</return-value>
<parameters>
<parameter name="h" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarness</doc>
<type name="Harness" c:type="GstHarness*"/>
</parameter>
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">user data</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</callback>
<record name="HarnessPrivate" c:type="GstHarnessPrivate" disguised="1">
</record>
<record name="HarnessThread" c:type="GstHarnessThread" disguised="1" version="1.6">
<doc xml:space="preserve">Opaque handle representing a GstHarness stress testing thread.</doc>
</record>
<record name="StreamConsistency" c:type="GstStreamConsistency" disguised="1">
<doc xml:space="preserve">Opaque consistency checker handle.</doc>
</record>
<class name="TestClock" c:symbol-prefix="test_clock" c:type="GstTestClock" version="1.2" parent="Gst.Clock" glib:type-name="GstTestClock" glib:get-type="gst_test_clock_get_type" glib:type-struct="TestClockClass">
<doc xml:space="preserve">GstTestClock is an implementation of #GstClock which has different
behaviour compared to #GstSystemClock. Time for #GstSystemClock advances
according to the system time, while time for #GstTestClock changes only
when gst_test_clock_set_time() or gst_test_clock_advance_time() are
called. #GstTestClock provides unit tests with the possibility to
precisely advance the time in a deterministic manner, independent of the
system time or any other external factors.
## Advancing the time of a #GstTestClock
|[&lt;!-- language="C" --&gt;
#include &lt;gst/gst.h&gt;
#include &lt;gst/check/gsttestclock.h&gt;
GstClock *clock;
GstTestClock *test_clock;
clock = gst_test_clock_new ();
test_clock = GST_TEST_CLOCK (clock);
GST_INFO ("Time: %" GST_TIME_FORMAT, GST_TIME_ARGS (gst_clock_get_time (clock)));
gst_test_clock_advance_time ( test_clock, 1 * GST_SECOND);
GST_INFO ("Time: %" GST_TIME_FORMAT, GST_TIME_ARGS (gst_clock_get_time (clock)));
g_usleep (10 * G_USEC_PER_SEC);
GST_INFO ("Time: %" GST_TIME_FORMAT, GST_TIME_ARGS (gst_clock_get_time (clock)));
gst_test_clock_set_time (test_clock, 42 * GST_SECOND);
GST_INFO ("Time: %" GST_TIME_FORMAT, GST_TIME_ARGS (gst_clock_get_time (clock)));
...
]|
#GstClock allows for setting up single shot or periodic clock notifications
as well as waiting for these notifications synchronously (using
gst_clock_id_wait()) or asynchronously (using gst_clock_id_wait_async() or
gst_clock_id_wait_async()). This is used by many GStreamer elements,
among them #GstBaseSrc and #GstBaseSink.
#GstTestClock keeps track of these clock notifications. By calling
gst_test_clock_wait_for_next_pending_id() or
gst_test_clock_wait_for_multiple_pending_ids() a unit tests may wait for the
next one or several clock notifications to be requested. Additionally unit
tests may release blocked waits in a controlled fashion by calling
gst_test_clock_process_next_clock_id(). This way a unit test can control the
inaccuracy (jitter) of clock notifications, since the test can decide to
release blocked waits when the clock time has advanced exactly to, or past,
the requested clock notification time.
There are also interfaces for determining if a notification belongs to a
#GstTestClock or not, as well as getting the number of requested clock
notifications so far.
N.B.: When a unit test waits for a certain amount of clock notifications to
be requested in gst_test_clock_wait_for_next_pending_id() or
gst_test_clock_wait_for_multiple_pending_ids() then these functions may block
for a long time. If they block forever then the expected clock notifications
were never requested from #GstTestClock, and so the assumptions in the code
of the unit test are wrong. The unit test case runner in gstcheck is
expected to catch these cases either by the default test case timeout or the
one set for the unit test by calling tcase_set_timeout\(\).
The sample code below assumes that the element under test will delay a
buffer pushed on the source pad by some latency until it arrives on the sink
pad. Moreover it is assumed that the element will at some point call
gst_clock_id_wait() to synchronously wait for a specific time. The first
buffer sent will arrive exactly on time only delayed by the latency. The
second buffer will arrive a little late (7ms) due to simulated jitter in the
clock notification.
## Demonstration of how to work with clock notifications and #GstTestClock
|[&lt;!-- language="C" --&gt;
#include &lt;gst/gst.h&gt;
#include &lt;gst/check/gstcheck.h&gt;
#include &lt;gst/check/gsttestclock.h&gt;
GstClockTime latency;
GstElement *element;
GstPad *srcpad;
GstClock *clock;
GstTestClock *test_clock;
GstBuffer buf;
GstClockID pending_id;
GstClockID processed_id;
latency = 42 * GST_MSECOND;
element = create_element (latency, ...);
srcpad = get_source_pad (element);
clock = gst_test_clock_new ();
test_clock = GST_TEST_CLOCK (clock);
gst_element_set_clock (element, clock);
GST_INFO ("Set time, create and push the first buffer\n");
gst_test_clock_set_time (test_clock, 0);
buf = create_test_buffer (gst_clock_get_time (clock), ...);
gst_assert_cmpint (gst_pad_push (srcpad, buf), ==, GST_FLOW_OK);
GST_INFO ("Block until element is waiting for a clock notification\n");
gst_test_clock_wait_for_next_pending_id (test_clock, &amp;pending_id);
GST_INFO ("Advance to the requested time of the clock notification\n");
gst_test_clock_advance_time (test_clock, latency);
GST_INFO ("Release the next blocking wait and make sure it is the one from element\n");
processed_id = gst_test_clock_process_next_clock_id (test_clock);
g_assert (processed_id == pending_id);
g_assert_cmpint (GST_CLOCK_ENTRY_STATUS (processed_id), ==, GST_CLOCK_OK);
gst_clock_id_unref (pending_id);
gst_clock_id_unref (processed_id);
GST_INFO ("Validate that element produced an output buffer and check its timestamp\n");
g_assert_cmpint (get_number_of_output_buffer (...), ==, 1);
buf = get_buffer_pushed_by_element (element, ...);
g_assert_cmpint (GST_BUFFER_TIMESTAMP (buf), ==, latency);
gst_buffer_unref (buf);
GST_INFO ("Check that element does not wait for any clock notification\n");
g_assert (!gst_test_clock_peek_next_pending_id (test_clock, NULL));
GST_INFO ("Set time, create and push the second buffer\n");
gst_test_clock_advance_time (test_clock, 10 * GST_SECOND);
buf = create_test_buffer (gst_clock_get_time (clock), ...);
gst_assert_cmpint (gst_pad_push (srcpad, buf), ==, GST_FLOW_OK);
GST_INFO ("Block until element is waiting for a new clock notification\n");
(gst_test_clock_wait_for_next_pending_id (test_clock, &amp;pending_id);
GST_INFO ("Advance past 7ms beyond the requested time of the clock notification\n");
gst_test_clock_advance_time (test_clock, latency + 7 * GST_MSECOND);
GST_INFO ("Release the next blocking wait and make sure it is the one from element\n");
processed_id = gst_test_clock_process_next_clock_id (test_clock);
g_assert (processed_id == pending_id);
g_assert_cmpint (GST_CLOCK_ENTRY_STATUS (processed_id), ==, GST_CLOCK_OK);
gst_clock_id_unref (pending_id);
gst_clock_id_unref (processed_id);
GST_INFO ("Validate that element produced an output buffer and check its timestamp\n");
g_assert_cmpint (get_number_of_output_buffer (...), ==, 1);
buf = get_buffer_pushed_by_element (element, ...);
g_assert_cmpint (GST_BUFFER_TIMESTAMP (buf), ==,
10 * GST_SECOND + latency + 7 * GST_MSECOND);
gst_buffer_unref (buf);
GST_INFO ("Check that element does not wait for any clock notification\n");
g_assert (!gst_test_clock_peek_next_pending_id (test_clock, NULL));
...
]|
Since #GstTestClock is only supposed to be used in unit tests it calls
g_assert(), g_assert_cmpint() or g_assert_cmpuint() to validate all function
arguments. This will highlight any issues with the unit test code itself.</doc>
<constructor name="new" c:identifier="gst_test_clock_new" version="1.2">
<doc xml:space="preserve">Creates a new test clock with its time set to zero.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstTestClock cast to #GstClock.</doc>
<type name="Gst.Clock" c:type="GstClock*"/>
</return-value>
</constructor>
<constructor name="new_with_start_time" c:identifier="gst_test_clock_new_with_start_time" version="1.2">
<doc xml:space="preserve">Creates a new test clock with its time set to the specified time.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstTestClock cast to #GstClock.</doc>
<type name="Gst.Clock" c:type="GstClock*"/>
</return-value>
<parameters>
<parameter name="start_time" transfer-ownership="none">
<doc xml:space="preserve">a #GstClockTime set to the desired start time of the clock.</doc>
<type name="Gst.ClockTime" c:type="GstClockTime"/>
</parameter>
</parameters>
</constructor>
<function name="id_list_get_latest_time" c:identifier="gst_test_clock_id_list_get_latest_time" version="1.4">
<doc xml:space="preserve">Finds the latest time inside the list.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="Gst.ClockTime" c:type="GstClockTime"/>
</return-value>
<parameters>
<parameter name="pending_list" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">List
of of pending #GstClockIDs</doc>
<type name="GLib.List" c:type="const GList*">
<type name="Gst.ClockID"/>
</type>
</parameter>
</parameters>
</function>
<method name="advance_time" c:identifier="gst_test_clock_advance_time" version="1.2">
<doc xml:space="preserve">Advances the time of the @test_clock by the amount given by @delta. The
time of @test_clock is monotonically increasing, therefore providing a
@delta which is negative or zero is a programming error.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">a #GstTestClock for which to increase the time</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="delta" transfer-ownership="none">
<doc xml:space="preserve">a positive #GstClockTimeDiff to be added to the time of the clock</doc>
<type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/>
</parameter>
</parameters>
</method>
<method name="crank" c:identifier="gst_test_clock_crank" version="1.8">
<doc xml:space="preserve">A "crank" consists of three steps:
1: Wait for a #GstClockID to be registered with the #GstTestClock.
2: Advance the #GstTestClock to the time the #GstClockID is waiting for.
3: Release the #GstClockID wait.
A "crank" can be though of as the notion of
manually driving the clock forward to its next logical step.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE if the crank was successful, %FALSE otherwise.
MT safe.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">#GstTestClock to crank</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
</parameters>
</method>
<method name="get_next_entry_time" c:identifier="gst_test_clock_get_next_entry_time" version="1.2">
<doc xml:space="preserve">Retrieve the requested time for the next pending clock notification.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a #GstClockTime set to the time of the next pending clock
notification. If no clock notifications have been requested
%GST_CLOCK_TIME_NONE will be returned.</doc>
<type name="Gst.ClockTime" c:type="GstClockTime"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">a #GstTestClock to fetch the next clock notification time for</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
</parameters>
</method>
<method name="has_id" c:identifier="gst_test_clock_has_id" version="1.2">
<doc xml:space="preserve">Checks whether @test_clock was requested to provide the clock notification
given by @id.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE if the clock has been asked to provide the given clock
notification, %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">a #GstTestClock to ask if it provided the notification</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="id" transfer-ownership="none">
<doc xml:space="preserve">a #GstClockID clock notification</doc>
<type name="Gst.ClockID" c:type="GstClockID"/>
</parameter>
</parameters>
</method>
<method name="peek_id_count" c:identifier="gst_test_clock_peek_id_count" version="1.2">
<doc xml:space="preserve">Determine the number of pending clock notifications that have been
requested from the @test_clock.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the number of pending clock notifications.</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">a #GstTestClock for which to count notifications</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
</parameters>
</method>
<method name="peek_next_pending_id" c:identifier="gst_test_clock_peek_next_pending_id" version="1.2">
<doc xml:space="preserve">Determines if the @pending_id is the next clock notification scheduled to
be triggered given the current time of the @test_clock.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE if @pending_id is the next clock notification to be
triggered, %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">a #GstTestClock to check the clock notifications for</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="pending_id" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
<doc xml:space="preserve">a #GstClockID clock
notification to look for</doc>
<type name="Gst.ClockID" c:type="GstClockID*"/>
</parameter>
</parameters>
</method>
<method name="process_id_list" c:identifier="gst_test_clock_process_id_list" version="1.4">
<doc xml:space="preserve">Processes and releases the pending IDs in the list.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">#GstTestClock for which to process the pending IDs</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="pending_list" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">List
of pending #GstClockIDs</doc>
<type name="GLib.List" c:type="const GList*">
<type name="Gst.ClockID"/>
</type>
</parameter>
</parameters>
</method>
<method name="process_next_clock_id" c:identifier="gst_test_clock_process_next_clock_id" version="1.2">
<doc xml:space="preserve">MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstClockID containing the next pending clock
notification.</doc>
<type name="Gst.ClockID" c:type="GstClockID"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">a #GstTestClock for which to retrieve the next pending clock
notification</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
</parameters>
</method>
<method name="set_time" c:identifier="gst_test_clock_set_time" version="1.2">
<doc xml:space="preserve">Sets the time of @test_clock to the time given by @new_time. The time of
@test_clock is monotonically increasing, therefore providing a @new_time
which is earlier or equal to the time of the clock as given by
gst_clock_get_time() is a programming error.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">a #GstTestClock of which to set the time</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="new_time" transfer-ownership="none">
<doc xml:space="preserve">a #GstClockTime later than that returned by gst_clock_get_time()</doc>
<type name="Gst.ClockTime" c:type="GstClockTime"/>
</parameter>
</parameters>
</method>
<method name="timed_wait_for_multiple_pending_ids" c:identifier="gst_test_clock_timed_wait_for_multiple_pending_ids" version="1.16">
<doc xml:space="preserve">Blocks until at least @count clock notifications have been requested from
@test_clock, or the timeout expires.
MT safe.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a @gboolean %TRUE if the waits have been registered, %FALSE if not.
(Could be that it timed out waiting or that more waits than waits was found)</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">#GstTestClock for which to await having enough pending clock</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="count" transfer-ownership="none">
<doc xml:space="preserve">the number of pending clock notifications to wait for</doc>
<type name="guint" c:type="guint"/>
</parameter>
<parameter name="timeout_ms" transfer-ownership="none">
<doc xml:space="preserve">the timeout in milliseconds</doc>
<type name="guint" c:type="guint"/>
</parameter>
<parameter name="pending_list" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
<doc xml:space="preserve">Address
of a #GList pointer variable to store the list of pending #GstClockIDs
that expired, or %NULL</doc>
<type name="GLib.List" c:type="GList**">
<type name="Gst.ClockID"/>
</type>
</parameter>
</parameters>
</method>
<method name="wait_for_multiple_pending_ids" c:identifier="gst_test_clock_wait_for_multiple_pending_ids" version="1.4">
<doc xml:space="preserve">Blocks until at least @count clock notifications have been requested from
@test_clock. There is no timeout for this wait, see the main description of
#GstTestClock.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">#GstTestClock for which to await having enough pending clock</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="count" transfer-ownership="none">
<doc xml:space="preserve">the number of pending clock notifications to wait for</doc>
<type name="guint" c:type="guint"/>
</parameter>
<parameter name="pending_list" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
<doc xml:space="preserve">Address
of a #GList pointer variable to store the list of pending #GstClockIDs
that expired, or %NULL</doc>
<type name="GLib.List" c:type="GList**">
<type name="Gst.ClockID"/>
</type>
</parameter>
</parameters>
</method>
<method name="wait_for_next_pending_id" c:identifier="gst_test_clock_wait_for_next_pending_id" version="1.2">
<doc xml:space="preserve">Waits until a clock notification is requested from @test_clock. There is no
timeout for this wait, see the main description of #GstTestClock. A reference
to the pending clock notification is stored in @pending_id.
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">#GstTestClock for which to get the pending clock notification</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="pending_id" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
<doc xml:space="preserve">#GstClockID
with information about the pending clock notification</doc>
<type name="Gst.ClockID" c:type="GstClockID*"/>
</parameter>
</parameters>
</method>
<method name="wait_for_pending_id_count" c:identifier="gst_test_clock_wait_for_pending_id_count" version="1.2" deprecated="1">
<doc xml:space="preserve">Blocks until at least @count clock notifications have been requested from
@test_clock. There is no timeout for this wait, see the main description of
#GstTestClock.</doc>
<doc-deprecated xml:space="preserve">use gst_test_clock_wait_for_multiple_pending_ids() instead.</doc-deprecated>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="test_clock" transfer-ownership="none">
<doc xml:space="preserve">#GstTestClock for which to await having enough pending clock</doc>
<type name="TestClock" c:type="GstTestClock*"/>
</instance-parameter>
<parameter name="count" transfer-ownership="none">
<doc xml:space="preserve">the number of pending clock notifications to wait for</doc>
<type name="guint" c:type="guint"/>
</parameter>
</parameters>
</method>
<property name="clock-type" writable="1" transfer-ownership="none">
<type name="Gst.ClockType"/>
</property>
<property name="start-time" writable="1" construct-only="1" transfer-ownership="none">
<doc xml:space="preserve">When a #GstTestClock is constructed it will have a certain start time set.
If the clock was created using gst_test_clock_new_with_start_time() then
this property contains the value of the @start_time argument. If
gst_test_clock_new() was called the clock started at time zero, and thus
this property contains the value 0.</doc>
<type name="guint64" c:type="guint64"/>
</property>
<field name="parent">
<type name="Gst.Clock" c:type="GstClock"/>
</field>
<field name="priv" readable="0" private="1">
<type name="TestClockPrivate" c:type="GstTestClockPrivate*"/>
</field>
</class>
<record name="TestClockClass" c:type="GstTestClockClass" glib:is-gtype-struct-for="TestClock" version="1.2">
<doc xml:space="preserve">The class of a #GstTestClock, which has no virtual methods to override.</doc>
<field name="parent_class">
<doc xml:space="preserve">the parent class structure</doc>
<type name="Gst.ClockClass" c:type="GstClockClass"/>
</field>
</record>
<record name="TestClockPrivate" c:type="GstTestClockPrivate" disguised="1">
</record>
<function name="consistency_checker_add_pad" c:identifier="gst_consistency_checker_add_pad">
<doc xml:space="preserve">Sets up a data probe on the given pad which will raise assertions if the
data flow is inconsistent.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE if the pad was added</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="consist" transfer-ownership="none">
<doc xml:space="preserve">The #GstStreamConsistency handle</doc>
<type name="StreamConsistency" c:type="GstStreamConsistency*"/>
</parameter>
<parameter name="pad" transfer-ownership="none">
<doc xml:space="preserve">The #GstPad on which the dataflow will be checked.</doc>
<type name="Gst.Pad" c:type="GstPad*"/>
</parameter>
</parameters>
</function>
<function name="consistency_checker_free" c:identifier="gst_consistency_checker_free">
<doc xml:space="preserve">Frees the allocated data and probes associated with @consist.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="consist" transfer-ownership="none">
<doc xml:space="preserve">The #GstStreamConsistency to free.</doc>
<type name="StreamConsistency" c:type="GstStreamConsistency*"/>
</parameter>
</parameters>
</function>
<function name="consistency_checker_new" c:identifier="gst_consistency_checker_new" introspectable="0">
<doc xml:space="preserve">Sets up a data probe on the given pad which will raise assertions if the
data flow is inconsistent.</doc>
<return-value>
<doc xml:space="preserve">A #GstStreamConsistency structure used to track data flow.</doc>
<type name="StreamConsistency" c:type="GstStreamConsistency*"/>
</return-value>
<parameters>
<parameter name="pad" transfer-ownership="none">
<doc xml:space="preserve">The #GstPad on which the dataflow will be checked.</doc>
<type name="Gst.Pad" c:type="GstPad*"/>
</parameter>
</parameters>
</function>
<function name="consistency_checker_reset" c:identifier="gst_consistency_checker_reset">
<doc xml:space="preserve">Reset the stream checker's internal variables.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="consist" transfer-ownership="none">
<doc xml:space="preserve">The #GstStreamConsistency to reset.</doc>
<type name="StreamConsistency" c:type="GstStreamConsistency*"/>
</parameter>
</parameters>
</function>
<function name="harness_new" c:identifier="gst_harness_new" moved-to="Harness.new" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness. Works like gst_harness_new_with_padnames(), except it
assumes the #GstElement sinkpad is named "sink" and srcpad is named "src"
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing the #GstElement name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="harness_new_empty" c:identifier="gst_harness_new_empty" moved-to="Harness.new_empty" version="1.8" introspectable="0">
<doc xml:space="preserve">Creates a new empty harness. Use gst_harness_add_element_full() to add
an #GstElement to it.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
</function>
<function name="harness_new_full" c:identifier="gst_harness_new_full" moved-to="Harness.new_full" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element" transfer-ownership="none">
<doc xml:space="preserve">a #GstElement to attach the harness to (transfer none)</doc>
<type name="Gst.Element" c:type="GstElement*"/>
</parameter>
<parameter name="hsrc" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness srcpad.
%NULL will not create a harness srcpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
<parameter name="element_sinkpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
sinkpad that is then linked to the harness srcpad. Can be a static or request
or a sometimes pad that has been added. %NULL will not get/request a sinkpad
from the element. (Like if the element is a src.)</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="hsink" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness sinkpad.
%NULL will not create a harness sinkpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
<parameter name="element_srcpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
srcpad that is then linked to the harness sinkpad, similar to the
@element_sinkpad_name.</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="harness_new_parse" c:identifier="gst_harness_new_parse" moved-to="Harness.new_parse" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness, parsing the @launchline and putting that in a #GstBin,
and then attches the harness to the bin.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="launchline" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing a gst-launch type line</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="harness_new_with_element" c:identifier="gst_harness_new_with_element" moved-to="Harness.new_with_element" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness. Works in the same way as gst_harness_new_full(), only
that generic padtemplates are used for the harness src and sinkpads, which
will be sufficient in most usecases.
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element" transfer-ownership="none">
<doc xml:space="preserve">a #GstElement to attach the harness to (transfer none)</doc>
<type name="Gst.Element" c:type="GstElement*"/>
</parameter>
<parameter name="element_sinkpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
sinkpad that is then linked to the harness srcpad. %NULL does not attach a
sinkpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="element_srcpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
srcpad that is then linked to the harness sinkpad. %NULL does not attach a
srcpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="harness_new_with_padnames" c:identifier="gst_harness_new_with_padnames" moved-to="Harness.new_with_padnames" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness. Works like gst_harness_new_with_element(),
except you specify the factoryname of the #GstElement
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing the #GstElement name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="element_sinkpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
sinkpad that is then linked to the harness srcpad. %NULL does not attach a
sinkpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="element_srcpad_name" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #gchar with the name of the element
srcpad that is then linked to the harness sinkpad. %NULL does not attach a
srcpad</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="harness_new_with_templates" c:identifier="gst_harness_new_with_templates" moved-to="Harness.new_with_templates" version="1.6" introspectable="0">
<doc xml:space="preserve">Creates a new harness, like gst_harness_new_full(), except it
assumes the #GstElement sinkpad is named "sink" and srcpad is named "src"
MT safe.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GstHarness, or %NULL if the harness could
not be created</doc>
<type name="Harness" c:type="GstHarness*"/>
</return-value>
<parameters>
<parameter name="element_name" transfer-ownership="none">
<doc xml:space="preserve">a #gchar describing the #GstElement name</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="hsrc" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness srcpad.
%NULL will not create a harness srcpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
<parameter name="hsink" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GstStaticPadTemplate describing the harness sinkpad.
%NULL will not create a harness sinkpad.</doc>
<type name="Gst.StaticPadTemplate" c:type="GstStaticPadTemplate*"/>
</parameter>
</parameters>
</function>
<function name="harness_stress_thread_stop" c:identifier="gst_harness_stress_thread_stop" moved-to="Harness.stress_thread_stop" version="1.6">
<doc xml:space="preserve">Stop the running #GstHarnessThread
MT safe.</doc>
<return-value transfer-ownership="none">
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<parameter name="t" transfer-ownership="none">
<doc xml:space="preserve">a #GstHarnessThread</doc>
<type name="HarnessThread" c:type="GstHarnessThread*"/>
</parameter>
</parameters>
</function>
</namespace>
</repository>