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 "gimpprocview.h"
37
#include "libgimp/stdplugins-intl.h"
40
/* local function prototypes */
42
static GtkWidget * gimp_proc_view_create_params (GimpParamDef *params,
44
GtkSizeGroup *name_group,
45
GtkSizeGroup *type_group,
46
GtkSizeGroup *desc_group);
47
static const gchar * GimpPDBArgType_to_string (GimpPDBArgType type);
48
static const gchar * GimpPDBProcType_to_string (GimpPDBProcType type);
51
/* public functions */
54
gimp_proc_view_new (const gchar *name,
55
const gchar *menu_path,
59
const gchar *copyright,
65
GimpParamDef *return_vals)
72
GtkSizeGroup *name_group;
73
GtkSizeGroup *type_group;
74
GtkSizeGroup *desc_group;
77
if (blurb && strlen (blurb) < 2) blurb = NULL;
78
if (help && strlen (help) < 2) help = NULL;
79
if (author && strlen (author) < 2) author = NULL;
80
if (date && strlen (date) < 2) date = NULL;
81
if (copyright && strlen (copyright) < 2) copyright = NULL;
83
if (blurb && help && ! strcmp (blurb, help))
86
main_vbox = gtk_vbox_new (FALSE, 12);
90
frame = gimp_frame_new (name);
91
label = gtk_frame_get_label_widget (GTK_FRAME (frame));
92
gtk_label_set_selectable (GTK_LABEL (label), TRUE);
93
gtk_box_pack_start (GTK_BOX (main_vbox), frame, FALSE, FALSE, 0);
94
gtk_widget_show (frame);
96
vbox = gtk_vbox_new (FALSE, 8);
97
gtk_container_add (GTK_CONTAINER (frame), vbox);
98
gtk_widget_show (vbox);
100
label = gtk_label_new (GimpPDBProcType_to_string (type));
101
gimp_label_set_attributes (GTK_LABEL (label),
102
PANGO_ATTR_STYLE, PANGO_STYLE_ITALIC,
104
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
105
gtk_box_pack_start (GTK_BOX (vbox), label, FALSE, FALSE, 0);
106
gtk_widget_show (label);
110
label = gtk_label_new_with_mnemonic (menu_path);
111
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
112
gtk_label_set_line_wrap (GTK_LABEL (label), TRUE);
113
gtk_box_pack_start (GTK_BOX (vbox), label, FALSE, FALSE, 0);
114
gtk_widget_show (label);
119
label = gtk_label_new (blurb);
120
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
121
gtk_label_set_line_wrap (GTK_LABEL (label), TRUE);
122
gtk_box_pack_start (GTK_BOX (vbox), label, FALSE, FALSE, 0);
123
gtk_widget_show (label);
126
name_group = gtk_size_group_new (GTK_SIZE_GROUP_HORIZONTAL);
127
type_group = gtk_size_group_new (GTK_SIZE_GROUP_HORIZONTAL);
128
desc_group = gtk_size_group_new (GTK_SIZE_GROUP_HORIZONTAL);
133
frame = gimp_frame_new (_("Parameters"));
134
gtk_box_pack_start (GTK_BOX (main_vbox), frame, FALSE, FALSE, 0);
135
gtk_widget_show (frame);
137
table = gimp_proc_view_create_params (params, n_params,
138
name_group, type_group, desc_group);
139
gtk_container_add (GTK_CONTAINER (frame), table);
140
gtk_widget_show (table);
146
frame = gimp_frame_new (_("Return Values"));
147
gtk_box_pack_start (GTK_BOX (main_vbox), frame, FALSE, FALSE, 0);
148
gtk_widget_show (frame);
150
table = gimp_proc_view_create_params (return_vals, n_return_vals,
151
name_group, type_group, desc_group);
152
gtk_container_add (GTK_CONTAINER (frame), table);
153
gtk_widget_show (table);
156
if (! help && ! author && ! date && ! copyright)
159
frame = gimp_frame_new (_("Additional Information"));
160
gtk_box_pack_start (GTK_BOX (main_vbox), frame, FALSE, FALSE, 0);
161
gtk_widget_show (frame);
163
vbox = gtk_vbox_new (FALSE, 8);
164
gtk_container_add (GTK_CONTAINER (frame), vbox);
165
gtk_widget_show (vbox);
170
label = gtk_label_new (help);
171
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
172
gtk_label_set_line_wrap (GTK_LABEL (label), TRUE);
173
gtk_box_pack_start (GTK_BOX (vbox), label, FALSE, FALSE, 0);
174
gtk_widget_show (label);
177
/* show the author & the copyright */
179
if (! author && ! date && ! copyright)
182
table = gtk_table_new ((author != 0) + (date != 0) + (copyright != 0), 2,
184
gtk_table_set_col_spacings (GTK_TABLE (table), 6);
185
gtk_table_set_row_spacings (GTK_TABLE (table), 4);
186
gtk_box_pack_start (GTK_BOX (vbox), table, FALSE, FALSE, 0);
187
gtk_widget_show (table);
193
label = gtk_label_new (author);
194
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
195
gtk_label_set_line_wrap (GTK_LABEL (label), TRUE);
197
gimp_table_attach_aligned (GTK_TABLE (table), 0, row++,
198
_("Author:"), 0.0, 0.0,
204
label = gtk_label_new (date);
205
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
206
gtk_label_set_line_wrap (GTK_LABEL (label), TRUE);
208
gimp_table_attach_aligned (GTK_TABLE (table), 0, row++,
209
_("Date:"), 0.0, 0.0,
215
label = gtk_label_new (copyright);
216
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
217
gtk_label_set_line_wrap (GTK_LABEL (label), TRUE);
219
gimp_table_attach_aligned (GTK_TABLE (table), 0, row++,
220
_("Copyright:"), 0.0, 0.0,
228
/* private functions */
231
gimp_proc_view_create_params (GimpParamDef *params,
233
GtkSizeGroup *name_group,
234
GtkSizeGroup *type_group,
235
GtkSizeGroup *desc_group)
242
table = gtk_table_new (n_params, 3, FALSE);
243
gtk_table_set_col_spacings (GTK_TABLE (table), 6);
244
gtk_table_set_row_spacings (GTK_TABLE (table), 4);
246
for (i = 0; i < n_params; i++)
249
label = gtk_label_new (params[i].name);
250
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
251
gtk_size_group_add_widget (name_group, label);
252
gtk_table_attach (GTK_TABLE (table), label,
253
0, 1, i, i + 1, GTK_FILL, GTK_FILL, 0, 0);
254
gtk_widget_show (label);
257
type = GimpPDBArgType_to_string (params[i].type);
258
label = gtk_label_new (type);
259
gimp_label_set_attributes (GTK_LABEL (label),
260
PANGO_ATTR_FAMILY, "monospace",
261
PANGO_ATTR_STYLE, PANGO_STYLE_ITALIC,
263
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
264
gtk_size_group_add_widget (type_group, label);
265
gtk_table_attach (GTK_TABLE (table), label,
266
1, 2, i, i + 1, GTK_FILL, GTK_FILL, 0, 0);
267
gtk_widget_show (label);
270
label = gtk_label_new (params[i].description);
271
gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.0);
272
gtk_label_set_line_wrap (GTK_LABEL (label), TRUE);
273
gtk_size_group_add_widget (desc_group, label);
274
gtk_table_attach (GTK_TABLE (table), label,
275
2, 3, i, i + 1, GTK_SHRINK | GTK_FILL, GTK_FILL, 0, 0);
276
gtk_widget_show (label);
283
GimpPDBArgType_to_string (GimpPDBArgType type)
287
case GIMP_PDB_INT32: return "INT32";
288
case GIMP_PDB_INT16: return "INT16";
289
case GIMP_PDB_INT8: return "INT8";
290
case GIMP_PDB_FLOAT: return "FLOAT";
291
case GIMP_PDB_STRING: return "STRING";
292
case GIMP_PDB_INT32ARRAY: return "INT32ARRAY";
293
case GIMP_PDB_INT16ARRAY: return "INT16ARRAY";
294
case GIMP_PDB_INT8ARRAY: return "INT8ARRAY";
295
case GIMP_PDB_FLOATARRAY: return "FLOATARRAY";
296
case GIMP_PDB_STRINGARRAY: return "STRINGARRAY";
297
case GIMP_PDB_COLOR: return "COLOR";
298
case GIMP_PDB_REGION: return "REGION";
299
case GIMP_PDB_DISPLAY: return "DISPLAY";
300
case GIMP_PDB_IMAGE: return "IMAGE";
301
case GIMP_PDB_LAYER: return "LAYER";
302
case GIMP_PDB_CHANNEL: return "CHANNEL";
303
case GIMP_PDB_DRAWABLE: return "DRAWABLE";
304
case GIMP_PDB_SELECTION: return "SELECTION";
305
case GIMP_PDB_BOUNDARY: return "BOUNDARY";
306
case GIMP_PDB_PATH: return "PATH";
307
case GIMP_PDB_PARASITE: return "PARASITE";
308
case GIMP_PDB_STATUS: return "STATUS";
309
case GIMP_PDB_END: return "END";
310
default: return "UNKNOWN?";
315
GimpPDBProcType_to_string (GimpPDBProcType type)
319
case GIMP_INTERNAL: return _("Internal GIMP procedure");
320
case GIMP_PLUGIN: return _("GIMP Plug-In");
321
case GIMP_EXTENSION: return _("GIMP Extension");
322
case GIMP_TEMPORARY: return _("Temporary Procedure");
323
default: return "UNKNOWN";