mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-20 19:10:18 +00:00
095226658a
Original commit message from CVS: Merge the HEAD branch into AUTOPLUG2. More work on the negotiation process to allow for proxied negotiation which is needed in the queue. gst_pad_connect perform a negotiation and returns a gboolean indicating successfull connection. The pads are disconnected when negotiation fails. I'm not satisfied/sure about the implementation yet, needs some more investigation.
63 lines
1.7 KiB
Text
63 lines
1.7 KiB
Text
<chapter id="cha-plugins">
|
|
<title>What are Plugins</title>
|
|
<para>
|
|
A plugin is a shared library that contains at least one of the following items:
|
|
</para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
one or more elementfactories
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
one or more typedefinitions
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>
|
|
The plugins have one simple method: plugin_init () where all the elementfactories are
|
|
created and the typedefinitions are registered.
|
|
</para>
|
|
<para>
|
|
the plugins are maintained in the plugin system. Optionally, the typedefinitions and
|
|
the elementfactories can be saved into an XML representation so that the plugin system
|
|
does not have to load all available plugins in order to know their definition.
|
|
</para>
|
|
|
|
<para>
|
|
The basic plugin structure has the following fields:
|
|
</para>
|
|
<programlisting>
|
|
struct _GstPlugin {
|
|
gchar *name; /* name of the plugin */
|
|
gchar *longname; /* long name of plugin */
|
|
gchar *filename; /* filename it came from */
|
|
|
|
GList *types; /* list of types provided */
|
|
gint numtypes;
|
|
GList *elements; /* list of elements provided */
|
|
gint numelements;
|
|
|
|
gboolean loaded; /* if the plugin is in memory */
|
|
};
|
|
</programlisting>
|
|
|
|
<para>
|
|
You can query a GList of available plugins with:
|
|
</para>
|
|
<programlisting>
|
|
GList *plugins;
|
|
|
|
plugins = gst_plugin_get_list ();
|
|
|
|
while (plugins) {
|
|
GstPlugin *plugin = (GstPlugin *)plugins->data;
|
|
|
|
g_print ("plugin: %s\n", gst_plugin_get_name (plugin));
|
|
|
|
plugins = g_list_next (plugins);
|
|
}
|
|
</programlisting>
|
|
</chapter>
|