mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2025-02-17 03:35:21 +00:00
Code Issues 1 Projects Releases Wiki Activity

docs/manual/: Some Application Development Manual fixes thanks to

Browse source 
Original commit message from CVS:
* docs/manual/advanced-position.xml:
* docs/manual/basics-bins.xml:
* docs/manual/basics-bus.xml:
* docs/manual/basics-pads.xml:
* docs/manual/intro-gstreamer.xml:
* docs/manual/intro-preface.xml:
Some Application Development Manual fixes thanks to
Andrew Feren. Fixes #558459.
This commit is contained in:
Wim Taymans 2008-11-04 11:55:08 +00:00
parent 1d61cb0381
commit c6cc3bbca8
7 changed files with 36 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
ChangeLog
View file

@ -1,3 +1,14 @@
2008-11-04 Wim Taymans <wim.taymans@collabora.co.uk>
* docs/manual/advanced-position.xml:
* docs/manual/basics-bins.xml:
* docs/manual/basics-bus.xml:
* docs/manual/basics-pads.xml:
* docs/manual/intro-gstreamer.xml:
* docs/manual/intro-preface.xml:
Some Application Development Manual fixes thanks to
Andrew Feren. Fixes #558459.
2008-11-03 Stefan Kost <ensonic@users.sf.net>
* gst/gstregistrybinary.c:

19
docs/manual/advanced-position.xml
View file

@ -192,10 +192,21 @@ seek_to_time (GstElement *pipeline,
}
</programlisting>
<para>
Seeks should usually be done when the pipeline is in PAUSED or PLAYING
state (when it is in PLAYING state the pipeline will pause itself, issue
the seek, and then set itself back to PLAYING again itself).
returns.
Seeks with the GST_SEEK_FLAG_FLUSH should be done when the pipeline is
in PAUSED or PLAYING state. The pipeline will automatically go to preroll
state until the new data after the seek will cause the pipeline to preroll
again. After the pipeline is prerolled, it will go back to the state
(PAUSED or PLAYING) it was in when the seek was executed. You can wait
(blocking) for the seek to complete with
<function>gst_element_get_state()</function> or by waiting for the
ASYNC_DONE message to appear on the bus.
</para>
<para>
Seeks without the GST_SEEK_FLAG_FLUSH should only be done when the
pipeline is in the PLAYING state. Executing a non-flushing seek in the
PAUSED state might deadlock because the pipeline streaming threads might
be blocked in the sinks.
</para>
<para>

7
docs/manual/basics-bins.xml
View file

@ -79,13 +79,16 @@ main (int argc,
/* create */
pipeline = gst_pipeline_new ("my_pipeline");
bin = gst_pipeline_new ("my_bin");
bin = gst_bin_new ("my_bin");
source = gst_element_factory_make ("fakesrc", "source");
sink = gst_element_factory_make ("fakesink", "sink");
/* set up pipeline */
/* First add the elements to the bin */
gst_bin_add_many (GST_BIN (bin), source, sink, NULL);
/* add the bin to the pipeline */
gst_bin_add (GST_BIN (pipeline), bin);
/* link the elements */
gst_element_link (source, sink);
<!-- example-end bin.c a -->
[..]<!-- example-begin bin.c b --><!--

2
docs/manual/basics-bus.xml
View file

@ -127,7 +127,7 @@ main (gint argc,
/* clean up */
gst_element_set_state (pipeline, GST_STATE_NULL);
gst_object_unref (pipeline);
g_main_loop_unref (loop)
g_main_loop_unref (loop);
return 0;
}

3
docs/manual/basics-pads.xml
View file

@ -544,7 +544,8 @@ link_elements_with_filter (GstElement *element1, GstElement *element2)
gst_element_link_filtered ()</function> it will automatically create
a <classname>capsfilter</classname> element for you and insert it into
your bin or pipeline between the two elements you want to connect (this
is important if you ever want to disconnect those elements).
is important if you ever want to disconnect those elements because then
you will have to disconnect both elements from the capsfilter instead).
</para>
<para>
In some cases, you will want to create a more elaborate set of

2
docs/manual/intro-gstreamer.xml
View file

@ -54,7 +54,7 @@
<listitem><para>an API for multimedia applications</para></listitem>
<listitem><para>a plugin architecture</para></listitem>
<listitem><para>a pipeline architecture</para></listitem>
<listitem><para>a mechanism for media type handling/negociation</para></listitem>
<listitem><para>a mechanism for media type handling/negotiation</para></listitem>
<listitem><para>over 150 plug-ins</para></listitem>
<listitem><para>a set of tools</para></listitem>
</itemizedlist>

2
docs/manual/intro-preface.xml
View file

@ -32,7 +32,7 @@
Especially,
<itemizedlist>
<listitem><para>GObject instentiation</para></listitem>
<listitem><para>GObject instantiation</para></listitem>
<listitem><para>GObject properties (set/get)</para></listitem>
<listitem><para>GObject casting</para></listitem>
<listitem><para>GObject referecing/dereferencing</para></listitem>