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.