1
/* The GIMP -- an image manipulation program
2
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
4
* This program is free software; you can redistribute it and/or modify
5
* it under the terms of the GNU General Public License as published by
6
* the Free Software Foundation; either version 2 of the License, or
7
* (at your option) any later version.
9
* This program is distributed in the hope that it will be useful,
10
* but WITHOUT ANY WARRANTY; without even the implied warranty of
11
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
* GNU General Public License for more details.
14
* You should have received a copy of the GNU General Public License
15
* along with this program; if not, write to the Free Software
16
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21
* 0.08 26th sept 97 by Thomas NOEL <thomas@minet.net>
23
* 98/12/13 Sven Neumann <sven@gimp.org> : added help display
32
#include <libgimp/gimp.h>
33
#include <libgimp/gimpui.h>
35
#include "gimpprocbox.h"
36
#include "gimpprocbrowser.h"
37
#include "gimpprocview.h"
39
#include "libgimp/stdplugins-intl.h"
42
#define RESPONSE_SEARCH 1
43
#define RESPONSE_SEARCH_NAME 2
44
#define RESPONSE_SEARCH_BLURB 3
46
#define DBL_LIST_WIDTH 250
47
#define DBL_WIDTH (DBL_LIST_WIDTH + 400)
48
#define DBL_HEIGHT 250
61
GtkWidget *count_label;
62
GtkWidget *search_entry;
67
GtkTreeSelection *sel;
69
/* the currently selected procedure */
74
gchar *proc_copyright;
76
GimpPDBProcType proc_type;
80
GimpParamDef *return_vals;
82
gboolean scheme_names;
83
GimpProcBrowserApplyCallback apply_callback;
88
/* local function prototypes */
90
static void browser_response (GtkWidget *widget,
92
GimpDBBrowser *browser);
93
static void browser_selection_changed (GtkTreeSelection *sel,
94
GimpDBBrowser *browser);
95
static void browser_row_activated (GtkTreeView *treeview,
97
GtkTreeViewColumn *column,
98
GimpDBBrowser *browser);
99
static void browser_show_procedure (GimpDBBrowser *browser,
101
static void browser_convert_string (gchar *str);
104
/* public functions */
107
gimp_proc_browser_dialog_new (gboolean scheme_names,
108
GimpProcBrowserApplyCallback apply_callback,
111
GimpDBBrowser *browser;
116
GtkWidget *scrolled_window;
117
GtkCellRenderer *renderer;
119
browser = g_new0 (GimpDBBrowser, 1);
121
browser->scheme_names = scheme_names ? TRUE : FALSE;
122
browser->apply_callback = apply_callback;
123
browser->user_data = user_data;
128
gimp_dialog_new (_("Procedure Browser"), "dbbrowser",
130
gimp_standard_help_func, "plug-in-db-browser",
132
_("Search by _Name"), RESPONSE_SEARCH_NAME,
133
_("Search by _Blurb"), RESPONSE_SEARCH_BLURB,
134
GTK_STOCK_APPLY, GTK_RESPONSE_APPLY,
135
GTK_STOCK_CLOSE, GTK_RESPONSE_CLOSE,
142
gimp_dialog_new (_("Procedure Browser"), "dbbrowser",
144
gimp_standard_help_func, "plug-in-db-browser",
146
_("Search by _Name"), RESPONSE_SEARCH_NAME,
147
_("Search by _Blurb"), RESPONSE_SEARCH_BLURB,
148
GTK_STOCK_CLOSE, GTK_RESPONSE_CLOSE,
153
gtk_dialog_set_default_response (GTK_DIALOG (browser->dialog),
154
RESPONSE_SEARCH_NAME);
156
g_signal_connect (browser->dialog, "response",
157
G_CALLBACK (browser_response),
160
/* paned : left=list ; right=description */
162
paned = gtk_hpaned_new ();
163
gtk_container_set_border_width (GTK_CONTAINER (paned), 12);
164
gtk_container_add (GTK_CONTAINER (GTK_DIALOG (browser->dialog)->vbox),
166
gtk_widget_show (paned);
168
/* left = vbox : the list and the search entry */
170
vbox = gtk_vbox_new (FALSE, 6);
171
gtk_paned_pack1 (GTK_PANED (paned), vbox, FALSE, TRUE);
172
gtk_widget_show (vbox);
174
browser->count_label = gtk_label_new ("0 Procedures");
175
gtk_misc_set_alignment (GTK_MISC (browser->count_label), 0.0, 0.5);
176
gtk_box_pack_start (GTK_BOX (vbox), browser->count_label, FALSE, FALSE, 0);
177
gtk_widget_show (browser->count_label);
179
/* list : list in a scrolled_win */
181
scrolled_window = gtk_scrolled_window_new (NULL, NULL);
182
gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (scrolled_window),
184
gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
185
GTK_POLICY_AUTOMATIC,
187
gtk_box_pack_start (GTK_BOX (vbox), scrolled_window, TRUE, TRUE, 0);
188
gtk_widget_show (scrolled_window);
190
browser->tv = gtk_tree_view_new ();
192
renderer = gtk_cell_renderer_text_new ();
193
gtk_cell_renderer_text_set_fixed_height_from_font
194
(GTK_CELL_RENDERER_TEXT (renderer), 1);
196
gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (browser->tv),
201
gtk_tree_view_set_headers_visible (GTK_TREE_VIEW (browser->tv), FALSE);
204
g_signal_connect (browser->tv, "row_activated",
205
G_CALLBACK (browser_row_activated),
208
gtk_widget_set_size_request (browser->tv, DBL_LIST_WIDTH, DBL_HEIGHT);
209
gtk_container_add (GTK_CONTAINER (scrolled_window), browser->tv);
210
gtk_widget_show (browser->tv);
212
browser->sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (browser->tv));
214
g_signal_connect (browser->sel, "changed",
215
G_CALLBACK (browser_selection_changed),
220
hbox = gtk_hbox_new (FALSE, 6);
221
gtk_box_pack_start (GTK_BOX (vbox), hbox, FALSE, FALSE, 0);
222
gtk_widget_show (hbox);
224
label = gtk_label_new_with_mnemonic (_("_Search:"));
225
gtk_box_pack_start (GTK_BOX (hbox), label, FALSE, FALSE, 0);
226
gtk_widget_show (label);
228
browser->search_entry = gtk_entry_new ();
229
gtk_entry_set_activates_default (GTK_ENTRY (browser->search_entry), TRUE);
230
gtk_box_pack_start (GTK_BOX (hbox), browser->search_entry, TRUE, TRUE, 0);
231
gtk_widget_show (browser->search_entry);
233
gtk_label_set_mnemonic_widget (GTK_LABEL (label), browser->search_entry);
235
/* right = description */
237
browser->proc_box = gimp_proc_box_new ();
238
gtk_widget_set_size_request (browser->proc_box,
239
DBL_WIDTH - DBL_LIST_WIDTH, -1);
240
gtk_paned_pack2 (GTK_PANED (paned), browser->proc_box, TRUE, TRUE);
241
gtk_widget_show (browser->proc_box);
243
/* now build the list */
245
gtk_widget_show (browser->dialog);
247
/* initialize the "return" value (for "apply") */
249
browser->proc_name = NULL;
250
browser->proc_blurb = NULL;
251
browser->proc_help = NULL;
252
browser->proc_author = NULL;
253
browser->proc_copyright = NULL;
254
browser->proc_date = NULL;
255
browser->proc_type = 0;
256
browser->n_params = 0;
257
browser->n_return_vals = 0;
258
browser->params = NULL;
259
browser->return_vals = NULL;
261
/* first search (all procedures) */
262
browser_response (browser->dialog, RESPONSE_SEARCH, browser);
264
gtk_widget_grab_focus (browser->search_entry);
266
return browser->dialog;
270
/* private functions */
273
browser_selection_changed (GtkTreeSelection *sel,
274
GimpDBBrowser *browser)
278
if (gtk_tree_selection_get_selected (sel, NULL, &iter))
282
gtk_tree_model_get (GTK_TREE_MODEL (browser->store), &iter,
283
COLUMN_PROC_NAME, &proc_name,
285
browser_show_procedure (browser, proc_name);
291
browser_row_activated (GtkTreeView *treeview,
293
GtkTreeViewColumn *column,
294
GimpDBBrowser *browser)
296
browser_response (browser->dialog, GTK_RESPONSE_APPLY, browser);
300
browser_show_procedure (GimpDBBrowser *browser,
303
g_free (browser->proc_name);
304
browser->proc_name = g_strdup (proc_name);
306
if (browser->scheme_names)
307
browser_convert_string (browser->proc_name);
309
g_free (browser->proc_blurb);
310
g_free (browser->proc_help);
311
g_free (browser->proc_author);
312
g_free (browser->proc_copyright);
313
g_free (browser->proc_date);
315
gimp_destroy_paramdefs (browser->params, browser->n_params);
316
gimp_destroy_paramdefs (browser->return_vals, browser->n_return_vals);
318
gimp_procedural_db_proc_info (proc_name,
319
&browser->proc_blurb,
321
&browser->proc_author,
322
&browser->proc_copyright,
326
&browser->n_return_vals,
328
&browser->return_vals);
330
gimp_proc_box_set_widget (browser->proc_box,
331
gimp_proc_view_new (browser->proc_name,
335
browser->proc_author,
336
browser->proc_copyright,
340
browser->n_return_vals,
342
browser->return_vals));
346
browser_response (GtkWidget *widget,
348
GimpDBBrowser *browser)
352
case GTK_RESPONSE_APPLY:
353
browser->apply_callback (browser->proc_name,
356
browser->proc_author,
357
browser->proc_copyright,
361
browser->n_return_vals,
363
browser->return_vals,
367
case RESPONSE_SEARCH:
368
case RESPONSE_SEARCH_NAME:
369
case RESPONSE_SEARCH_BLURB:
375
const gchar *query_text;
379
gtk_tree_view_set_model (GTK_TREE_VIEW (browser->tv), NULL);
383
if (response_id == RESPONSE_SEARCH_NAME)
385
gimp_proc_box_show_message (browser->proc_box,
386
_("Searching by name - please wait"));
388
query = g_string_new ("");
389
query_text = gtk_entry_get_text (GTK_ENTRY (browser->search_entry));
393
if ((*query_text == '_') || (*query_text == '-'))
394
g_string_append (query, "[-_]");
396
g_string_append_c (query, *query_text);
401
gimp_procedural_db_query (query->str,
402
".*", ".*", ".*", ".*", ".*", ".*",
403
&num_procs, &proc_list);
405
g_string_free (query, TRUE);
407
else if (response_id == RESPONSE_SEARCH_BLURB)
409
gimp_proc_box_show_message (browser->proc_box,
410
_("Searching by blurb - please wait"));
412
gimp_procedural_db_query (".*",
413
(gchar *) gtk_entry_get_text
414
(GTK_ENTRY (browser->search_entry)),
415
".*", ".*", ".*", ".*", ".*",
416
&num_procs, &proc_list);
420
gimp_proc_box_show_message (browser->proc_box,
421
_("Searching - please wait"));
423
gimp_procedural_db_query (".*", ".*", ".*", ".*", ".*", ".*", ".*",
424
&num_procs, &proc_list);
428
str = g_strdup (_("1 Procedure"));
430
str = g_strdup_printf (_("%d Procedures"), num_procs);
432
gtk_label_set_text (GTK_LABEL (browser->count_label), str);
435
browser->store = gtk_list_store_new (N_COLUMNS,
438
gtk_tree_view_set_model (GTK_TREE_VIEW (browser->tv),
439
GTK_TREE_MODEL (browser->store));
440
g_object_unref (browser->store);
442
for (i = 0; i < num_procs; i++)
446
label = g_strdup (proc_list[i]);
448
if (browser->scheme_names)
449
browser_convert_string (label);
451
gtk_list_store_append (browser->store, &iter);
452
gtk_list_store_set (browser->store, &iter,
454
COLUMN_PROC_NAME, proc_list[i],
458
g_free (proc_list[i]);
463
gtk_tree_view_columns_autosize (GTK_TREE_VIEW (browser->tv));
465
gtk_tree_sortable_set_sort_column_id (GTK_TREE_SORTABLE (browser->store),
466
COLUMN_LABEL, GTK_SORT_ASCENDING);
470
gtk_tree_model_get_iter_first (GTK_TREE_MODEL (browser->store),
472
gtk_tree_selection_select_iter (browser->sel, &iter);
476
gimp_proc_box_show_message (browser->proc_box, _("No matches"));
482
if (browser->apply_callback)
484
/* we are called by another application:
485
* just destroy the dialog box
487
gtk_widget_destroy (browser->dialog);
491
/* we are in the plug_in:
492
* quit the gtk application
501
browser_convert_string (gchar *str)