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 @pad: @Returns: @pad: @active: @Returns: @pad: @blocked: @user_data: 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. @pad: @Returns: @pad: @offset: @length: @buffer: @Returns: 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: @pad: @caps: @Returns: @pad: @caps: 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: @caps: @Returns: @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: @GST_PAD_LINK_OK: @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: 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(). @GST_FLOW_RESEND: @GST_FLOW_OK: @GST_FLOW_NOT_LINKED: @GST_FLOW_WRONG_STATE: @GST_FLOW_UNEXPECTED: @GST_FLOW_NOT_NEGOTIATED: @GST_FLOW_ERROR: @GST_FLOW_NOT_SUPPORTED: @GST_ACTIVATE_NONE: @GST_ACTIVATE_PUSH: @GST_ACTIVATE_PULL: @pad: @pad: @pad: @pad: @pad: @pad: @timeval: @pad: @pad: @pad: @pad: @pad: @pad: @t: @pad: @pad: @pad: @ret: @name: @direction: @Returns: @templ: @name: @Returns: @pad: @Returns: @pad: @Returns: @pad: @Returns: @pad: @Returns: @pad: @active: @Returns: @mode: @pad: @Returns: @pad: @blocked: @Returns: @pad: @blocked: @callback: @user_data: @Returns: @pad: @Returns: @pad: @priv: @pad: @Returns: @pad: @Returns: @pad: @bufalloc: @bufferalloc: @pad: @offset: @size: @caps: @buf: @Returns: @pad: @chain: @pad: @buffer: @Returns: @pad: @check: @pad: @get: @pad: @offset: @size: @buffer: @Returns: @pad: @event: @pad: @unlink: @pad: @activate: @pad: @activatepull: @pad: @func: @data: @Returns: @pad: @Returns: @pad: @Returns: @srcpad: @sinkpad: @Returns: @srcpad: @sinkpad: @Returns: @pad: @Returns: @pad: @link: @srcpad: @sinkpad: @Returns: @pad: @caps: @Returns: @pad: @Returns: @pad: @Returns: @pad: @caps: @Returns: @pad: @Returns: @pad: @acceptcaps: @pad: @getcaps: @pad: @setcaps: @pad: @Returns: @pad: @caps: @Returns: @srcpad: @Returns: @pad: @pad: @Returns: @pad: @Returns: @pad: @Returns: @pad: @caps: @Returns: @pad: @pad: @caps: @pad: @fixatecaps: @pad: @activatepush: @pad: @buffer: @Returns: @data: @buf: @pad: @event: @Returns: @pad: @Returns: @pad: @offset: @size: @buffer: @Returns: @pad: @active: @Returns: @pad: @active: @Returns: @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: @format: @cur: @end: @Returns: @pad: @src_format: @src_val: @dest_format: @dest_val: @Returns: @dest_fmt: @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: