element: Clarify docs about gst_element_get_request_pad() and remove deprecation part

This function is not really pad or slow for the common case of requesting a
pad with the name of the template. It is only slower if you to name your pads
directly instead of letting the element handle it.

Also there's no reason to deprecate it in favor of a more complicated function
for the common case.
This commit is contained in:
Sebastian Dröge 2014-08-13 12:37:08 +03:00
parent ee662efdd1
commit 82e01491a0

View file

@ -975,8 +975,9 @@ _gst_element_request_pad (GstElement * element, GstPadTemplate * templ,
* retrieves request pads. The pad should be released with * retrieves request pads. The pad should be released with
* gst_element_release_request_pad(). * gst_element_release_request_pad().
* *
* This method is slow and will be deprecated in the future. New code should * This method is slower than manually getting the pad template and calling
* use gst_element_request_pad() with the requested template. * gst_element_request_pad() if the pads should have a specific name (e.g.
* @name is "src_1" instead of "src_%u").
* *
* Returns: (transfer full) (nullable): requested #GstPad if found, * Returns: (transfer full) (nullable): requested #GstPad if found,
* otherwise %NULL. Release after usage. * otherwise %NULL. Release after usage.