# Gst::Parse Class Reference

Gst::Parse - Get a pipeline from a text pipeline description. More...

`#include <parse.h>`

List of all members.

## Static Public Member Functions
static Glib::QueryQuark | error_quark ()
| Get the error quark used by the parsing subsystem.
static Glib::RefPtr<Gst::Element> | launch (const Glib::ustring& pipeline_description)
| Create a new pipeline based on command line syntax.
static Glib::RefPtr<Gst::Element> | launchv (const gchar* argv[])
| Create a new element based on command line syntax.
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.

## Detailed Description

Gst::Parse - Get 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

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.
  | err | Where to store the error message in case of an error.

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

Exceptions:

  | Gst::CoreError |
  | Gst::ParseError |

static Glib::QueryQuark Gst::Parse::error_quark | ( |  | ) | `[static]`

Get the error quark used by the parsing subsystem.

Returns:
  The quark of the parse errors.

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.
  | error | The error message in case of an erroneous 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 |

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.
  | error | Will contain an error message if an erroneuos pipeline is specified.

Returns:
  A new element on success and null on failure.

Exceptions:

  | Gst::CoreError |
  | Gst::ParseError |

The documentation for this class was generated from the following file:

- parse.h