GStreamer Core Plugins 1.0 Plugins Reference Manual: valve

Go to page content
Go to main menu
Go to the search field

valve

valve — Drops buffers and events or lets them through

Properties

Read / Write

Types and Values

struct

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GstObject
            ╰── GstElement
                ╰── GstValve

Description

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

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

This element was previously part of gst-plugins-farsight, and then gst-plugins-bad.

Documentation last reviewed on 2010-12-30 (0.10.31)

Synopsis

Element Information

plugin	coreelements
author	Olivier Crete <olivier.crete@collabora.co.uk>
class	Filter

Element Pads

name	sink
direction	sink
presence	always
details	ANY

name	src
direction	source
presence	always
details	ANY

Functions

Types and Values

struct GstValve

struct GstValve;

The private valve structure

Property Details

The `“drop”` property

  “drop”                     gboolean

Whether to drop buffers and events or let them through.

Flags: Read / Write

Default value: FALSE