gst_parse_error_quark ()

GQuark              gst_parse_error_quark               (void);

Get the error quark used by the parsing subsystem.

GST_PARSE_ERROR

#define GST_PARSE_ERROR gst_parse_error_quark ()

Get access to the error quark of the parse subsystem.

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;

The different parsing errors that can occur.

GstParseContext

typedef struct _GstParseContext GstParseContext;

Opaque structure.

Since 0.10.20

enum GstParseFlags

typedef enum
{
  GST_PARSE_FLAG_NONE = 0,
  GST_PARSE_FLAG_FATAL_ERRORS = (1 << 0)
} GstParseFlags;

Parsing options.

Since 0.10.20

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.

gst_parse_launch_full ()

GstElement*         gst_parse_launch_full               (const gchar *pipeline_description,
                                                         GstParseContext *context,
                                                         GstParseFlags flags,
                                                         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.

Since 0.10.20

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.

gst_parse_launchv_full ()

GstElement*         gst_parse_launchv_full              (const gchar **argv,
                                                         GstParseContext *context,
                                                         GstParseFlags flags,
                                                         GError **error);

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

Since 0.10.20

gst_parse_bin_from_description ()

GstElement*         gst_parse_bin_from_description      (const gchar *bin_description,
                                                         gboolean ghost_unlinked_pads,
                                                         GError **err);

This is a convenience wrapper around gst_parse_launch() to create a GstBin from a gst-launch-style pipeline description. See gst_parse_launch() and the gst-launch man page for details about the syntax. Ghost pads on the bin for unlinked 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 unlinked source pads or multiple unlinked sink pads and want them all ghosted, you will have to create the ghost pads yourself).

Since 0.10.3

gst_parse_bin_from_description_full ()

GstElement*         gst_parse_bin_from_description_full (const gchar *bin_description,
                                                         gboolean ghost_unlinked_pads,
                                                         GstParseContext *context,
                                                         GstParseFlags flags,
                                                         GError **err);

This is a convenience wrapper around gst_parse_launch() to create a GstBin from a gst-launch-style pipeline description. See gst_parse_launch() and the gst-launch man page for details about the syntax. Ghost pads on the bin for unlinked 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 unlinked source pads or multiple unlinked sink pads and want them all ghosted, you will have to create the ghost pads yourself).

Since 0.10.20

gst_parse_context_new ()

GstParseContext*    gst_parse_context_new               (void);

Allocates a parse context for use with gst_parse_launch_full() or gst_parse_launchv_full().

Since 0.10.20

gst_parse_context_free ()

void                gst_parse_context_free              (GstParseContext *context);

Frees a parse context previously allocated with gst_parse_context_new().

Since 0.10.20

gst_parse_context_get_missing_elements ()

gchar**             gst_parse_context_get_missing_elements
                                                        (GstParseContext *context);

Retrieve missing elements from a previous run of gst_parse_launch_full() or gst_parse_launchv_full(). Will only return results if an error code of GST_PARSE_ERROR_NO_SUCH_ELEMENT was returned.

Since 0.10.20