Adding upstream version 2.10.22.upstream/2.10.22upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

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"));
+    }
+}