/* 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 * . */ #include "config.h" #include #include #include #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, ¶ms, &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")); } }