Requests plugin installation without blocking. Once the plugins have been installed or installation has failed, func will be called with the result of the installation and your provided user_data pointer. This function requires a running GLib/Gtk main loop. If you are not running a GLib/Gtk main loop, make sure to regularly call g_main_context_iteration(NULL,FALSE). The installer strings that make up detail are typically obtained by calling gst_missing_plugin_message_get_installer_detail() on missing-plugin messages that have been caught on a pipeline's bus or created by the application via the provided API, such as gst_missing_element_message_new(). It is possible to request the installation of multiple missing plugins in one go (as might be required if there is a demuxer for a certain format installed but no suitable video decoder and no suitable audio decoder).

Parameters:

Array details Required (not null)

GstPbutils.InstallPluginsContext ctx Required (not null)

Function (InstallPluginsReturn result, void* user_data) : GstPbutils.InstallPluginsReturn Required (not null)

void* user_data Required (not null)

Returns:

GstPbutils.InstallPluginsReturn

Checks whether plugin installation (initiated by this application only) is currently in progress.

Returns:

Boolean

Convenience function to return the descriptive string associated with a status code. This function returns English strings and should not be used for user messages. It is here only to assist in debugging.

Parameters:

GstPbutils.InstallPluginsReturn ret Required (not null)

Returns:

String

Checks whether plugin installation is likely to be supported by the current environment. This currently only checks whether the helper script that is to be provided by the distribution or operating system vendor exists.

Returns:

Boolean

Requests plugin installation and block until the plugins have been installed or installation has failed. This function should almost never be used, it only exists for cases where a non-GLib main loop is running and the user wants to run it in a separate thread and marshal the result back asynchronously into the main thread using the other non-GLib main loop. You should almost always use gst_install_plugins_async() instead of this function.

Parameters:

Array details Required (not null)

GstPbutils.InstallPluginsContext ctx Required (not null)

Returns:

GstPbutils.InstallPluginsReturn

Checks whether msg is a missing plugins message.

Parameters:

Gst.Message msg Required (not null)

Returns:

Boolean

Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync(). This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.

Parameters:

Gst.Caps decode_caps Required (not null)

caps for which a decoder element is needed

Returns:

String with g_free() when not needed any longer.

Creates a missing-plugin message for element to notify the application that a decoder element for a particular set of (fixed) caps is missing. This function is mainly for use in plugins.

Parameters:

Gst.Element element Required (not null)

Gst.Caps decode_caps Required (not null)

caps for which a decoder element is needed

Returns:

Gst.Message

Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync(). This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.

Parameters:

String factory_name Required (not null)

e.g. "videoscale" or "cdparanoiasrc"

Returns:

String with g_free() when not needed any longer.

Creates a missing-plugin message for element to notify the application that a certain required element is missing. This function is mainly for use in plugins.

Parameters:

Gst.Element element Required (not null)

String factory_name Required (not null)

e.g. "videoscale" or "cdparanoiasrc"

Returns:

Gst.Message

Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync(). This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.

Parameters:

Gst.Caps encode_caps Required (not null)

caps for which an encoder element is needed

Returns:

String with g_free() when not needed any longer.

Creates a missing-plugin message for element to notify the application that an encoder element for a particular set of (fixed) caps is missing. This function is mainly for use in plugins.

Parameters:

Gst.Element element Required (not null)

Gst.Caps encode_caps Required (not null)

caps for which an encoder element is needed

Returns:

Gst.Message

Returns a localised string describing the missing feature, for use in error dialogs and the like. Should never return NULL unless msg is not a valid missing-plugin message. This function is mainly for applications that need a human-readable string describing a missing plugin, given a previously collected missing-plugin message

Parameters:

Gst.Message msg Required (not null)

Returns:

String string with g_free() when not needed any longer.

Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync(). This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions.

Parameters:

Gst.Message msg Required (not null)

Returns:

String with g_free() when not needed any longer.

Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync(). This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.

Parameters:

String protocol Required (not null)

e.g. "http" or "mms"

Returns:

String with g_free() when not needed any longer.

Creates a missing-plugin message for element to notify the application that a sink element for a particular URI protocol is missing. This function is mainly for use in plugins.

Parameters:

Gst.Element element Required (not null)

String protocol Required (not null)

e.g. "http" or "smb"

Returns:

Gst.Message

Returns an opaque string containing all the details about the missing element to be passed to an external installer called via gst_install_plugins_async() or gst_install_plugins_sync(). This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing.

Parameters:

String protocol Required (not null)

e.g. "http" or "mms"

Returns:

String with g_free() when not needed any longer.

Creates a missing-plugin message for element to notify the application that a source element for a particular URI protocol is missing. This function is mainly for use in plugins.

Parameters:

Gst.Element element Required (not null)

String protocol Required (not null)

e.g. "http" or "mms"

Returns:

Gst.Message

Adds a codec tag describing the format specified by caps to taglist.

Parameters:

Gst.TagList taglist Required (not null)

String codec_tag Required (not null)

GST_TAG_VIDEO_CODEC or GST_TAG_CODEC

Gst.Caps caps Required (not null)

GstCaps for which a codec tag should be added.

Returns:

Boolean

Returns a localised (as far as this is possible) string describing the media format specified in caps, for use in error dialogs or other messages to be seen by the user. Should never return NULL unless caps is invalid. Also see the convenience function gst_pb_utils_add_codec_description_to_tag_list().

Parameters:

Gst.Caps caps Required (not null)

GstCaps for which an format description is needed

Returns:

String string with g_free() when not needed any longer.

Returns a localised string describing an decoder for the format specified in caps, for use in error dialogs or other messages to be seen by the user. Should never return NULL unless factory_name or caps are invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.

Parameters:

Gst.Caps caps Required (not null)

GstCaps for which an decoder description is needed

Returns:

String string with g_free() when not needed any longer.

Returns a localised string describing the given element, for use in error dialogs or other messages to be seen by the user. Should never return NULL unless factory_name is invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.

Parameters:

String factory_name Required (not null)

Returns:

String string with g_free() when not needed any longer.

Returns a localised string describing an encoder for the format specified in caps, for use in error dialogs or other messages to be seen by the user. Should never return NULL unless factory_name or caps are invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.

Parameters:

Gst.Caps caps Required (not null)

GstCaps for which an encoder description is needed

Returns:

String string with g_free() when not needed any longer.

Returns a localised string describing a sink element handling the protocol specified in protocol, for use in error dialogs or other messages to be seen by the user. Should never return NULL unless protocol is invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.

Parameters:

String protocol Required (not null)

Returns:

String string with g_free() when not needed any longer.

Returns a localised string describing a source element handling the protocol specified in protocol, for use in error dialogs or other messages to be seen by the user. Should never return NULL unless protocol is invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message.

Parameters:

String protocol Required (not null)

Returns:

String string with g_free() when not needed any longer.

Initialises the base utils support library. This function is not thread-safe. Applications should call it after calling gst_init(), plugins should call it from their plugin_init function. This function may be called multiple times. It will do nothing if the library has already been initialised.

Returns:

none