capsfilter

capsfilter

Synopsis

struct              GstCapsFilter;
enum                GstCapsFilterCapsChangeMode;

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GstObject
               +----GstElement
                     +----GstBaseTransform
                           +----GstCapsFilter

Properties

  "caps"                     GstCaps*              : Read / Write
  "caps-change-mode"         GstCapsFilterCapsChangeMode  : Read / Write

Description

The element does not modify data as such, but can enforce limitations on the data format.

Example launch line

1
gst-launch-1.0 videotestsrc ! capsfilter caps=video/x-raw,format=GRAY8 ! videoconvert ! autovideosink
Limits acceptable video from videotestsrc to be grayscale. Equivalent to
1
gst-launch-1.0 videotestsrc ! video/x-raw,format=GRAY8 ! videoconvert ! autovideosink
which is a short notation for the capsfilter element.

Synopsis

Element Information

plugin

coreelements

author

David Schleef <ds@schleef.org>

class

Generic

Element Pads

name

sink

direction

sink

presence

always

details

ANY

name

src

direction

source

presence

always

details

ANY

Details

struct GstCapsFilter

struct GstCapsFilter;

The opaque GstCapsFilter data structure.


enum GstCapsFilterCapsChangeMode

typedef enum {
  GST_CAPS_FILTER_CAPS_CHANGE_MODE_IMMEDIATE,
  GST_CAPS_FILTER_CAPS_CHANGE_MODE_DELAYED
} GstCapsFilterCapsChangeMode;

Filter caps change behaviour

GST_CAPS_FILTER_CAPS_CHANGE_MODE_IMMEDIATE

Only accept the current filter caps

GST_CAPS_FILTER_CAPS_CHANGE_MODE_DELAYED

Temporarily accept previous filter caps

Property Details

The "caps" property

  "caps"                     GstCaps*              : Read / Write

Restrict the possible allowed capabilities (NULL means ANY). Setting this property takes a reference to the supplied GstCaps object.


The "caps-change-mode" property

  "caps-change-mode"         GstCapsFilterCapsChangeMode  : Read / Write

Filter caps change behaviour.

Default value: Only accept the current filter caps