valve

The valve is a simple element that drops buffers when the GstValve:drop property is set to TRUE and lets then through otherwise.

Any downstream error received while the GstValve:drop property is TRUE is ignored. So downstream element can be set to GST_STATE_NULL and removed, without using pad blocking.

Hierarchy

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstElement
                ╰──valve

Factory details

Authors: – Olivier Crete

Classification:Filter

Rank – none

Plugin – coreelements

Package – GStreamer

Pad Templates

sink

ANY

Presencealways

Directionsink

Object typeGstPad


src

ANY

Presencealways

Directionsrc

Object typeGstPad


Properties

drop

“drop” gboolean

Whether to drop buffers and events or let them through

Flags : Read / Write

Default value : false


drop-mode

“drop-mode” Valve-drop-mode *

Drop mode to use. By default all buffers and events are dropped.

Flags : Read / Write

Default value : drop-all (0)


Named constants

Valve-drop-mode

Members

drop-all (0) – Drop all buffers and events
forward-sticky-events (1) – Drop all buffers but forward sticky events
transform-to-gap (2) – Convert all dropped buffers into gap events and forward sticky events

The results of the search are