1
/* The GIMP -- an image manipulation program
2
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
4
* gimpcontainergridview.c
5
* Copyright (C) 2001-2004 Michael Natterer <mitch@gimp.org>
7
* This program is free software; you can redistribute it and/or modify
8
* it under the terms of the GNU General Public License as published by
9
* the Free Software Foundation; either version 2 of the License, or
10
* (at your option) any later version.
12
* This program is distributed in the hope that it will be useful,
13
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
* GNU General Public License for more details.
17
* You should have received a copy of the GNU General Public License
18
* along with this program; if not, write to the Free Software
19
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25
#include <gdk/gdkkeysyms.h>
27
#include "libgimpcolor/gimpcolor.h"
28
#include "libgimpwidgets/gimpwidgets.h"
30
#include "widgets-types.h"
32
#include "core/gimpcontainer.h"
33
#include "core/gimpcontext.h"
34
#include "core/gimpmarshal.h"
35
#include "core/gimpviewable.h"
37
#include "gimpcontainergridview.h"
38
#include "gimpcontainerview.h"
40
#include "gimpviewrenderer.h"
41
#include "gimpwidgets-utils.h"
42
#include "gtkhwrapbox.h"
44
#include "gimp-intl.h"
54
static void gimp_container_grid_view_class_init (GimpContainerGridViewClass *klass);
55
static void gimp_container_grid_view_init (GimpContainerGridView *view);
57
static void gimp_container_grid_view_view_iface_init (GimpContainerViewInterface *view_iface);
59
static gboolean gimp_container_grid_view_move_cursor (GimpContainerGridView *view,
62
static gboolean gimp_container_grid_view_focus (GtkWidget *widget,
63
GtkDirectionType direction);
64
static gboolean gimp_container_grid_view_popup_menu (GtkWidget *widget);
66
static gpointer gimp_container_grid_view_insert_item (GimpContainerView *view,
67
GimpViewable *viewable,
69
static void gimp_container_grid_view_remove_item (GimpContainerView *view,
70
GimpViewable *viewable,
71
gpointer insert_data);
72
static void gimp_container_grid_view_reorder_item (GimpContainerView *view,
73
GimpViewable *viewable,
75
gpointer insert_data);
76
static void gimp_container_grid_view_rename_item (GimpContainerView *view,
77
GimpViewable *viewable,
78
gpointer insert_data);
79
static gboolean gimp_container_grid_view_select_item (GimpContainerView *view,
80
GimpViewable *viewable,
81
gpointer insert_data);
82
static void gimp_container_grid_view_clear_items (GimpContainerView *view);
83
static void gimp_container_grid_view_set_preview_size (GimpContainerView *view);
84
static gboolean gimp_container_grid_view_item_selected(GtkWidget *widget,
85
GdkEventButton *bevent,
87
static void gimp_container_grid_view_item_activated (GtkWidget *widget,
89
static void gimp_container_grid_view_item_context (GtkWidget *widget,
91
static void gimp_container_grid_view_highlight_item (GimpContainerView *view,
92
GimpViewable *viewable,
93
gpointer insert_data);
95
static void gimp_container_grid_view_viewport_resized (GtkWidget *widget,
96
GtkAllocation *allocation,
97
GimpContainerGridView *view);
100
static GimpContainerBoxClass *parent_class = NULL;
101
static GimpContainerViewInterface *parent_view_iface = NULL;
103
static guint grid_view_signals[LAST_SIGNAL] = { 0 };
105
static GimpRGB white_color;
106
static GimpRGB black_color;
110
gimp_container_grid_view_get_type (void)
112
static GType view_type = 0;
116
static const GTypeInfo view_info =
118
sizeof (GimpContainerGridViewClass),
119
NULL, /* base_init */
120
NULL, /* base_finalize */
121
(GClassInitFunc) gimp_container_grid_view_class_init,
122
NULL, /* class_finalize */
123
NULL, /* class_data */
124
sizeof (GimpContainerGridView),
126
(GInstanceInitFunc) gimp_container_grid_view_init,
129
static const GInterfaceInfo view_iface_info =
131
(GInterfaceInitFunc) gimp_container_grid_view_view_iface_init,
132
NULL, /* iface_finalize */
133
NULL /* iface_data */
136
view_type = g_type_register_static (GIMP_TYPE_CONTAINER_BOX,
137
"GimpContainerGridView",
140
g_type_add_interface_static (view_type, GIMP_TYPE_CONTAINER_VIEW,
148
gimp_container_grid_view_class_init (GimpContainerGridViewClass *klass)
150
GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
151
GtkBindingSet *binding_set;
153
parent_class = g_type_class_peek_parent (klass);
154
binding_set = gtk_binding_set_by_class (klass);
156
widget_class->focus = gimp_container_grid_view_focus;
157
widget_class->popup_menu = gimp_container_grid_view_popup_menu;
159
klass->move_cursor = gimp_container_grid_view_move_cursor;
161
grid_view_signals[MOVE_CURSOR] =
162
g_signal_new ("move_cursor",
163
G_TYPE_FROM_CLASS (klass),
164
G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
165
G_STRUCT_OFFSET (GimpContainerGridViewClass, move_cursor),
167
gimp_marshal_BOOLEAN__ENUM_INT,
169
GTK_TYPE_MOVEMENT_STEP,
172
gtk_binding_entry_add_signal (binding_set, GDK_Home, 0,
174
G_TYPE_ENUM, GTK_MOVEMENT_BUFFER_ENDS,
176
gtk_binding_entry_add_signal (binding_set, GDK_End, 0,
178
G_TYPE_ENUM, GTK_MOVEMENT_BUFFER_ENDS,
180
gtk_binding_entry_add_signal (binding_set, GDK_Page_Up, 0,
182
G_TYPE_ENUM, GTK_MOVEMENT_PAGES,
184
gtk_binding_entry_add_signal (binding_set, GDK_Page_Down, 0,
186
G_TYPE_ENUM, GTK_MOVEMENT_PAGES,
189
gimp_rgba_set (&white_color, 1.0, 1.0, 1.0, 1.0);
190
gimp_rgba_set (&black_color, 0.0, 0.0, 0.0, 1.0);
194
gimp_container_grid_view_init (GimpContainerGridView *grid_view)
196
GimpContainerBox *box = GIMP_CONTAINER_BOX (grid_view);
199
grid_view->columns = 1;
200
grid_view->visible_rows = 0;
201
grid_view->selected_item = NULL;
203
gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (box->scrolled_win),
204
GTK_POLICY_NEVER, GTK_POLICY_ALWAYS);
206
grid_view->name_label = gtk_label_new (_("(None)"));
207
gtk_misc_set_alignment (GTK_MISC (grid_view->name_label), 0.0, 0.5);
208
gimp_label_set_attributes (GTK_LABEL (grid_view->name_label),
209
PANGO_ATTR_STYLE, PANGO_STYLE_ITALIC,
211
gtk_box_pack_start (GTK_BOX (grid_view), grid_view->name_label,
213
gtk_box_reorder_child (GTK_BOX (grid_view), grid_view->name_label, 0);
214
gtk_widget_show (grid_view->name_label);
216
grid_view->wrap_box = gtk_hwrap_box_new (FALSE);
217
gtk_scrolled_window_add_with_viewport (GTK_SCROLLED_WINDOW (box->scrolled_win),
218
grid_view->wrap_box);
219
gtk_widget_show (grid_view->wrap_box);
221
g_signal_connect (grid_view->wrap_box->parent, "size_allocate",
222
G_CALLBACK (gimp_container_grid_view_viewport_resized),
225
GTK_WIDGET_SET_FLAGS (grid_view, GTK_CAN_FOCUS);
229
gimp_container_grid_view_view_iface_init (GimpContainerViewInterface *view_iface)
231
parent_view_iface = g_type_interface_peek_parent (view_iface);
233
view_iface->insert_item = gimp_container_grid_view_insert_item;
234
view_iface->remove_item = gimp_container_grid_view_remove_item;
235
view_iface->reorder_item = gimp_container_grid_view_reorder_item;
236
view_iface->rename_item = gimp_container_grid_view_rename_item;
237
view_iface->select_item = gimp_container_grid_view_select_item;
238
view_iface->clear_items = gimp_container_grid_view_clear_items;
239
view_iface->set_preview_size = gimp_container_grid_view_set_preview_size;
243
gimp_container_grid_view_new (GimpContainer *container,
244
GimpContext *context,
246
gint view_border_width)
248
GimpContainerGridView *grid_view;
249
GimpContainerView *view;
251
g_return_val_if_fail (container == NULL || GIMP_IS_CONTAINER (container),
253
g_return_val_if_fail (context == NULL || GIMP_IS_CONTEXT (context), NULL);
254
g_return_val_if_fail (view_size > 0 &&
255
view_size <= GIMP_VIEWABLE_MAX_PREVIEW_SIZE, NULL);
256
g_return_val_if_fail (view_border_width >= 0 &&
257
view_border_width <= GIMP_VIEW_MAX_BORDER_WIDTH,
260
grid_view = g_object_new (GIMP_TYPE_CONTAINER_GRID_VIEW, NULL);
262
view = GIMP_CONTAINER_VIEW (grid_view);
264
gimp_container_view_set_preview_size (view, view_size,
268
gimp_container_view_set_container (view, container);
271
gimp_container_view_set_context (view, context);
273
return GTK_WIDGET (grid_view);
277
gimp_container_grid_view_move_by (GimpContainerGridView *grid_view,
281
GimpContainerView *view = GIMP_CONTAINER_VIEW (grid_view);
282
GimpContainer *container;
286
if (! grid_view->selected_item)
289
container = gimp_container_view_get_container (view);
291
item = grid_view->selected_item->viewable;
293
index = gimp_container_get_child_index (container, GIMP_OBJECT (item));
296
index = CLAMP (index, 0, container->num_children - 1);
298
index += y * grid_view->columns;
300
index += grid_view->columns;
301
while (index >= container->num_children)
302
index -= grid_view->columns;
304
item = (GimpViewable *) gimp_container_get_child_by_index (container, index);
306
gimp_container_view_item_selected (GIMP_CONTAINER_VIEW (view), item);
312
gimp_container_grid_view_move_cursor (GimpContainerGridView *grid_view,
313
GtkMovementStep step,
316
GimpContainerView *view = GIMP_CONTAINER_VIEW (grid_view);
317
GimpContainer *container;
320
if (! GTK_WIDGET_HAS_FOCUS (GTK_WIDGET (grid_view)) || count == 0)
323
container = gimp_container_view_get_container (view);
327
case GTK_MOVEMENT_PAGES:
328
return gimp_container_grid_view_move_by (grid_view, 0,
329
count * grid_view->visible_rows);
331
case GTK_MOVEMENT_BUFFER_ENDS:
332
count = count < 0 ? 0 : container->num_children - 1;
334
item = (GimpViewable *) gimp_container_get_child_by_index (container,
337
gimp_container_view_item_selected (view, item);
349
gimp_container_grid_view_focus (GtkWidget *widget,
350
GtkDirectionType direction)
352
GimpContainerGridView *view = GIMP_CONTAINER_GRID_VIEW (widget);
354
if (GTK_WIDGET_CAN_FOCUS (widget) && ! GTK_WIDGET_HAS_FOCUS (widget))
356
gtk_widget_grab_focus (GTK_WIDGET (widget));
363
return gimp_container_grid_view_move_by (view, 0, -1);
365
return gimp_container_grid_view_move_by (view, 0, 1);
367
return gimp_container_grid_view_move_by (view, -1, 0);
369
return gimp_container_grid_view_move_by (view, 1, 0);
371
case GTK_DIR_TAB_FORWARD:
372
case GTK_DIR_TAB_BACKWARD:
380
gimp_container_grid_view_menu_position (GtkMenu *menu,
385
GtkWidget *widget = GTK_WIDGET (data);
387
gdk_window_get_origin (widget->window, x, y);
389
if (GTK_WIDGET_NO_WINDOW (widget))
391
*x += widget->allocation.x;
392
*y += widget->allocation.y;
395
*x += widget->allocation.width / 2;
396
*y += widget->allocation.height / 2;
398
gimp_menu_position (menu, x, y);
402
gimp_container_grid_view_popup_menu (GtkWidget *widget)
404
GimpContainerGridView *grid_view = GIMP_CONTAINER_GRID_VIEW (widget);
406
if (grid_view->selected_item)
408
return gimp_editor_popup_menu (GIMP_EDITOR (grid_view),
409
gimp_container_grid_view_menu_position,
410
grid_view->selected_item);
417
gimp_container_grid_view_insert_item (GimpContainerView *view,
418
GimpViewable *viewable,
421
GimpContainerGridView *grid_view = GIMP_CONTAINER_GRID_VIEW (view);
425
preview_size = gimp_container_view_get_preview_size (view, NULL);
427
preview = gimp_view_new_full (viewable,
432
gimp_view_renderer_set_border_type (GIMP_VIEW (preview)->renderer,
433
GIMP_VIEW_BORDER_WHITE);
434
gimp_view_renderer_remove_idle (GIMP_VIEW (preview)->renderer);
436
gtk_wrap_box_pack (GTK_WRAP_BOX (grid_view->wrap_box), preview,
437
FALSE, FALSE, FALSE, FALSE);
440
gtk_wrap_box_reorder_child (GTK_WRAP_BOX (grid_view->wrap_box),
443
gtk_widget_show (preview);
445
g_signal_connect (preview, "button_press_event",
446
G_CALLBACK (gimp_container_grid_view_item_selected),
448
g_signal_connect (preview, "double_clicked",
449
G_CALLBACK (gimp_container_grid_view_item_activated),
451
g_signal_connect (preview, "context",
452
G_CALLBACK (gimp_container_grid_view_item_context),
455
return (gpointer) preview;
459
gimp_container_grid_view_remove_item (GimpContainerView *view,
460
GimpViewable *viewable,
461
gpointer insert_data)
463
GimpContainerGridView *grid_view = GIMP_CONTAINER_GRID_VIEW (view);
464
GtkWidget *preview = GTK_WIDGET (insert_data);
466
if (preview == (GtkWidget *) grid_view->selected_item)
467
grid_view->selected_item = NULL;
469
gtk_container_remove (GTK_CONTAINER (grid_view->wrap_box), preview);
473
gimp_container_grid_view_reorder_item (GimpContainerView *view,
474
GimpViewable *viewable,
476
gpointer insert_data)
478
GimpContainerGridView *grid_view = GIMP_CONTAINER_GRID_VIEW (view);
479
GtkWidget *preview = GTK_WIDGET (insert_data);
481
gtk_wrap_box_reorder_child (GTK_WRAP_BOX (grid_view->wrap_box),
486
gimp_container_grid_view_rename_item (GimpContainerView *view,
487
GimpViewable *viewable,
488
gpointer insert_data)
490
GimpContainerGridView *grid_view = GIMP_CONTAINER_GRID_VIEW (view);
491
GtkWidget *preview = GTK_WIDGET (insert_data);
493
if (preview == (GtkWidget *) grid_view->selected_item)
495
gchar *name = gimp_viewable_get_description (viewable, NULL);
497
gtk_label_set_text (GTK_LABEL (grid_view->name_label), name);
504
gimp_container_grid_view_select_item (GimpContainerView *view,
505
GimpViewable *viewable,
506
gpointer insert_data)
508
gimp_container_grid_view_highlight_item (view, viewable, insert_data);
514
gimp_container_grid_view_clear_items (GimpContainerView *view)
516
GimpContainerGridView *grid_view = GIMP_CONTAINER_GRID_VIEW (view);
518
grid_view->selected_item = NULL;
520
while (GTK_WRAP_BOX (grid_view->wrap_box)->children)
521
gtk_container_remove (GTK_CONTAINER (grid_view->wrap_box),
522
GTK_WRAP_BOX (grid_view->wrap_box)->children->widget);
524
parent_view_iface->clear_items (view);
528
gimp_container_grid_view_set_preview_size (GimpContainerView *view)
530
GimpContainerGridView *grid_view = GIMP_CONTAINER_GRID_VIEW (view);
531
GtkWrapBoxChild *child;
534
preview_size = gimp_container_view_get_preview_size (view, NULL);
536
for (child = GTK_WRAP_BOX (grid_view->wrap_box)->children;
540
GimpView *view = GIMP_VIEW (child->widget);
542
gimp_view_renderer_set_size (view->renderer,
544
view->renderer->border_width);
547
gtk_widget_queue_resize (grid_view->wrap_box);
551
gimp_container_grid_view_item_selected (GtkWidget *widget,
552
GdkEventButton *bevent,
555
if (bevent->type == GDK_BUTTON_PRESS && bevent->button == 1)
557
if (GTK_WIDGET_CAN_FOCUS (data) && ! GTK_WIDGET_HAS_FOCUS (data))
558
gtk_widget_grab_focus (GTK_WIDGET (data));
560
gimp_container_view_item_selected (GIMP_CONTAINER_VIEW (data),
561
GIMP_VIEW (widget)->viewable);
568
gimp_container_grid_view_item_activated (GtkWidget *widget,
571
gimp_container_view_item_activated (GIMP_CONTAINER_VIEW (data),
572
GIMP_VIEW (widget)->viewable);
576
gimp_container_grid_view_item_context (GtkWidget *widget,
579
/* ref the view because calling gimp_container_view_item_selected()
580
* may destroy the widget
584
if (gimp_container_view_item_selected (GIMP_CONTAINER_VIEW (data),
585
GIMP_VIEW (widget)->viewable))
587
gimp_container_view_item_context (GIMP_CONTAINER_VIEW (data),
588
GIMP_VIEW (widget)->viewable);
591
g_object_unref (data);
595
gimp_container_grid_view_highlight_item (GimpContainerView *view,
596
GimpViewable *viewable,
597
gpointer insert_data)
599
GimpContainerGridView *grid_view = GIMP_CONTAINER_GRID_VIEW (view);
600
GimpContainerBox *box = GIMP_CONTAINER_BOX (view);
601
GimpContainer *container;
602
GimpView *preview = NULL;
604
container = gimp_container_view_get_container (view);
607
preview = GIMP_VIEW (insert_data);
609
if (grid_view->selected_item && grid_view->selected_item != preview)
611
gimp_view_renderer_set_border_type (grid_view->selected_item->renderer,
612
GIMP_VIEW_BORDER_WHITE);
613
gimp_view_renderer_update (grid_view->selected_item->renderer);
618
GtkRequisition preview_requisition;
625
adj = gtk_scrolled_window_get_vadjustment
626
(GTK_SCROLLED_WINDOW (box->scrolled_win));
628
gtk_widget_size_request (GTK_WIDGET (preview), &preview_requisition);
630
item_height = preview_requisition.height;
632
index = gimp_container_get_child_index (container,
633
GIMP_OBJECT (viewable));
635
row = index / grid_view->columns;
637
if (row * item_height < adj->value)
639
gtk_adjustment_set_value (adj, row * item_height);
641
else if ((row + 1) * item_height > adj->value + adj->page_size)
643
gtk_adjustment_set_value (adj,
644
(row + 1) * item_height - adj->page_size);
647
gimp_view_renderer_set_border_type (preview->renderer,
648
GIMP_VIEW_BORDER_BLACK);
649
gimp_view_renderer_update (preview->renderer);
651
name = gimp_viewable_get_description (preview->renderer->viewable, NULL);
652
gtk_label_set_text (GTK_LABEL (grid_view->name_label), name);
657
gtk_label_set_text (GTK_LABEL (grid_view->name_label), _("(None)"));
660
grid_view->selected_item = preview;
664
gimp_container_grid_view_viewport_resized (GtkWidget *widget,
665
GtkAllocation *allocation,
666
GimpContainerGridView *grid_view)
668
GimpContainerView *view = GIMP_CONTAINER_VIEW (grid_view);
670
if (gimp_container_view_get_container (view))
675
children = gtk_container_get_children (GTK_CONTAINER (grid_view->wrap_box));
676
n_children = g_list_length (children);
680
GtkRequisition preview_requisition;
684
gtk_widget_size_request (GTK_WIDGET (children->data),
685
&preview_requisition);
687
g_list_free (children);
689
columns = MAX (1, allocation->width / preview_requisition.width);
691
rows = n_children / columns;
693
if (n_children % columns)
696
if ((rows != grid_view->rows) || (columns != grid_view->columns))
698
grid_view->rows = rows;
699
grid_view->columns = columns;
701
gtk_widget_set_size_request (grid_view->wrap_box,
702
columns * preview_requisition.width,
703
rows * preview_requisition.height);
707
grid_view->visible_rows = (allocation->height /
708
preview_requisition.height);
711
if (grid_view->selected_item)
713
GimpView *preview = grid_view->selected_item;
715
gimp_container_grid_view_highlight_item (view,