Add a pad (link point) to an element. The pad's parent will be set to element.

Pads are not automatically activated so elements should perform the needed steps to activate the pad in case this pad is added in the StatePaused or StatePlaying state. See padSetActive for more information about activating pads.

This function will emit the elementPadAdded signal on the element.

Remove pad from element.

This function is used by plugin developers and should not be used by applications. Pads that were dynamically requested from elements with elementGetRequestPad should be released with the elementReleaseRequestPad function instead.

Pads are not automatically deactivated so elements should perform the needed steps to deactivate the pad in case this pad is removed in the PAUSED or PLAYING state. See padSetActive for more information about deactivating pads.

The pad and the element should be unlocked when calling this function.

This function will emit the padRemoved signal on the element.

Returns: True if the pad could be removed. Can return False if the pad does not belong to the provided element.

Link src to sink. The link must be from source to sink; the other direction will not be tried. The function looks for existing pads that aren't linked yet. It will request new pads if necessary. Such pads must be released manually (with elementReleaseRequestPad) when unlinking. If multiple links are possible, only one is established.

Make sure you have added your elements to a Bin or Pipeline with binAdd before trying to link them.

Link src to dest using the given Caps as a filter. The link must be from source to sink; the other direction will not be tried. The function looks for existing pads that aren't linked yet. If will request new pads if necessary. If multiple links are possible, only one is established.

Make sure you have added your elements to a Bin or Pipeline with binAdd before trying to link them.

Get the Clock provided by element.

Note that an element is only required to provide a clock in the StatePaused state. Some elements can provide a clock in other states.

Set the state of element to state. This function will try to set the requested state by going through all the intermediary states and calling the class's state change function for each.

This function can return StateChangeAsync, in which case the element will perform the remainder of the state change asynchronously in another thread. An application can use elementGetState to wait for the completion of the state change or it can wait for a state change message on the bus.

Get the state of element.

For elements that performed an asynchronous state change, as reported by elementSetState, this function will block up to the specified timeout value for the state change to complete. If the element completes the state change or goes into an error, this function returns immediately with a return value of StateChangeSuccess or StateChangeFailure, respectively.

This function returns StateChangeNoPreroll if the element successfully changed its state but is not able to provide data yet. This mostly happens for live sources that not only produce data in the StatePlaying state. While the state change return is equivalent to StateChangeSuccess, it is returned to the application to signal that some sink elements might not be able to somplete their state change because an element is not producing data to complete the preroll. When setting the element to playing, the preroll will complete and playback will start.

Abort element's state change. This function is used by elements that do asynchronous state changes and find out something is wrong.

This function should be called with the state lock held.

Get a string representation of stateRet.

Since 0.10.11.

Perform a query on the given element.

For elements that don't implement a query handler, this function forwards the query to a random srcpad or to the peer of a random linked sinkpad of this element.

Send an event to an element.

If the element doesn't implement an event handler, the event will be pushed to a random linked sink pad for upstream events or a random linked source pad for downstream events.

Perform a seek on the given element. This function only supports seeking to a position relative to the start of the stream. For more complex operations like segment seeks (such as for looping), or changing the playback rate, or seeking relative to the last configured playback segment you should use elementSeek.

In a completely prerolled pipeline in the StatePaused or StatePlaying states, seeking is always guaranteed to return True on a seekable media type, or False when the media type is certainly not seekable (such as a live stream).

Some elements allow for seeking in the StateReady state, in which case they will store the seek event and execute it when they are put into the StatePaused state. If the element supports seek in StateReady, it will always return True when it recieves the event in the StateReady state.