Gst::Parse Class Reference
A class that gets a pipeline from a text pipeline description. More...
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
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
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:
-
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:
-
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:
-
The documentation for this class was generated from the following file: