## GstParse GstParse — get a pipeline from a text pipeline description |

## Synopsis

    #include <gst/gst.h>

    GQuark      gst_parse_error_quark           (void);
    #define     GST_PARSE_ERROR
    enum        GstParseError;
    GstElement* gst_parse_launch                (const gchar *pipeline_description,
                                                 GError **error);
    GstElement* gst_parse_launchv               (const gchar **argv,
                                                 GError **error);

## Description

## Details

### gst_parse_error_quark ()

    GQuark      gst_parse_error_quark           (void);

Returns : |

### GST_PARSE_ERROR

    #define GST_PARSE_ERROR gst_parse_error_quark ()

### enum GstParseError

    typedef enum
    {
      GST_PARSE_ERROR_SYNTAX,
      GST_PARSE_ERROR_NO_SUCH_ELEMENT,
      GST_PARSE_ERROR_NO_SUCH_PROPERTY,
      GST_PARSE_ERROR_LINK,
      GST_PARSE_ERROR_COULD_NOT_SET_PROPERTY,
      GST_PARSE_ERROR_EMPTY_BIN,
      GST_PARSE_ERROR_EMPTY
    } GstParseError;

### gst_parse_launch ()

    GstElement* gst_parse_launch                (const gchar *pipeline_description,
                                                 GError **error);

Create a new pipeline based on command line syntax. Please note that you might get a return value that is not NULL even though the error is set. In this case there was a recoverable parsing error and you can try to play the pipeline.

`pipeline_description` : | the command line describing the pipeline
`error` : | the error message in case of an erroneous pipeline.
Returns : | a new element on success, NULL on failure. If more than one toplevel element is specified by the pipeline_description, all elements are put into a GstPipeline ant that is returned.

### gst_parse_launchv ()

    GstElement* gst_parse_launchv               (const gchar **argv,
                                                 GError **error);

Create a new element based on command line syntax. error will contain an error message if an erroneuos pipeline is specified. An error does not mean that the pipeline could not be constructed.

`argv` : | null-terminated array of arguments
`error` : | pointer to a GError
Returns : | a new element on success and NULL on failure.