mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-12-23 08:46:40 +00:00
Code Issues 1 Projects Releases Wiki Activity

docs/pwg/: Update state change stuff for 0.10 (fixes #322969).

Browse source 
Original commit message from CVS:
* docs/pwg/building-chainfn.xml:
* docs/pwg/building-pads.xml:
* docs/pwg/building-state.xml:
* docs/pwg/other-source.xml:
Update state change stuff for 0.10 (fixes #322969).
This commit is contained in:
Tim-Philipp Müller 2005-12-11 18:24:27 +00:00
parent 30cfab511a
commit bce6eeb204
5 changed files with 45 additions and 24 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
ChangeLog
View file

@ -1,3 +1,11 @@
2005-12-11 Tim-Philipp Müller <tim at centricular dot net>
* docs/pwg/building-chainfn.xml:
* docs/pwg/building-pads.xml:
* docs/pwg/building-state.xml:
* docs/pwg/other-source.xml:
Update state change stuff for 0.10 (fixes #322969).
2005-12-11 Tim-Philipp Müller <tim at centricular dot net>
* docs/manual/advanced-dataaccess.xml:

12
docs/pwg/building-chainfn.xml
View file

@ -33,11 +33,11 @@ gst_my_filter_chain (GstPad *pad,
}
<!-- example-end chain.c b -->
<!-- example-begin chain.c c --><!--
static GstElementStateReturn
gst_my_filter_change_state (GstElement * element)
static GstStateChangeReturn
gst_my_filter_change_state (GstElement * element, GstStateChange transition)
{
return GST_CALL_PARENT_WITH_DEFAULT (GST_ELEMENT_CLASS,
change_state, (element), GST_STATE_SUCCESS);
change_state, (element, transition), GST_STATE_CHANGE_SUCCESS);
}
#include "register.func"
--><!-- example-end chain.c c --></programlisting>
@ -113,11 +113,11 @@ gst_my_filter_chain (GstPad *pad,
}
<!-- example-end chain.func b -->
<!-- example-begin chain2.c b --><!--
static GstElementStateReturn
gst_my_filter_change_state (GstElement * element)
static GstStateChangeReturn
gst_my_filter_change_state (GstElement * element, GstStateChange transition)
{
return GST_CALL_PARENT_WITH_DEFAULT (GST_ELEMENT_CLASS,
change_state, (element), GST_STATE_SUCCESS);
change_state, (element, transition), GST_STATE_CHANGE_SUCCESS);
}
#include "register.func"
--><!-- example-end chain2.c b --></programlisting>

10
docs/pwg/building-pads.xml
View file

@ -27,8 +27,8 @@
#include "filter.h"
#include &lt;string.h&gt;
static GstElementStateReturn
gst_my_filter_change_state (GstElement * element);
static GstStateChangeReturn
gst_my_filter_change_state (GstElement * element, GstStateChange transition);
GST_BOILERPLATE (GstMyFilter, gst_my_filter, GstElement, GST_TYPE_ELEMENT);
@ -217,11 +217,11 @@ gst_my_filter_chain (GstPad * pad, GstBuffer * buf)
return gst_pad_push (GST_MY_FILTER (GST_OBJECT_PARENT (pad))->srcpad, buf);
}
static GstElementStateReturn
gst_my_filter_change_state (GstElement * element)
static GstStateChangeReturn
gst_my_filter_change_state (GstElement * element, GstStateChange transition)
{
return GST_CALL_PARENT_WITH_DEFAULT (GST_ELEMENT_CLASS,
change_state, (element), GST_STATE_SUCCESS);
change_state, (element, transition), GST_STATE_CHANGE_SUCCESS);
}
#include "register.func"

10
docs/pwg/building-state.xml
View file

@ -131,7 +131,7 @@ gst_my_filter_free_memory (GstMyFilter * filter)
static GstStateChangeReturn
gst_my_filter_change_state (GstElement *element, GstStateChange transition)
{
GstElementStateReturn ret = GST_STATE_SUCCESS;
GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
GstMyFilter *filter = GST_MY_FILTER (element);
switch (transition) {
@ -144,6 +144,8 @@ gst_my_filter_change_state (GstElement *element, GstStateChange transition)
}
ret = GST_ELEMENT_CLASS (parent_class)-&gt;change_state (element, transition);
if (ret == GST_STATE_CHANGE_FAILURE)
return ret;
switch (transition) {
case GST_STATE_CHANGE_READY_TO_NULL:
@ -160,9 +162,9 @@ gst_my_filter_change_state (GstElement *element, GstStateChange transition)
#include "register.func"
--><!-- example-end state.c b --></programlisting>
<para>
Note that upwards (NULL=>READY, READY=>PAUSED, PAUSED=>PLAYING) and
downwards (PLAYING=>PAUSED, PAUSED=>READY, READY=>NULL) state changes
are handled in two separate blocks with the downwards state change
Note that upwards (NULL=&gt;READY, READY=&gt;PAUSED, PAUSED=&gt;PLAYING)
and downwards (PLAYING=&gt;PAUSED, PAUSED=&gt;READY, READY=&gt;NULL) state
changes are handled in two separate blocks with the downwards state change
handled only after we have chained up to the parent class's state
change function. This is necessary in order to safely handle concurrent
access by multiple threads.

29
docs/pwg/other-source.xml
View file

@ -299,24 +299,35 @@ gst_my_source_get (GstPad *pad)
return GST_DATA (buf);
}
static GstStateReturn
gst_my_source_change_state (GstElement *element)
static GstStateChangeReturn
gst_my_source_change_state (GstElement *element, GstStateChange transition)
{
GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
GstMySource *src = GST_MY_SOURCE (element);
switch (GST_STATE_PENDING (element)) {
case GT_STATE_PAUSED_TO_READY:
src->total_bytes = 0;
/* First, handle upwards state changes */
switch (transition) {
case GST_STATE_READY_TO_PAUSED:
/* do something */
break;
default:
break;
}
if (GST_ELEMENT_CLASS (parent_class)->change_state)
return GST_ELEMENT_CLASS (parent_class)->change_state (element);
ret = GST_ELEMENT_CLASS (parent_class)-&gt;change_state (element, transition);
if (ret == GST_STATE_CHANGE_FAILURE)
return ret;
return GST_STATE_SUCCESS;
/* Now handle downwards state changes after chaining up */
switch (transition) {
case GST_STATE_PAUSED_TO_READY:
src->total_bytes = 0;
break;
default:
break;
}
return ret;
}
</programlisting>
<para>