gst_uri_error_quark ()

GQuark
gst_uri_error_quark (void);

GST_URI_TYPE_IS_VALID()

#define GST_URI_TYPE_IS_VALID(type) ((type) == GST_URI_SRC || (type) == GST_URI_SINK)

Tests if the type direction is valid.

gst_uri_protocol_is_valid ()

gboolean
gst_uri_protocol_is_valid (const gchar *protocol);

Tests if the given string is a valid protocol identifier. Protocols must consist of alphanumeric characters, '+', '-' and '.' and must start with a alphabetic character. See RFC 3986 Section 3.1.

gst_uri_protocol_is_supported ()

gboolean
gst_uri_protocol_is_supported (const GstURIType type,
                               const gchar *protocol);

Checks if an element exists that supports the given URI protocol. Note that a positive return value does not imply that a subsequent call to gst_element_make_from_uri() is guaranteed to work.

gst_uri_is_valid ()

gboolean
gst_uri_is_valid (const gchar *uri);

Tests if the given string is a valid URI identifier. URIs start with a valid scheme followed by ":" and maybe a string identifying the location.

gst_uri_has_protocol ()

gboolean
gst_uri_has_protocol (const gchar *uri,
                      const gchar *protocol);

Checks if the protocol of a given valid URI matches protocol .

gst_uri_get_protocol ()

gchar *
gst_uri_get_protocol (const gchar *uri);

Extracts the protocol out of a given valid URI. The returned string must be freed using g_free().

gst_uri_get_location ()

gchar *
gst_uri_get_location (const gchar *uri);

Extracts the location out of a given valid URI, ie. the protocol and "://" are stripped from the URI, which means that the location returned includes the hostname if one is specified. The returned string must be freed using g_free().

Free-function: g_free

gst_uri_construct ()

gchar *
gst_uri_construct (const gchar *protocol,
                   const gchar *location);

Constructs a URI for a given valid protocol and location.

Free-function: g_free

gst_filename_to_uri ()

gchar *
gst_filename_to_uri (const gchar *filename,
                     GError **error);

Similar to g_filename_to_uri(), but attempts to handle relative file paths as well. Before converting filename into an URI, it will be prefixed by the current working directory if it is a relative path, and then the path will be canonicalised so that it doesn't contain any './' or '../' segments.

On Windows filename should be in UTF-8 encoding.

gst_element_make_from_uri ()

GstElement *
gst_element_make_from_uri (const GstURIType type,
                           const gchar *uri,
                           const gchar *elementname,
                           GError **error);

Creates an element for handling the given URI.

gst_uri_handler_get_uri_type ()

GstURIType
gst_uri_handler_get_uri_type (GstURIHandler *handler);

Gets the type of the given URI handler

gst_uri_handler_get_protocols ()

const gchar * const *
gst_uri_handler_get_protocols (GstURIHandler *handler);

Gets the list of protocols supported by handler . This list may not be modified.

gst_uri_handler_get_uri ()

gchar *
gst_uri_handler_get_uri (GstURIHandler *handler);

Gets the currently handled URI.

gst_uri_handler_set_uri ()

gboolean
gst_uri_handler_set_uri (GstURIHandler *handler,
                         const gchar *uri,
                         GError **error);

Tries to set the URI of the given handler.

GstURIHandler

typedef struct _GstURIHandler GstURIHandler;

Opaque GstURIHandler structure.

struct GstURIHandlerInterface

struct GstURIHandlerInterface {
  GTypeInterface parent;

  /* vtable */
  /* querying capabilities */
  GstURIType             (* get_type)           (GType type);
  const gchar * const *  (* get_protocols)      (GType type);

  /* using the interface */
  gchar *                (* get_uri)            (GstURIHandler * handler);
  gboolean               (* set_uri)            (GstURIHandler * handler,
                                                 const gchar   * uri,
                                                 GError       ** error);
};

Any GstElement using this interface should implement these methods.

enum GstURIType

The different types of URI direction.

enum GstURIError

Different URI-related errors that can occur.