Top |
Properties
GstPad * | alloc-pad | Read / Write |
gboolean | has-chain | Read / Write / Construct |
gchar * | last-message | Read |
gint | num-src-pads | Read |
GstTeePullMode | pull-mode | Read / Write / Construct |
gboolean | silent | Read / Write / Construct |
gboolean | allow-not-linked | Read / Write / Construct |
Description
Split data to multiple pads. Branching the data flow is useful when e.g. capturing a video where the video is shown on the screen and also encoded and written to a file. Another example is playing music and hooking up a visualisation module.
One needs to use separate queue elements (or a multiqueue) in each branch to provide separate threads for each branch. Otherwise a blocked dataflow in one branch would stall the other branches.
Example launch line
1 |
gst-launch-1.0 filesrc location=song.ogg ! decodebin ! tee name=t ! queue ! audioconvert ! audioresample ! autoaudiosink t. ! queue ! audioconvert ! goom ! videoconvert ! autovideosink |
Synopsis
Element Information
plugin |
coreelements |
author |
Erik Walthinsen <omega@cse.ogi.edu>, Wim Taymans <wim@fluendo.com> |
class |
Generic |
Property Details
The “alloc-pad”
property
“alloc-pad” GstPad *
The pad ALLOCATION queries will be proxied to (unused).
Flags: Read / Write
The “has-chain”
property
“has-chain” gboolean
If the element can operate in push mode.
Flags: Read / Write / Construct
Default value: TRUE
The “last-message”
property
“last-message” gchar *
The message describing current status.
Flags: Read
Default value: NULL
The “num-src-pads”
property
“num-src-pads” gint
The number of source pads.
Flags: Read
Allowed values: >= 0
Default value: 0
The “pull-mode”
property
“pull-mode” GstTeePullMode
Behavior of tee in pull mode.
Flags: Read / Write / Construct
Default value: Never activate in pull mode
The “silent”
property
“silent” gboolean
Don't produce last_message events.
Flags: Read / Write / Construct
Default value: TRUE
The “allow-not-linked”
property
“allow-not-linked” gboolean
This property makes sink pad return GST_FLOW_OK even if there are no source pads or any of them is linked.
This is useful to avoid errors when you have a dynamic pipeline and during a reconnection you can have all the pads unlinked or removed.
Flags: Read / Write / Construct
Default value: FALSE
Since: 1.6