# valve

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

Any downstream error received while the 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

Presence – always

Direction – sink

Object type – GstPad

### `src`

    ANY

Presence – always

Direction – src

Object type – GstPad

## 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