GstPad Object contained by elements that allows links to other elements A #GstElement is linked to other elements via "pads", which are extremely light-weight generic link points. After two pads are retrieved from an element with gst_element_get_pad(), the pads can be link with gst_pad_link(). (For quick links, you can also use gst_element_link(), which will make the obvious link for you if it's straightforward.) Pads are typically created from a #GstPadTemplate with gst_pad_new_from_template(). Pads have #GstCaps attached to it to describe the media type they are capable of dealing with. gst_pad_get_caps() and gst_pad_try_set_caps() are used to manipulate the caps of the pads. Pads created from a pad template cannot set capabilities that are incompatible with the pad template capabilities. Pads without pad templates can be created with gst_pad_new(), which takes a direction and a name as an argument. If the name is NULL, then a guaranteed unique name will be assigned to it. gst_pad_get_parent() will retrieve the #GstElement that owns the pad. A #GstElement creating a pad will typically use the various gst_pad_set_*_function() calls to register callbacks for various events on the pads. GstElements will use gst_pad_push() and gst_pad_pull() to push out or pull in a buffer. gst_pad_select() and gst_pad_selectv() are used by plugins to wait for the first incoming buffer or event on any of the given set of pads. To send a #GstEvent on a pad, use gst_pad_send_event(). Last reviewed on December 13th, 2002 (0.5.0.1) #GstPadTemplate, #GstElement, #GstEvent @stream_rec_lock: @task: @preroll_lock: @preroll_cond: @block_cond: @block_callback: @block_data: @caps: @getcapsfunc: @setcapsfunc: @acceptcapsfunc: @fixatecapsfunc: @activatefunc: @activatepushfunc: @activatepullfunc: @linkfunc: @unlinkfunc: @peer: @sched_private: @chainfunc: @checkgetrangefunc: @getrangefunc: @eventfunc: @mode: @querytypefunc: @queryfunc: @intlinkfunc: @bufferallocfunc: @do_buffer_signals: @do_event_signals: @gstpad: the object which received the signal. @arg1: @Returns: @gstpad: the object which received the signal. @arg1: @gstpad: the object which received the signal. @gstpad: the object which received the signal. @arg1: Macro to test if the given #GstPadLinkReturn value indicates a failed negotiation step (REFUSED/DELAYED). @ret: the #GstPadLinkReturn value Macro to test if the given #GstPadLinkReturn value indicates a successfull negotiation step (OK/DONE). @ret: the #GstPadLinkReturn value A function that will be called when chaining buffers. @pad: the #GstPad that performed the chain. @buffer: @Returns: @data: @buf: the #GstBuffer that is chained. Function signature to handle an event for the pad. @pad: the #GstPad to handle the event. @event: the #GstEvent to handle. @Returns: TRUE if the pad could handle the event. The signature of the query function. @pad: the #GstPad to query. @query: @Returns: TRUE if the query could be performed. @type: the #GstPadQueryType. @format: a pointer to the target #GstFormat. @value: a pointer to the target value. The signature of the internal pad link function. @pad: The #GstPad to query. @Returns: a newly allocated #GList of pads that are linked to the given pad on the inside of the parent element. The caller must call g_list_free() on it after use. The signature of the query types function. @pad: a #GstPad to query @Returns: an array of query types Function signature to handle a new link on the pad. @pad: the #GstPad that is linked. @peer: @Returns: the result of the link with the specified caps. @caps: the peer's #GstCaps. @pad: Returns a copy of the capabilities of the specified pad. By default this function will return the pad template capabilities, but can optionally be overridden. @pad: the #GstPad to get the capabilities of. @Returns: a newly allocated copy #GstCaps of the pad. @caps: the peer's #GstCaps, can be used to filter the capabilities. @pad: @offset: @size: @caps: @buf: @Returns: A dispatcher function is called for all internally linked pads, see gst_pad_dispatcher(). @pad: the #GstPad that is dispatched. @data: the gpointer to optional user data. @Returns: TRUE if the dispatching procedure has to be stopped. The direction of a pad. @GST_PAD_UNKNOWN: direction is unknown. @GST_PAD_SRC: the pad is a source pad. @GST_PAD_SINK: the pad is a sink pad. @GST_PAD_BLOCKED: @GST_PAD_FLUSHING: @GST_PAD_IN_GETCAPS: @GST_PAD_IN_SETCAPS: @GST_PAD_FLAG_LAST: The result of a pad link. @GST_PAD_LINK_OK: the link succeeded. @GST_PAD_LINK_WRONG_HIERARCHY: @GST_PAD_LINK_WAS_LINKED: @GST_PAD_LINK_WRONG_DIRECTION: @GST_PAD_LINK_NOFORMAT: @GST_PAD_LINK_NOSCHED: @GST_PAD_LINK_REFUSED: the link was refused. Indicates when this pad will become available. @GST_PAD_ALWAYS: the pad is always available @GST_PAD_SOMETIMES: the pad will become available depending on the media stream @GST_PAD_REQUEST: the pad is only available on request with gst_element_request_pad_by_name() or gst_element_request_compatible_pad(). Gets the name of the pad. @pad: a #GstPad to get the name of. @Returns: the pad's name. Gets the parent element of this pad. @pad: a #GstPad to get the parent of. @Returns: the parent #GstElement of this pad. Gets the private data set by the element that owns the pad. @pad: a #GstPad to get the private data of. #Returns: a gpointer to the private data. Gets the pad template that was used to create this pad. @pad: a #GstPad to get the pad template of. #Returns: the #GstPadTemplate used to create the pad, or NULL if none was used. Gets the pad's direction. @pad: a #GstPad to get the direction of. @Returns: the #GstPadDirection of the pad. Gets the capabilities of a pad. @pad: a #GstPad to get the capabilities of. @Returns: the #GstCaps of the pad. Gets the peer pad of this pad. The peer pad is the pad on to which the parent element is linked through this pad. @pad: a #GstPad to get the peer pad of. @Returns: the peer #GstPad. Checks if the pad is linked. @pad: a #GstPad to check. Checks if a pad is usable. A usable pad is both linked and active. @pad: a #GstPad to check Checks if the pad is a source pad. @pad: a #GstPad to check. Checks if the pad is a sink pad. @pad: a #GstPad to check. @name: @direction: @Returns: @templ: @name: @Returns: @pad: @Returns: @pad: @Returns: @pad: @active: @Returns: @mode: @pad: @Returns: @pad: @priv: @pad: @Returns: @pad: @Returns: @pad: @Returns: @pad: @bufalloc: @bufferalloc: @pad: @offset: @size: @caps: @buf: @Returns: @pad: @chain: @pad: @event: @pad: @link: @srcpad: @sinkpad: @Returns: @pad: @unlink: @srcpad: @sinkpad: @Returns: @srcpad: @sinkpad: @Returns: @pad: @Returns: @pad: @Returns: @pad: @Returns: @pad: @Returns: @pad: @Returns: @pad: @getcaps: @pad: @Returns: @srcpad: @Returns: @pad: @pad: @buffer: @Returns: @data: @buf: @pad: @event: @Returns: @pad: @event: @Returns: @pad: @query: @pad: @type_func: @pad: @Returns: @pad: @Returns: @pad: @query: @Returns: @type: @format: @value: @pad: @query: @Returns: @type: @format: @value: @pad: @intlink: @pad: @Returns: @pad: @Returns: @pad: @dispatch: @data: @Returns: @self: @parent: @pad: @handler: @data: @Returns: @pad: @handler: @data: @Returns: @pad: @handler: @data: @Returns: @pad: @handler: @data: @pad: @handler: @data: @pad: @handler: @data: