Gst::Parse Class Reference

A class that gets a pipeline from a text pipeline description. More...

`#include <gstreamermm/parse.h>`

## Static Public Member Functions

static Glib::QueryQuark | error_quark ()
| Get the error quark used by the parsing subsystem. More...
static Glib::RefPtr< Gst::Element > | launch (const Glib::ustring& pipeline_description)
| Create a new pipeline based on command line syntax. More...
static Glib::RefPtr< Gst::Element > | launchv (const gchar* argv[])
| Create a new element based on command line syntax. More...
static Glib::RefPtr< Gst::Element > | create_bin (const Glib::ustring& bin_description, bool ghost_unconnected_pads)
| This is a convenience wrapper around launch() to create a Gst::Bin from a gst-launch-style pipeline description. More...

## Detailed Description

A class that gets a pipeline from a text pipeline description.

The methods in this class allow to create a pipeline based on the syntax used in the gst-launch utillity.

## Member Function Documentation

## create_bin()

static Glib::RefPtr<Gst::Element> Gst::Parse::create_bin | ( | const Glib::ustring & | bin_description,
|  | bool | ghost_unconnected_pads
| ) |  |

static

This is a convenience wrapper around launch() to create a Gst::Bin from a gst-launch-style pipeline description.

See launch() and the gst-launch man page for details about the syntax. Ghost pads on the bin for unconnected source or sink pads within the bin can automatically be created (but only a maximum of one ghost pad for each direction will be created; if you expect multiple unconnected source pads or multiple unconnected sink pads and want them all ghosted, you will have to create the ghost pads yourself).

Parameters

  bin_description | Command line describing the bin.
  ghost_unconnected_pads | Whether to automatically create ghost pads for unconnected source or sink pads within the bin.

Returns
  A newly-created bin, or a null RefPtr<> if an error occurred.

Exceptions

  Gst::CoreError |
  Gst::ParseError |

## error_quark()

static Glib::QueryQuark Gst::Parse::error_quark | ( |  | ) |

static

Get the error quark used by the parsing subsystem.

Returns
  The quark of the parse errors.

## launch()

static Glib::RefPtr<Gst::Element> Gst::Parse::launch | ( | const Glib::ustring & | pipeline_description | ) |

static

Create a new pipeline based on command line syntax.

Please note that you might get a return value that is not a null RefPtr<> even though the error is set. In this case there was a recoverable parsing error and you can try to play the pipeline.

Parameters

  pipeline_description | The command line describing the pipeline.

Returns
  A new element on success, a null RefPtr<> on failure. If more than one toplevel element is specified by the pipeline_description, all elements are put into a Gst::Pipeline, which than is returned.

Exceptions

  Gst::CoreError |
  Gst::ParseError |

## launchv()

static Glib::RefPtr<Gst::Element> Gst::Parse::launchv | ( | const gchar * | argv[] | ) |

static

Create a new element based on command line syntax.

An error does not mean that the pipeline could not be constructed.

Parameters

  argv | null-terminated array of arguments. specified.

Returns
  A new element on success and null on failure.

Exceptions

  Gst::CoreError |
  Gst::ParseError |