mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-07-31 10:45:08 +00:00
Code Issues 1 Projects Releases Wiki Activity

harness: minor doc fixes

Browse source
This commit is contained in:
Tim-Philipp Müller 2015-09-26 11:03:24 +01:00
parent 44ba1565d9
commit cc217289a7
1 changed files with 13 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
libs/gst/check/gstharness.c
View file

@ -23,11 +23,11 @@
* @short_description: A test-harness for writing GStreamer unit tests * @short_description: A test-harness for writing GStreamer unit tests
* @see_also: #GstTestClock,\ * @see_also: #GstTestClock,\
* *
* #GstHarness is ment to make writing unit test for GStreamer much easier. * #GstHarness is meant to make writing unit test for GStreamer much easier.
* It can be though of as a way of treating a #GstElement as a black box, * It can be thought of as a way of treating a #GstElement as a black box,
* deterministially feeding it data, and controlling what data it outputs. * deterministically feeding it data, and controlling what data it outputs.
* *
* The basic structure of #GstHarness is two "floating" #GstPads, that connects * The basic structure of #GstHarness is two "floating" #GstPads that connect
* to the harnessed #GstElement src and sink #GstPads like so: * to the harnessed #GstElement src and sink #GstPads like so:
* *
* <programlisting> * <programlisting>
@ -42,17 +42,17 @@
* *
* With this, you can now simulate any environment the #GstElement might find * With this, you can now simulate any environment the #GstElement might find
* itself in. By specifying the #GstCaps of the harness #GstPads, using * 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, * functions like gst_harness_set_src_caps() or gst_harness_set_sink_caps_str(),
* you can test how the #GstElement interacts with different capssets. * you can test how the #GstElement interacts with different caps sets.
* *
* Your harnessed #GstElement can of course also be a bin, and using * Your harnessed #GstElement can of course also be a bin, and using
* gst_harness_new_parse supporting standard gst-launch syntax, you can * gst_harness_new_parse() supporting standard gst-launch syntax, you can
* easily test a whole pipeline instead of just one element. * easily test a whole pipeline instead of just one element.
* *
* You can then go on to push #GstBuffers and #GstEvents on to the srcpad, * 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 * using functions like gst_harness_push() and gst_harness_push_event(), and
* then pull them out to examine them with gst_harness_pull and * then pull them out to examine them with gst_harness_pull() and
* gst_harness_pull_event. * gst_harness_pull_event().
* *
* <example> * <example>
* <title>A simple buffer-in buffer-out example</title> * <title>A simple buffer-in buffer-out example</title>
@ -92,14 +92,14 @@
* #GstTestClock. Operating the #GstTestClock can be very challenging, but * #GstTestClock. Operating the #GstTestClock can be very challenging, but
* #GstHarness simplifies some of the most desired actions a lot, like wanting * #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 * 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. * that is waiting, with functions like gst_harness_crank_single_clock_wait().
* *
* #GstHarness also supports sub-harnesses, as a way of generating and * #GstHarness also supports sub-harnesses, as a way of generating and
* validating data. A sub-harness is another #GstHarness that is managed by * validating data. A sub-harness is another #GstHarness that is managed by
* the "parent" harness, and can either be created by using the standard * the "parent" harness, and can either be created by using the standard
* gst_harness_new type functions directly on the (GstHarness *)->src_harness, * gst_harness_new type functions directly on the (GstHarness *)->src_harness,
* or using the much more convenient gst_harness_add_src or * 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, * 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 * (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 * src-element (videotestsrc) and an encoder (vp8enc) to feed the decoder data
* with different configurations, by simply doing: * with different configurations, by simply doing: