summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: a3611c1)
raw | patch | inline | side by side (parent: a3611c1)
author | Stefan Kost <ensonic@users.sf.net> | |
Sat, 20 Aug 2011 12:07:55 +0000 (14:07 +0200) | ||
committer | Stefan Kost <ensonic@users.sf.net> | |
Sat, 20 Aug 2011 12:07:55 +0000 (14:07 +0200) |
Don't suggest deprecated method in the desction docs and try to be more helpful
in other places by suggesting related functions.
in other places by suggesting related functions.
gst/gstelement.c | patch | blob | history |
diff --git a/gst/gstelement.c b/gst/gstelement.c
index ac13720660823d9ad27db8dd74635e3dcee7ddcf..17c0c61bb243a1dc232a74ca9bc254a8aea686ef 100644 (file)
--- a/gst/gstelement.c
+++ b/gst/gstelement.c
* Core and plug-in writers can add and remove pads with gst_element_add_pad()
* and gst_element_remove_pad().
*
- * A pad of an element can be retrieved by name with gst_element_get_pad().
+ * An existing pad of an element can be retrieved by name with
+ * gst_element_get_static_pad(). A new dynamic pad can be created using
+ * gst_element_request_pad() with a #GstPadTemplate or
+ * gst_element_get_request_pad() with the template name such as "src_%d".
* An iterator of all pads can be retrieved with gst_element_iterate_pads().
*
* Elements can be linked through their pads.
* request. Can be %NULL.
*
* Retrieves a request pad from the element according to the provided template.
+ * Pad templates can be looked up using
+ * gst_element_factory_get_static_pad_templates().
*
* If the @caps are specified and the element implements thew new
* request_new_pad_full virtual method, the element will use them to select
* gst_element_iterate_pads:
* @element: a #GstElement to iterate pads of.
*
- * Retrieves an iterattor of @element's pads. The iterator should
- * be freed after usage.
+ * Retrieves an iterator of @element's pads. The iterator should
+ * be freed after usage. Also more specialized iterators exists such as
+ * gst_element_iterate_src_pads() or gst_element_iterate_sink_pads().
*
* Returns: (transfer full): the #GstIterator of #GstPad. Unref each pad
* after use.