summaryrefslogtreecommitdiffstats
path: root/plug-ins/help-browser/help-browser.c
diff options
context:
space:
mode:
Diffstat (limited to 'plug-ins/help-browser/help-browser.c')
-rw-r--r--plug-ins/help-browser/help-browser.c322
1 files changed, 322 insertions, 0 deletions
diff --git a/plug-ins/help-browser/help-browser.c b/plug-ins/help-browser/help-browser.c
new file mode 100644
index 0000000..35a2ea6
--- /dev/null
+++ b/plug-ins/help-browser/help-browser.c
@@ -0,0 +1,322 @@
+/* GIMP - The GNU Image Manipulation Program
+ * Copyright (C) 1995 Spencer Kimball and Peter Mattis
+ *
+ * The GIMP Help Browser
+ * Copyright (C) 1999-2008 Sven Neumann <sven@gimp.org>
+ * Michael Natterer <mitch@gimp.org>
+ * Henrik Brix Andersen <brix@gimp.org>
+ *
+ * Some code & ideas taken from the GNOME help browser.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+#include "config.h"
+
+#include <string.h> /* strlen, strcmp */
+
+#include <gtk/gtk.h>
+
+#include <libgimp/gimp.h>
+
+#include "plug-ins/help/gimphelp.h"
+
+#include "dialog.h"
+
+#include "libgimp/stdplugins-intl.h"
+
+
+/* defines */
+
+#define GIMP_HELP_BROWSER_EXT_PROC "extension-gimp-help-browser"
+#define GIMP_HELP_BROWSER_TEMP_EXT_PROC "extension-gimp-help-browser-temp"
+#define PLUG_IN_BINARY "help-browser"
+#define PLUG_IN_ROLE "gimp-help-browser"
+
+
+/* forward declarations */
+
+static void query (void);
+static void run (const gchar *name,
+ gint nparams,
+ const GimpParam *param,
+ gint *nreturn_vals,
+ GimpParam **return_vals);
+
+static void temp_proc_install (void);
+static void temp_proc_run (const gchar *name,
+ gint nparams,
+ const GimpParam *param,
+ gint *nreturn_vals,
+ GimpParam **return_vals);
+
+static gboolean help_browser_show_help (const gchar *help_domain,
+ const gchar *help_locales,
+ const gchar *help_id);
+
+static GimpHelpProgress * help_browser_progress_new (void);
+
+
+/* local variables */
+
+const GimpPlugInInfo PLUG_IN_INFO =
+{
+ NULL, /* init_proc */
+ NULL, /* quit_proc */
+ query, /* query_proc */
+ run, /* run_proc */
+};
+
+
+MAIN ()
+
+static void
+query (void)
+{
+ static const GimpParamDef args[] =
+ {
+ { GIMP_PDB_INT32, "run-mode", "The run mode { RUN-INTERACTIVE (0) }" },
+ { GIMP_PDB_INT32, "num-domain-names", "" },
+ { GIMP_PDB_STRINGARRAY, "domain-names", "" },
+ { GIMP_PDB_INT32, "num-domain-uris", "" },
+ { GIMP_PDB_STRINGARRAY, "domain-uris", "" }
+ };
+
+ gimp_install_procedure (GIMP_HELP_BROWSER_EXT_PROC,
+ "Browse the GIMP user manual",
+ "A small and simple HTML browser optimized for "
+ "browsing the GIMP user manual.",
+ "Sven Neumann <sven@gimp.org>, "
+ "Michael Natterer <mitch@gimp.org>"
+ "Henrik Brix Andersen <brix@gimp.org>",
+ "Sven Neumann, Michael Natterer & Henrik Brix Andersen",
+ "1999-2008",
+ NULL,
+ "",
+ GIMP_EXTENSION,
+ G_N_ELEMENTS (args), 0,
+ args, NULL);
+}
+
+static void
+run (const gchar *name,
+ gint nparams,
+ const GimpParam *param,
+ gint *nreturn_vals,
+ GimpParam **return_vals)
+{
+ GimpRunMode run_mode = param[0].data.d_int32;
+ GimpPDBStatusType status = GIMP_PDB_SUCCESS;
+
+ static GimpParam values[1];
+
+ values[0].type = GIMP_PDB_STATUS;
+ values[0].data.d_status = status;
+
+ *nreturn_vals = 1;
+ *return_vals = values;
+
+ INIT_I18N ();
+
+ switch (run_mode)
+ {
+ case GIMP_RUN_INTERACTIVE:
+ case GIMP_RUN_NONINTERACTIVE:
+ case GIMP_RUN_WITH_LAST_VALS:
+ /* Make sure all the arguments are there! */
+ if (nparams >= 1)
+ {
+ if (nparams == 5)
+ {
+ if (! gimp_help_init (param[1].data.d_int32,
+ param[2].data.d_stringarray,
+ param[3].data.d_int32,
+ param[4].data.d_stringarray))
+ {
+ status = GIMP_PDB_CALLING_ERROR;
+ }
+ }
+
+ if (status == GIMP_PDB_SUCCESS)
+ {
+ browser_dialog_open (PLUG_IN_BINARY);
+
+ temp_proc_install ();
+
+ gimp_extension_ack ();
+ gimp_extension_enable ();
+
+ gtk_main ();
+ }
+ }
+ else
+ {
+ status = GIMP_PDB_CALLING_ERROR;
+ }
+ break;
+
+ default:
+ status = GIMP_PDB_CALLING_ERROR;
+ break;
+ }
+
+ values[0].data.d_status = status;
+}
+
+static void
+temp_proc_install (void)
+{
+ static const GimpParamDef args[] =
+ {
+ { GIMP_PDB_STRING, "help-domain", "Help domain to use" },
+ { GIMP_PDB_STRING, "help-locales", "Language to use" },
+ { GIMP_PDB_STRING, "help-id", "Help ID to open" }
+ };
+
+ gimp_install_temp_proc (GIMP_HELP_BROWSER_TEMP_EXT_PROC,
+ "DON'T USE THIS ONE",
+ "(Temporary procedure)",
+ "Sven Neumann <sven@gimp.org>, "
+ "Michael Natterer <mitch@gimp.org>"
+ "Henrik Brix Andersen <brix@gimp.org>",
+ "Sven Neumann, Michael Natterer & Henrik Brix Andersen",
+ "1999-2008",
+ NULL,
+ "",
+ GIMP_TEMPORARY,
+ G_N_ELEMENTS (args), 0,
+ args, NULL,
+ temp_proc_run);
+}
+
+static void
+temp_proc_run (const gchar *name,
+ gint nparams,
+ const GimpParam *param,
+ gint *nreturn_vals,
+ GimpParam **return_vals)
+{
+ static GimpParam values[1];
+ GimpPDBStatusType status = GIMP_PDB_SUCCESS;
+
+ *nreturn_vals = 1;
+ *return_vals = values;
+
+ /* make sure all the arguments are there */
+ if (nparams == 3)
+ {
+ const gchar *help_domain = GIMP_HELP_DEFAULT_DOMAIN;
+ const gchar *help_locales = NULL;
+ const gchar *help_id = GIMP_HELP_DEFAULT_ID;
+
+ if (param[0].data.d_string && strlen (param[0].data.d_string))
+ help_domain = param[0].data.d_string;
+
+ if (param[1].data.d_string && strlen (param[1].data.d_string))
+ help_locales = param[1].data.d_string;
+
+ if (param[2].data.d_string && strlen (param[2].data.d_string))
+ help_id = param[2].data.d_string;
+
+ if (! help_browser_show_help (help_domain, help_locales, help_id))
+ {
+ gtk_main_quit ();
+ }
+ }
+
+ values[0].type = GIMP_PDB_STATUS;
+ values[0].data.d_status = status;
+}
+
+static gboolean
+help_browser_show_help (const gchar *help_domain,
+ const gchar *help_locales,
+ const gchar *help_id)
+{
+ GimpHelpDomain *domain;
+ gboolean success = TRUE;
+
+ domain = gimp_help_lookup_domain (help_domain);
+
+ if (domain)
+ {
+ GimpHelpProgress *progress = NULL;
+ GimpHelpLocale *locale;
+ GList *locales;
+ gchar *uri;
+ gboolean fatal_error;
+
+ locales = gimp_help_parse_locales (help_locales);
+
+ if (! g_str_has_prefix (domain->help_uri, "file:"))
+ progress = help_browser_progress_new ();
+
+ uri = gimp_help_domain_map (domain, locales, help_id,
+ progress, &locale, &fatal_error);
+
+ if (progress)
+ gimp_help_progress_free (progress);
+
+ g_list_free_full (locales, (GDestroyNotify) g_free);
+
+ if (uri)
+ {
+ browser_dialog_make_index (domain, locale);
+ browser_dialog_load (uri);
+
+ g_free (uri);
+ }
+ else if (fatal_error)
+ {
+ success = FALSE;
+ }
+ }
+
+ return success;
+}
+
+
+static void
+help_browser_progress_start (const gchar *message,
+ gboolean cancelable,
+ gpointer user_data)
+{
+ gimp_progress_init (message);
+}
+
+static void
+help_browser_progress_update (gdouble value,
+ gpointer user_data)
+{
+ gimp_progress_update (value);
+}
+
+static void
+help_browser_progress_end (gpointer user_data)
+{
+ gimp_progress_end ();
+}
+
+static GimpHelpProgress *
+help_browser_progress_new (void)
+{
+ static const GimpHelpProgressVTable vtable =
+ {
+ help_browser_progress_start,
+ help_browser_progress_end,
+ help_browser_progress_update
+ };
+
+ return gimp_help_progress_new (&vtable, NULL);
+}
generated by cgit v1.2.3 (git 2.39.1) at 2024-12-20 09:54:20 +0000