summaryrefslogtreecommitdiffstats
path: root/libgimp/gimpprocbrowserdialog.c
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--libgimp/gimpprocbrowserdialog.c546
1 files changed, 546 insertions, 0 deletions
diff --git a/libgimp/gimpprocbrowserdialog.c b/libgimp/gimpprocbrowserdialog.c
new file mode 100644
index 0000000..dbb5b21
--- /dev/null
+++ b/libgimp/gimpprocbrowserdialog.c
@@ -0,0 +1,546 @@
+/* LIBGIMP - The GIMP Library
+ * Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
+ *
+ * gimpprocbrowserdialog.c
+ *
+ * This library is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or (at your option) any later version.
+ *
+ * This library 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
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see
+ * <https://www.gnu.org/licenses/>.
+ */
+
+#include "config.h"
+
+#include <string.h>
+
+#include <gegl.h>
+#include <gtk/gtk.h>
+
+#include "libgimpwidgets/gimpwidgets.h"
+
+#include "gimp.h"
+
+#include "gimpuitypes.h"
+#include "gimpprocbrowserdialog.h"
+#include "gimpprocview.h"
+
+#include "libgimp-intl.h"
+
+
+/**
+ * SECTION: gimpprocbrowserdialog
+ * @title: GimpProcBrowserDialog
+ * @short_description: The dialog for the procedure and plugin browsers.
+ *
+ * The dialog for the procedure and plugin browsers.
+ **/
+
+
+#define DBL_LIST_WIDTH 250
+#define DBL_WIDTH (DBL_LIST_WIDTH + 400)
+#define DBL_HEIGHT 250
+
+
+enum
+{
+ SELECTION_CHANGED,
+ ROW_ACTIVATED,
+ LAST_SIGNAL
+};
+
+typedef enum
+{
+ SEARCH_TYPE_ALL,
+ SEARCH_TYPE_NAME,
+ SEARCH_TYPE_BLURB,
+ SEARCH_TYPE_HELP,
+ SEARCH_TYPE_AUTHOR,
+ SEARCH_TYPE_COPYRIGHT,
+ SEARCH_TYPE_DATE,
+ SEARCH_TYPE_PROC_TYPE
+} SearchType;
+
+enum
+{
+ COLUMN_PROC_NAME,
+ N_COLUMNS
+};
+
+
+static void browser_selection_changed (GtkTreeSelection *sel,
+ GimpProcBrowserDialog *dialog);
+static void browser_row_activated (GtkTreeView *treeview,
+ GtkTreePath *path,
+ GtkTreeViewColumn *column,
+ GimpProcBrowserDialog *dialog);
+static void browser_show_procedure (GimpProcBrowserDialog *dialog,
+ const gchar *proc_name);
+static void browser_search (GimpBrowser *browser,
+ const gchar *query_text,
+ gint search_type,
+ GimpProcBrowserDialog *dialog);
+
+
+G_DEFINE_TYPE (GimpProcBrowserDialog, gimp_proc_browser_dialog,
+ GIMP_TYPE_DIALOG)
+
+#define parent_class gimp_proc_browser_dialog_parent_class
+
+static guint dialog_signals[LAST_SIGNAL] = { 0, };
+
+
+static void
+gimp_proc_browser_dialog_class_init (GimpProcBrowserDialogClass *klass)
+{
+ /**
+ * GimpProcBrowserDialog::selection-changed:
+ * @dialog: the object that received the signal
+ *
+ * Emitted when the selection in the contained #GtkTreeView changes.
+ */
+ dialog_signals[SELECTION_CHANGED] =
+ g_signal_new ("selection-changed",
+ G_TYPE_FROM_CLASS (klass),
+ G_SIGNAL_RUN_LAST,
+ G_STRUCT_OFFSET (GimpProcBrowserDialogClass,
+ selection_changed),
+ NULL, NULL,
+ g_cclosure_marshal_VOID__VOID,
+ G_TYPE_NONE, 0);
+
+ /**
+ * GimpProcBrowserDialog::row-activated:
+ * @dialog: the object that received the signal
+ *
+ * Emitted when one of the rows in the contained #GtkTreeView is activated.
+ */
+ dialog_signals[ROW_ACTIVATED] =
+ g_signal_new ("row-activated",
+ G_TYPE_FROM_CLASS (klass),
+ G_SIGNAL_RUN_LAST,
+ G_STRUCT_OFFSET (GimpProcBrowserDialogClass,
+ row_activated),
+ NULL, NULL,
+ g_cclosure_marshal_VOID__VOID,
+ G_TYPE_NONE, 0);
+
+ klass->selection_changed = NULL;
+ klass->row_activated = NULL;
+}
+
+static void
+gimp_proc_browser_dialog_init (GimpProcBrowserDialog *dialog)
+{
+ GtkWidget *scrolled_window;
+ GtkCellRenderer *renderer;
+ GtkTreeSelection *selection;
+ GtkWidget *parent;
+
+ dialog->browser = gimp_browser_new ();
+ gimp_browser_add_search_types (GIMP_BROWSER (dialog->browser),
+ _("by name"), SEARCH_TYPE_NAME,
+ _("by description"), SEARCH_TYPE_BLURB,
+ _("by help"), SEARCH_TYPE_HELP,
+ _("by author"), SEARCH_TYPE_AUTHOR,
+ _("by copyright"), SEARCH_TYPE_COPYRIGHT,
+ _("by date"), SEARCH_TYPE_DATE,
+ _("by type"), SEARCH_TYPE_PROC_TYPE,
+ NULL);
+ gtk_container_set_border_width (GTK_CONTAINER (dialog->browser), 12);
+ gtk_box_pack_start (GTK_BOX (gtk_dialog_get_content_area (GTK_DIALOG (dialog))),
+ dialog->browser, TRUE, TRUE, 0);
+ gtk_widget_show (dialog->browser);
+
+ g_signal_connect (dialog->browser, "search",
+ G_CALLBACK (browser_search),
+ dialog);
+
+ /* list : list in a scrolled_win */
+
+ scrolled_window = gtk_scrolled_window_new (NULL, NULL);
+ gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (scrolled_window),
+ GTK_SHADOW_IN);
+ gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
+ GTK_POLICY_AUTOMATIC,
+ GTK_POLICY_ALWAYS);
+ gtk_box_pack_start (GTK_BOX (GIMP_BROWSER (dialog->browser)->left_vbox),
+ scrolled_window, TRUE, TRUE, 0);
+ gtk_widget_show (scrolled_window);
+
+ dialog->tree_view = gtk_tree_view_new ();
+
+ renderer = gtk_cell_renderer_text_new ();
+ gtk_cell_renderer_text_set_fixed_height_from_font
+ (GTK_CELL_RENDERER_TEXT (renderer), 1);
+
+ gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (dialog->tree_view),
+ -1, NULL,
+ renderer,
+ "text", 0,
+ NULL);
+ gtk_tree_view_set_headers_visible (GTK_TREE_VIEW (dialog->tree_view), FALSE);
+
+ g_signal_connect (dialog->tree_view, "row_activated",
+ G_CALLBACK (browser_row_activated),
+ dialog);
+
+ gtk_widget_set_size_request (dialog->tree_view, DBL_LIST_WIDTH, DBL_HEIGHT);
+ gtk_container_add (GTK_CONTAINER (scrolled_window), dialog->tree_view);
+ gtk_widget_show (dialog->tree_view);
+
+ selection = gtk_tree_view_get_selection (GTK_TREE_VIEW (dialog->tree_view));
+
+ g_signal_connect (selection, "changed",
+ G_CALLBACK (browser_selection_changed),
+ dialog);
+
+ parent = gtk_widget_get_parent (GIMP_BROWSER (dialog->browser)->right_vbox);
+ parent = gtk_widget_get_parent (parent);
+
+ gtk_widget_set_size_request (parent, DBL_WIDTH - DBL_LIST_WIDTH, -1);
+}
+
+
+/* public functions */
+
+/**
+ * gimp_proc_browser_dialog_new:
+ * @title: The dialog's title.
+ * @role: The dialog's role, see gtk_window_set_role().
+ * @help_func: The function which will be called if the user presses "F1".
+ * @help_id: The help_id which will be passed to @help_func.
+ * @...: A %NULL-terminated list destribing the action_area buttons.
+ *
+ * Create a new #GimpProcBrowserDialog.
+ *
+ * Return Value: a newly created #GimpProcBrowserDialog.
+ *
+ * Since: 2.4
+ **/
+GtkWidget *
+gimp_proc_browser_dialog_new (const gchar *title,
+ const gchar *role,
+ GimpHelpFunc help_func,
+ const gchar *help_id,
+ ...)
+{
+ GimpProcBrowserDialog *dialog;
+ va_list args;
+
+ va_start (args, help_id);
+
+ dialog = g_object_new (GIMP_TYPE_PROC_BROWSER_DIALOG,
+ "title", title,
+ "role", role,
+ "help-func", help_func,
+ "help-id", help_id,
+ NULL);
+
+ gimp_dialog_add_buttons_valist (GIMP_DIALOG (dialog), args);
+
+ va_end (args);
+
+ /* first search (all procedures) */
+ browser_search (GIMP_BROWSER (dialog->browser), "", SEARCH_TYPE_ALL, dialog);
+
+ return GTK_WIDGET (dialog);
+}
+
+/**
+ * gimp_proc_browser_dialog_get_selected:
+ * @dialog: a #GimpProcBrowserDialog
+ *
+ * Retrieves the name of the currently selected procedure.
+ *
+ * Return Value: The name of the selected procedure of %NULL if no
+ * procedure is selected.
+ *
+ * Since: 2.4
+ **/
+gchar *
+gimp_proc_browser_dialog_get_selected (GimpProcBrowserDialog *dialog)
+{
+ GtkTreeSelection *sel;
+ GtkTreeIter iter;
+
+ g_return_val_if_fail (GIMP_IS_PROC_BROWSER_DIALOG (dialog), NULL);
+
+ sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (dialog->tree_view));
+
+ if (gtk_tree_selection_get_selected (sel, NULL, &iter))
+ {
+ gchar *proc_name;
+
+ gtk_tree_model_get (GTK_TREE_MODEL (dialog->store), &iter,
+ COLUMN_PROC_NAME, &proc_name,
+ -1);
+
+ return proc_name;
+ }
+
+ return NULL;
+}
+
+
+/* private functions */
+
+static void
+browser_selection_changed (GtkTreeSelection *sel,
+ GimpProcBrowserDialog *dialog)
+{
+ GtkTreeIter iter;
+
+ if (gtk_tree_selection_get_selected (sel, NULL, &iter))
+ {
+ gchar *proc_name;
+
+ gtk_tree_model_get (GTK_TREE_MODEL (dialog->store), &iter,
+ COLUMN_PROC_NAME, &proc_name,
+ -1);
+ browser_show_procedure (dialog, proc_name);
+ g_free (proc_name);
+ }
+
+ g_signal_emit (dialog, dialog_signals[SELECTION_CHANGED], 0);
+}
+
+static void
+browser_row_activated (GtkTreeView *treeview,
+ GtkTreePath *path,
+ GtkTreeViewColumn *column,
+ GimpProcBrowserDialog *dialog)
+{
+ g_signal_emit (dialog, dialog_signals[ROW_ACTIVATED], 0);
+}
+
+static void
+browser_show_procedure (GimpProcBrowserDialog *dialog,
+ const gchar *proc_name)
+{
+ gchar *proc_blurb;
+ gchar *proc_help;
+ gchar *proc_author;
+ gchar *proc_copyright;
+ gchar *proc_date;
+ GimpPDBProcType proc_type;
+ gint n_params;
+ gint n_return_vals;
+ GimpParamDef *params;
+ GimpParamDef *return_vals;
+
+ gimp_procedural_db_proc_info (proc_name,
+ &proc_blurb,
+ &proc_help,
+ &proc_author,
+ &proc_copyright,
+ &proc_date,
+ &proc_type,
+ &n_params,
+ &n_return_vals,
+ &params,
+ &return_vals);
+
+ gimp_browser_set_widget (GIMP_BROWSER (dialog->browser),
+ gimp_proc_view_new (proc_name,
+ NULL,
+ proc_blurb,
+ proc_help,
+ proc_author,
+ proc_copyright,
+ proc_date,
+ proc_type,
+ n_params,
+ n_return_vals,
+ params,
+ return_vals));
+
+ g_free (proc_blurb);
+ g_free (proc_help);
+ g_free (proc_author);
+ g_free (proc_copyright);
+ g_free (proc_date);
+
+ gimp_destroy_paramdefs (params, n_params);
+ gimp_destroy_paramdefs (return_vals, n_return_vals);
+}
+
+static void
+browser_search (GimpBrowser *browser,
+ const gchar *query_text,
+ gint search_type,
+ GimpProcBrowserDialog *dialog)
+{
+ gchar **proc_list;
+ gint num_procs;
+ gchar *str;
+ GRegex *regex;
+
+ /* first check if the query is a valid regex */
+ regex = g_regex_new (query_text, 0, 0, NULL);
+
+ if (! regex)
+ {
+ gtk_tree_view_set_model (GTK_TREE_VIEW (dialog->tree_view), NULL);
+ dialog->store = NULL;
+
+ gimp_browser_show_message (browser, _("No matches"));
+
+ gtk_label_set_text (GTK_LABEL (browser->count_label),
+ _("Search term invalid or incomplete"));
+ return;
+ }
+
+ g_regex_unref (regex);
+
+ switch (search_type)
+ {
+ case SEARCH_TYPE_ALL:
+ gimp_browser_show_message (browser, _("Searching"));
+
+ gimp_procedural_db_query (".*", ".*", ".*", ".*", ".*", ".*", ".*",
+ &num_procs, &proc_list);
+ break;
+
+ case SEARCH_TYPE_NAME:
+ {
+ GString *query = g_string_new ("");
+ const gchar *q = query_text;
+
+ gimp_browser_show_message (browser, _("Searching by name"));
+
+ while (*q)
+ {
+ if ((*q == '_') || (*q == '-'))
+ g_string_append (query, "-");
+ else
+ g_string_append_c (query, *q);
+
+ q++;
+ }
+
+ gimp_procedural_db_query (query->str,
+ ".*", ".*", ".*", ".*", ".*", ".*",
+ &num_procs, &proc_list);
+
+ g_string_free (query, TRUE);
+ }
+ break;
+
+ case SEARCH_TYPE_BLURB:
+ gimp_browser_show_message (browser, _("Searching by description"));
+
+ gimp_procedural_db_query (".*", query_text, ".*", ".*", ".*", ".*", ".*",
+ &num_procs, &proc_list);
+ break;
+
+ case SEARCH_TYPE_HELP:
+ gimp_browser_show_message (browser, _("Searching by help"));
+
+ gimp_procedural_db_query (".*", ".*", query_text, ".*", ".*", ".*", ".*",
+ &num_procs, &proc_list);
+ break;
+
+ case SEARCH_TYPE_AUTHOR:
+ gimp_browser_show_message (browser, _("Searching by author"));
+
+ gimp_procedural_db_query (".*", ".*", ".*", query_text, ".*", ".*", ".*",
+ &num_procs, &proc_list);
+ break;
+
+ case SEARCH_TYPE_COPYRIGHT:
+ gimp_browser_show_message (browser, _("Searching by copyright"));
+
+ gimp_procedural_db_query (".*", ".*", ".*", ".*", query_text, ".*", ".*",
+ &num_procs, &proc_list);
+ break;
+
+ case SEARCH_TYPE_DATE:
+ gimp_browser_show_message (browser, _("Searching by date"));
+
+ gimp_procedural_db_query (".*", ".*", ".*", ".*", ".*", query_text, ".*",
+ &num_procs, &proc_list);
+ break;
+
+ case SEARCH_TYPE_PROC_TYPE:
+ gimp_browser_show_message (browser, _("Searching by type"));
+
+ gimp_procedural_db_query (".*", ".*", ".*", ".*", ".*", ".*", query_text,
+ &num_procs, &proc_list);
+ break;
+ }
+
+ if (! query_text || strlen (query_text) == 0)
+ {
+ str = g_strdup_printf (dngettext (GETTEXT_PACKAGE "-libgimp",
+ "%d procedure",
+ "%d procedures",
+ num_procs), num_procs);
+ }
+ else
+ {
+ switch (num_procs)
+ {
+ case 0:
+ str = g_strdup (_("No matches for your query"));
+ break;
+ default:
+ str = g_strdup_printf (dngettext (GETTEXT_PACKAGE "-libgimp",
+ "%d procedure matches your query",
+ "%d procedures match your query",
+ num_procs), num_procs);
+ break;
+ }
+ }
+
+ gtk_label_set_text (GTK_LABEL (browser->count_label), str);
+ g_free (str);
+
+ if (num_procs > 0)
+ {
+ GtkTreeSelection *selection;
+ GtkTreeIter iter;
+ gint i;
+
+ dialog->store = gtk_list_store_new (N_COLUMNS,
+ G_TYPE_STRING);
+ gtk_tree_view_set_model (GTK_TREE_VIEW (dialog->tree_view),
+ GTK_TREE_MODEL (dialog->store));
+ g_object_unref (dialog->store);
+
+ for (i = 0; i < num_procs; i++)
+ {
+ gtk_list_store_append (dialog->store, &iter);
+ gtk_list_store_set (dialog->store, &iter,
+ COLUMN_PROC_NAME, proc_list[i],
+ -1);
+ }
+
+ g_strfreev (proc_list);
+
+ gtk_tree_view_columns_autosize (GTK_TREE_VIEW (dialog->tree_view));
+
+ gtk_tree_sortable_set_sort_column_id (GTK_TREE_SORTABLE (dialog->store),
+ COLUMN_PROC_NAME,
+ GTK_SORT_ASCENDING);
+
+ gtk_tree_model_get_iter_first (GTK_TREE_MODEL (dialog->store), &iter);
+ selection = gtk_tree_view_get_selection (GTK_TREE_VIEW (dialog->tree_view));
+ gtk_tree_selection_select_iter (selection, &iter);
+ }
+ else
+ {
+ gtk_tree_view_set_model (GTK_TREE_VIEW (dialog->tree_view), NULL);
+ dialog->store = NULL;
+
+ gimp_browser_show_message (browser, _("No matches"));
+ }
+}