X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=src%2Fgis-plugin.h;h=9913e545f7450668a46e0f8b1a648ba9b18b51d0;hb=6a532537b8bc6a802fd058486a02a0d72b6933f7;hp=685c8a125bb39d6606ab76cdf95059016c478a42;hpb=c2e39b9d64035038a19d753129cc2124b4ed1382;p=grits

diff --git a/src/gis-plugin.h b/src/gis-plugin.h
index 685c8a1..9913e54 100644
--- a/src/gis-plugin.h
+++ b/src/gis-plugin.h
@@ -21,6 +21,9 @@
 #include <glib-object.h>
 #include <gtk/gtk.h>
 
+/********************
+ * Plugin interface *
+ ********************/
 #define GIS_TYPE_PLUGIN                (gis_plugin_get_type())
 #define GIS_PLUGIN(obj)                (G_TYPE_CHECK_INSTANCE_CAST   ((obj),  GIS_TYPE_PLUGIN, GisPlugin))
 #define GIS_IS_PLUGIN(obj)             (G_TYPE_CHECK_INSTANCE_TYPE   ((obj),  GIS_TYPE_PLUGIN))
@@ -28,39 +31,73 @@
 
 typedef struct _GisPlugin          GisPlugin;
 typedef struct _GisPluginInterface GisPluginInterface;
-typedef struct _GisPlugins         GisPlugins;
 
 struct _GisPluginInterface
 {
 	GTypeInterface parent_iface;
 
+	/* Virtual data */
+	const gchar *name;
+	const gchar *description;
+
 	/* Virtual functions */
-	GtkWidget *(*get_config)(GisPlugin *self);
+	GtkWidget *(*get_config)(GisPlugin *plugin);
 };
 
 GType gis_plugin_get_type();
 
 /* Methods */
-void       gis_plugin_expose(GisPlugin *self);
-GtkWidget *gis_plugin_get_config(GisPlugin *self);
+const gchar *gis_plugin_get_name(GisPlugin *plugin);
+
+const gchar *gis_plugin_get_description(GisPlugin *plugin);
+
+GtkWidget *gis_plugin_get_config(GisPlugin *plugin);
+
+/***************
+ * Plugins API *
+ ***************/
+typedef struct _GisPlugins GisPlugins;
 
-/* Plugins API */
 #include "gis-viewer.h"
 #include "gis-prefs.h"
 
+/**
+ * GisPluginConstructor:
+ * @viewer: the viewer the plugin is associated with
+ * @prefs:  preferences the plugin can use for storing informtion
+ *
+ * Create a new instance of a plugin. Each plugin should supply a constructor named
+ * gis_plugin_NAME_new in it's shared object.
+ *
+ * Returns: the new plugin
+ */
+typedef GisPlugin *(*GisPluginConstructor)(GisViewer *viewer, GisPrefs *prefs);
+
 struct _GisPlugins {
-	gchar *dir;
-	GList *plugins;
+	gchar    *dir;
+	GList    *plugins;
+	GisPrefs *prefs;
 };
 
-typedef GisPlugin *(*GisPluginConstructor)(GisViewer *viewer, GisPrefs *prefs);
+GisPlugins *gis_plugins_new(const gchar *dir, GisPrefs *prefs);
 
-GisPlugins *gis_plugins_new(gchar *dir);
-void        gis_plugins_free();
-GList      *gis_plugins_available(GisPlugins *plugins);
-GisPlugin  *gis_plugins_load(GisPlugins *plugins, const char *name,
+void gis_plugins_free();
+
+GList *gis_plugins_available(GisPlugins *plugins);
+
+GisPlugin *gis_plugins_load(GisPlugins *plugins, const char *name,
 		GisViewer *viewer, GisPrefs *prefs);
-gboolean    gis_plugins_unload(GisPlugins *plugins, const char *name);
-void        gis_plugins_foreach(GisPlugins *plugins, GCallback callback, gpointer user_data);
+
+GisPlugin *gis_plugins_enable(GisPlugins *plugins, const char *name,
+		GisViewer *viewer, GisPrefs *prefs);
+
+GList *gis_plugins_load_enabled(GisPlugins *plugins,
+		GisViewer *viewer, GisPrefs *prefs);
+
+gboolean gis_plugins_disable(GisPlugins *plugins, const char *name);
+
+gboolean gis_plugins_unload(GisPlugins *plugins, const char *name);
+
+void gis_plugins_foreach(GisPlugins *plugins, GCallback callback, gpointer user_data);
 
 #endif