mirror of https://github.com/GNOME/gimp.git
519 lines
17 KiB
C
519 lines
17 KiB
C
/* 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 2 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, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include <string.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"
|
|
|
|
|
|
#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;
|
|
|
|
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_container_add (GTK_CONTAINER (GTK_DIALOG (dialog)->vbox),
|
|
dialog->browser);
|
|
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);
|
|
|
|
gtk_widget_set_size_request (GIMP_BROWSER (dialog->browser)->right_vbox->parent->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: GIMP 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: GIMP 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;
|
|
|
|
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_free (proc_list[i]);
|
|
}
|
|
|
|
g_free (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"));
|
|
}
|
|
}
|