uridecodebin: Update autoplug-* signal docs from decodebin2

uridecodebin proxies these signals.
This commit is contained in:
Sebastian Dröge 2011-02-18 12:00:34 +01:00
parent ef5f73206d
commit da4b5bf9f9

View file

@ -456,8 +456,8 @@ gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
/** /**
* GstURIDecodeBin::unknown-type: * GstURIDecodeBin::unknown-type:
* @bin: The uridecodebin * @bin: The uridecodebin.
* @pad: the new pad containing caps that cannot be resolved to a 'final' * @pad: the new pad containing caps that cannot be resolved to a 'final'.
* stream type. * stream type.
* @caps: the #GstCaps of the pad that cannot be resolved. * @caps: the #GstCaps of the pad that cannot be resolved.
* *
@ -472,13 +472,19 @@ gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
/** /**
* GstURIDecodeBin::autoplug-continue: * GstURIDecodeBin::autoplug-continue:
* @bin: The uridecodebin * @bin: The uridecodebin.
* @pad: The #GstPad. * @pad: The #GstPad.
* @caps: The #GstCaps found. * @caps: The #GstCaps found.
* *
* This signal is emitted whenever uridecodebin finds a new stream. It is * This signal is emitted whenever uridecodebin finds a new stream. It is
* emitted before looking for any elements that can handle that stream. * emitted before looking for any elements that can handle that stream.
* *
* <note>
* Invocation of signal handlers stops after the first signal handler
* returns #FALSE. Signal handlers are invoked in the order they were
* connected in.
* </note>
*
* Returns: #TRUE if you wish uridecodebin to look for elements that can * Returns: #TRUE if you wish uridecodebin to look for elements that can
* handle the given @caps. If #FALSE, those caps will be considered as * handle the given @caps. If #FALSE, those caps will be considered as
* final and the pad will be exposed as such (see 'new-decoded-pad' * final and the pad will be exposed as such (see 'new-decoded-pad'
@ -493,7 +499,7 @@ gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
/** /**
* GstURIDecodeBin::autoplug-factories: * GstURIDecodeBin::autoplug-factories:
* @bin: The decodebin * @bin: The uridecodebin.
* @pad: The #GstPad. * @pad: The #GstPad.
* @caps: The #GstCaps found. * @caps: The #GstCaps found.
* *
@ -506,6 +512,12 @@ gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
* If this function returns an empty array, the pad will be considered as * If this function returns an empty array, the pad will be considered as
* having an unhandled type media type. * having an unhandled type media type.
* *
* <note>
* Only the signal handler that is connected first will ever by invoked.
* Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
* signal, they will never be invoked!
* </note>
*
* Returns: a #GValueArray* with a list of factories to try. The factories are * Returns: a #GValueArray* with a list of factories to try. The factories are
* by default tried in the returned order or based on the index returned by * by default tried in the returned order or based on the index returned by
* "autoplug-select". * "autoplug-select".
@ -519,7 +531,7 @@ gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
/** /**
* GstURIDecodeBin::autoplug-sort: * GstURIDecodeBin::autoplug-sort:
* @bin: The decodebin * @bin: The uridecodebin.
* @pad: The #GstPad. * @pad: The #GstPad.
* @caps: The #GstCaps. * @caps: The #GstCaps.
* @factories: A #GValueArray of possible #GstElementFactory to use. * @factories: A #GValueArray of possible #GstElementFactory to use.
@ -529,7 +541,16 @@ gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
* the application to perform additional sorting or filtering on the element * the application to perform additional sorting or filtering on the element
* factory array. * factory array.
* *
* The callee should copy and modify @factories. * The callee should copy and modify @factories or return #NULL if the
* order should not change.
*
* <note>
* Invocation of signal handlers stops after one signal handler has
* returned something else than #NULL. Signal handlers are invoked in
* the order they were connected in.
* Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
* signal, they will never be invoked!
* </note>
* *
* Returns: A new sorted array of #GstElementFactory objects. * Returns: A new sorted array of #GstElementFactory objects.
* *
@ -544,9 +565,10 @@ gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
/** /**
* GstURIDecodeBin::autoplug-select: * GstURIDecodeBin::autoplug-select:
* @bin: The uridecodebin.
* @pad: The #GstPad. * @pad: The #GstPad.
* @caps: The #GstCaps. * @caps: The #GstCaps.
* @factory: A #GstElementFactory to use * @factory: A #GstElementFactory to use.
* *
* This signal is emitted once uridecodebin has found all the possible * This signal is emitted once uridecodebin has found all the possible
* #GstElementFactory that can be used to handle the given @caps. For each of * #GstElementFactory that can be used to handle the given @caps. For each of
@ -564,6 +586,12 @@ gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
* A value of #GST_AUTOPLUG_SELECT_SKIP will skip @factory and move to the * A value of #GST_AUTOPLUG_SELECT_SKIP will skip @factory and move to the
* next factory. * next factory.
* *
* <note>
* Only the signal handler that is connected first will ever by invoked.
* Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
* signal, they will never be invoked!
* </note>
*
* Returns: a #GST_TYPE_AUTOPLUG_SELECT_RESULT that indicates the required * Returns: a #GST_TYPE_AUTOPLUG_SELECT_RESULT that indicates the required
* operation. The default handler will always return * operation. The default handler will always return
* #GST_AUTOPLUG_SELECT_TRY. * #GST_AUTOPLUG_SELECT_TRY.