1 /* this file is part of evince, a gnome document viewer
3 * Copyright (C) 2004 Red Hat, Inc.
4 * Copyright (C) 2004, 2005 Anders Carlsson <andersca@gnome.org>
7 * Jonathan Blandford <jrb@alum.mit.edu>
8 * Anders Carlsson <andersca@gnome.org>
10 * Evince is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * Evince is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
31 #include <glib/gi18n.h>
34 #include "ev-document-misc.h"
35 #include "ev-document-thumbnails.h"
36 #include "ev-job-scheduler.h"
37 #include "ev-sidebar-page.h"
38 #include "ev-sidebar-thumbnails.h"
40 #include "ev-window.h"
42 #define THUMBNAIL_WIDTH 100
44 /* The IconView doesn't scale nearly as well as the TreeView, so we arbitrarily
46 #define MAX_ICON_VIEW_PAGE_COUNT 1500
49 struct _EvSidebarThumbnailsPrivate {
53 GtkAdjustment *vadjustment;
54 GtkListStore *list_store;
55 GdkPixbuf *loading_icon;
57 EvPageCache *page_cache;
59 gint n_pages, pages_done;
64 gint start_page, end_page;
80 static void ev_sidebar_thumbnails_clear_model (EvSidebarThumbnails *sidebar);
81 static gboolean ev_sidebar_thumbnails_support_document (EvSidebarPage *sidebar_page,
82 EvDocument *document);
83 static void ev_sidebar_thumbnails_page_iface_init (EvSidebarPageIface *iface);
84 static void ev_sidebar_thumbnails_set_document (EvSidebarPage *sidebar_page,
85 EvDocument *document);
86 static const gchar* ev_sidebar_thumbnails_get_label (EvSidebarPage *sidebar_page);
87 static void thumbnail_job_completed_callback (EvJobThumbnail *job,
88 EvSidebarThumbnails *sidebar_thumbnails);
89 static void adjustment_changed_cb (EvSidebarThumbnails *sidebar_thumbnails);
91 G_DEFINE_TYPE_EXTENDED (EvSidebarThumbnails,
92 ev_sidebar_thumbnails,
95 G_IMPLEMENT_INTERFACE (EV_TYPE_SIDEBAR_PAGE,
96 ev_sidebar_thumbnails_page_iface_init))
98 #define EV_SIDEBAR_THUMBNAILS_GET_PRIVATE(object) \
99 (G_TYPE_INSTANCE_GET_PRIVATE ((object), EV_TYPE_SIDEBAR_THUMBNAILS, EvSidebarThumbnailsPrivate));
103 ev_sidebar_thumbnails_dispose (GObject *object)
105 EvSidebarThumbnails *sidebar_thumbnails = EV_SIDEBAR_THUMBNAILS (object);
107 if (sidebar_thumbnails->priv->loading_icon) {
108 g_object_unref (sidebar_thumbnails->priv->loading_icon);
109 sidebar_thumbnails->priv->loading_icon = NULL;
112 if (sidebar_thumbnails->priv->list_store) {
113 ev_sidebar_thumbnails_clear_model (sidebar_thumbnails);
114 g_object_unref (sidebar_thumbnails->priv->list_store);
115 sidebar_thumbnails->priv->list_store = NULL;
118 G_OBJECT_CLASS (ev_sidebar_thumbnails_parent_class)->dispose (object);
122 ev_sidebar_thumbnails_get_property (GObject *object,
127 EvSidebarThumbnails *sidebar = EV_SIDEBAR_THUMBNAILS (object);
131 if (sidebar->priv->tree_view)
132 g_value_set_object (value, sidebar->priv->tree_view);
134 g_value_set_object (value, sidebar->priv->icon_view);
137 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
143 ev_sidebar_thumbnails_map (GtkWidget *widget)
145 EvSidebarThumbnails *sidebar;
147 sidebar = EV_SIDEBAR_THUMBNAILS (widget);
149 GTK_WIDGET_CLASS (ev_sidebar_thumbnails_parent_class)->map (widget);
151 adjustment_changed_cb (sidebar);
155 ev_sidebar_thumbnails_class_init (EvSidebarThumbnailsClass *ev_sidebar_thumbnails_class)
157 GObjectClass *g_object_class;
158 GtkObjectClass *gtk_object_class;
159 GtkWidgetClass *widget_class;
161 g_object_class = G_OBJECT_CLASS (ev_sidebar_thumbnails_class);
162 gtk_object_class = GTK_OBJECT_CLASS (ev_sidebar_thumbnails_class);
163 widget_class = GTK_WIDGET_CLASS (ev_sidebar_thumbnails_class);
165 g_object_class->dispose = ev_sidebar_thumbnails_dispose;
166 g_object_class->get_property = ev_sidebar_thumbnails_get_property;
167 widget_class->map = ev_sidebar_thumbnails_map;
169 g_object_class_override_property (g_object_class,
173 g_type_class_add_private (g_object_class, sizeof (EvSidebarThumbnailsPrivate));
177 ev_sidebar_thumbnails_new (void)
179 GtkWidget *ev_sidebar_thumbnails;
181 ev_sidebar_thumbnails = g_object_new (EV_TYPE_SIDEBAR_THUMBNAILS, NULL);
183 return ev_sidebar_thumbnails;
187 clear_range (EvSidebarThumbnails *sidebar_thumbnails,
191 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
196 g_assert (start_page <= end_page);
198 path = gtk_tree_path_new_from_indices (start_page, -1);
199 for (result = gtk_tree_model_get_iter (GTK_TREE_MODEL (priv->list_store), &iter, path);
200 result && start_page <= end_page;
201 result = gtk_tree_model_iter_next (GTK_TREE_MODEL (priv->list_store), &iter), start_page ++) {
204 gtk_tree_model_get (GTK_TREE_MODEL (priv->list_store),
210 g_signal_handlers_disconnect_by_func (job, thumbnail_job_completed_callback, sidebar_thumbnails);
211 ev_job_cancel (EV_JOB (job));
212 g_object_unref (job);
215 gtk_list_store_set (priv->list_store, &iter,
217 COLUMN_THUMBNAIL_SET, FALSE,
218 COLUMN_PIXBUF, priv->loading_icon,
221 gtk_tree_path_free (path);
225 get_scale_for_page (EvSidebarThumbnails *sidebar_thumbnails,
228 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
231 ev_page_cache_get_size (priv->page_cache,
233 1.0, &width, &height);
235 return (gdouble)THUMBNAIL_WIDTH / (gdouble)width;
239 add_range (EvSidebarThumbnails *sidebar_thumbnails,
243 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
247 gint page = start_page;
249 g_assert (start_page <= end_page);
251 path = gtk_tree_path_new_from_indices (start_page, -1);
252 for (result = gtk_tree_model_get_iter (GTK_TREE_MODEL (priv->list_store), &iter, path);
253 result && page <= end_page;
254 result = gtk_tree_model_iter_next (GTK_TREE_MODEL (priv->list_store), &iter), page ++) {
256 gboolean thumbnail_set;
258 gtk_tree_model_get (GTK_TREE_MODEL (priv->list_store), &iter,
260 COLUMN_THUMBNAIL_SET, &thumbnail_set,
263 if (job == NULL && !thumbnail_set) {
264 job = ev_job_thumbnail_new (priv->document,
265 page, priv->rotation,
266 get_scale_for_page (sidebar_thumbnails, page));
267 ev_job_scheduler_push_job (EV_JOB (job), EV_JOB_PRIORITY_HIGH);
269 g_object_set_data_full (G_OBJECT (job), "tree_iter",
270 gtk_tree_iter_copy (&iter),
271 (GDestroyNotify) gtk_tree_iter_free);
272 g_signal_connect (job, "finished",
273 G_CALLBACK (thumbnail_job_completed_callback),
275 gtk_list_store_set (priv->list_store, &iter,
279 /* The queue and the list own a ref to the job now */
280 g_object_unref (job);
282 g_object_unref (job);
285 gtk_tree_path_free (path);
288 /* This modifies start */
290 update_visible_range (EvSidebarThumbnails *sidebar_thumbnails,
294 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
295 int old_start_page, old_end_page;
297 old_start_page = priv->start_page;
298 old_end_page = priv->end_page;
300 if (start_page == old_start_page &&
301 end_page == old_end_page)
304 /* Clear the areas we no longer display */
305 if (old_start_page >= 0 && old_start_page < start_page)
306 clear_range (sidebar_thumbnails, old_start_page, MIN (start_page - 1, old_end_page));
308 if (old_end_page > 0 && old_end_page > end_page)
309 clear_range (sidebar_thumbnails, MAX (end_page + 1, old_start_page), old_end_page);
311 add_range (sidebar_thumbnails, start_page, end_page);
313 priv->start_page = start_page;
314 priv->end_page = end_page;
318 adjustment_changed_cb (EvSidebarThumbnails *sidebar_thumbnails)
320 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
321 GtkTreePath *path = NULL;
322 GtkTreePath *path2 = NULL;
326 /* Widget is not currently visible */
327 if (!GTK_WIDGET_MAPPED (sidebar_thumbnails))
330 if (priv->vadjustment->page_size == 0)
333 if (priv->tree_view) {
334 if (! GTK_WIDGET_REALIZED (priv->tree_view))
337 #if GTK_CHECK_VERSION (2, 11, 3)
338 gtk_tree_view_convert_tree_to_bin_window_coords (GTK_TREE_VIEW (priv->tree_view),
339 0, (int) priv->vadjustment->value,
341 gtk_tree_view_convert_tree_to_bin_window_coords (GTK_TREE_VIEW (priv->tree_view),
342 0, (int) (priv->vadjustment->value + priv->vadjustment->page_size),
345 gtk_tree_view_tree_to_widget_coords (GTK_TREE_VIEW (priv->tree_view),
346 0, (int) priv->vadjustment->value,
348 gtk_tree_view_tree_to_widget_coords (GTK_TREE_VIEW (priv->tree_view),
349 0, (int) (priv->vadjustment->value + priv->vadjustment->page_size),
351 #endif /* GTK_CHECK_VERSION (2, 11, 3) */
353 gtk_tree_view_get_path_at_pos (GTK_TREE_VIEW (priv->tree_view),
356 gtk_tree_view_get_path_at_pos (GTK_TREE_VIEW (priv->tree_view),
359 } else if (priv->icon_view) {
360 if (! GTK_WIDGET_REALIZED (priv->icon_view))
362 if (! gtk_icon_view_get_visible_range (GTK_ICON_VIEW (priv->icon_view), &path, &path2))
369 update_visible_range (sidebar_thumbnails,
370 gtk_tree_path_get_indices (path)[0],
371 gtk_tree_path_get_indices (path2)[0]);
374 gtk_tree_path_free (path);
375 gtk_tree_path_free (path2);
379 ev_sidebar_thumbnails_fill_model (EvSidebarThumbnails *sidebar_thumbnails)
381 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
385 for (i = 0; i < sidebar_thumbnails->priv->n_pages; i++) {
389 page_label = ev_page_cache_get_page_label (priv->page_cache, i);
390 page_string = g_markup_printf_escaped ("<i>%s</i>", page_label);
392 gtk_list_store_append (priv->list_store, &iter);
393 gtk_list_store_set (priv->list_store, &iter,
394 COLUMN_PAGE_STRING, page_string,
395 COLUMN_PIXBUF, priv->loading_icon,
396 COLUMN_THUMBNAIL_SET, FALSE,
399 g_free (page_string);
405 ev_sidebar_thumbnails_set_loading_icon (EvSidebarThumbnails *sidebar_thumbnails)
407 if (sidebar_thumbnails->priv->loading_icon)
408 g_object_unref (sidebar_thumbnails->priv->loading_icon);
410 if (sidebar_thumbnails->priv->document &&
411 sidebar_thumbnails->priv->n_pages > 0) {
414 /* We get the dimensions of the first page so that we can make a blank
416 ev_page_cache_get_thumbnail_size (sidebar_thumbnails->priv->page_cache, 0,
417 sidebar_thumbnails->priv->rotation,
420 sidebar_thumbnails->priv->loading_icon =
421 ev_document_misc_get_thumbnail_frame (width, height, NULL);
423 sidebar_thumbnails->priv->loading_icon = NULL;
429 refresh (EvSidebarThumbnails *sidebar_thumbnails)
431 adjustment_changed_cb (sidebar_thumbnails);
436 ev_sidebar_thumbnails_refresh (EvSidebarThumbnails *sidebar_thumbnails,
439 sidebar_thumbnails->priv->rotation = rotation;
440 ev_sidebar_thumbnails_set_loading_icon (sidebar_thumbnails);
442 if (sidebar_thumbnails->priv->document == NULL ||
443 sidebar_thumbnails->priv->n_pages <= 0)
446 ev_sidebar_thumbnails_clear_model (sidebar_thumbnails);
447 ev_sidebar_thumbnails_fill_model (sidebar_thumbnails);
449 /* Trigger a redraw */
450 sidebar_thumbnails->priv->start_page = -1;
451 sidebar_thumbnails->priv->end_page = -1;
452 g_idle_add ((GSourceFunc)refresh, sidebar_thumbnails);
456 ev_sidebar_tree_selection_changed (GtkTreeSelection *selection,
457 EvSidebarThumbnails *ev_sidebar_thumbnails)
459 EvSidebarThumbnailsPrivate *priv = ev_sidebar_thumbnails->priv;
464 if (!gtk_tree_selection_get_selected (selection, NULL, &iter))
467 path = gtk_tree_model_get_path (GTK_TREE_MODEL (priv->list_store),
469 page = gtk_tree_path_get_indices (path)[0];
470 gtk_tree_path_free (path);
472 ev_page_cache_set_current_page_history (priv->page_cache, page);
476 ev_sidebar_icon_selection_changed (GtkIconView *icon_view,
477 EvSidebarThumbnails *ev_sidebar_thumbnails)
479 EvSidebarThumbnailsPrivate *priv = ev_sidebar_thumbnails->priv;
484 selected = gtk_icon_view_get_selected_items (icon_view);
485 if (selected == NULL)
488 /* We don't handle or expect multiple selection. */
489 g_assert (selected->next == NULL);
491 path = selected->data;
492 page = gtk_tree_path_get_indices (path)[0];
494 gtk_tree_path_free (path);
495 g_list_free (selected);
497 ev_page_cache_set_current_page_history (priv->page_cache, page);
501 ev_sidebar_init_tree_view (EvSidebarThumbnails *ev_sidebar_thumbnails)
503 EvSidebarThumbnailsPrivate *priv;
504 GtkTreeSelection *selection;
505 GtkCellRenderer *renderer;
507 priv = ev_sidebar_thumbnails->priv;
508 priv->tree_view = gtk_tree_view_new_with_model (GTK_TREE_MODEL (priv->list_store));
510 selection = gtk_tree_view_get_selection (GTK_TREE_VIEW (priv->tree_view));
511 g_signal_connect (selection, "changed",
512 G_CALLBACK (ev_sidebar_tree_selection_changed), ev_sidebar_thumbnails);
513 gtk_tree_view_set_headers_visible (GTK_TREE_VIEW (priv->tree_view), FALSE);
514 renderer = g_object_new (GTK_TYPE_CELL_RENDERER_PIXBUF,
518 gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (priv->tree_view), -1,
522 gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (priv->tree_view), -1,
523 NULL, gtk_cell_renderer_text_new (),
525 gtk_container_add (GTK_CONTAINER (priv->swindow), priv->tree_view);
526 gtk_widget_show (priv->tree_view);
530 ev_sidebar_init_icon_view (EvSidebarThumbnails *ev_sidebar_thumbnails)
532 EvSidebarThumbnailsPrivate *priv;
534 priv = ev_sidebar_thumbnails->priv;
536 priv->icon_view = gtk_icon_view_new_with_model (GTK_TREE_MODEL (priv->list_store));
537 gtk_icon_view_set_markup_column (GTK_ICON_VIEW (priv->icon_view), 0);
538 gtk_icon_view_set_pixbuf_column (GTK_ICON_VIEW (priv->icon_view), 1);
539 g_signal_connect (priv->icon_view, "selection-changed",
540 G_CALLBACK (ev_sidebar_icon_selection_changed), ev_sidebar_thumbnails);
542 gtk_container_add (GTK_CONTAINER (priv->swindow), priv->icon_view);
543 gtk_widget_show (priv->icon_view);
547 ev_sidebar_thumbnails_use_icon_view (EvSidebarThumbnails *sidebar_thumbnails)
549 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
550 if (ev_page_cache_get_n_pages (priv->page_cache) > MAX_ICON_VIEW_PAGE_COUNT)
556 ev_sidebar_thumbnails_init (EvSidebarThumbnails *ev_sidebar_thumbnails)
558 EvSidebarThumbnailsPrivate *priv;
560 priv = ev_sidebar_thumbnails->priv = EV_SIDEBAR_THUMBNAILS_GET_PRIVATE (ev_sidebar_thumbnails);
562 priv->list_store = gtk_list_store_new (NUM_COLUMNS,
566 EV_TYPE_JOB_THUMBNAIL);
568 priv->swindow = gtk_scrolled_window_new (NULL, NULL);
570 /* We actually don't want GTK_POLICY_AUTOMATIC for horizontal scrollbar here
571 * it's just a workaround for bug #449462
573 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->swindow),
574 GTK_POLICY_AUTOMATIC, GTK_POLICY_AUTOMATIC);
575 gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (priv->swindow),
577 priv->vadjustment = gtk_scrolled_window_get_vadjustment (GTK_SCROLLED_WINDOW (priv->swindow));
578 g_signal_connect_data (G_OBJECT (priv->vadjustment), "value-changed",
579 G_CALLBACK (adjustment_changed_cb),
580 ev_sidebar_thumbnails, NULL,
581 G_CONNECT_SWAPPED | G_CONNECT_AFTER);
582 g_signal_connect_swapped (G_OBJECT (priv->swindow), "size-allocate",
583 G_CALLBACK (adjustment_changed_cb),
584 ev_sidebar_thumbnails);
585 gtk_box_pack_start (GTK_BOX (ev_sidebar_thumbnails), priv->swindow, TRUE, TRUE, 0);
587 /* Put it all together */
588 gtk_widget_show_all (priv->swindow);
592 page_changed_cb (EvPageCache *page_cache,
594 EvSidebarThumbnails *sidebar)
596 GtkTreeView *tree_view;
599 path = gtk_tree_path_new_from_indices (page, -1);
601 if (sidebar->priv->tree_view) {
602 tree_view = GTK_TREE_VIEW (sidebar->priv->tree_view);
603 gtk_tree_view_set_cursor (tree_view, path, NULL, FALSE);
604 gtk_tree_view_scroll_to_cell (tree_view, path, NULL, FALSE, 0.0, 0.0);
605 } else if (sidebar->priv->icon_view) {
607 g_signal_handlers_block_by_func
608 (sidebar->priv->icon_view,
609 G_CALLBACK (ev_sidebar_icon_selection_changed), sidebar);
611 gtk_icon_view_select_path (GTK_ICON_VIEW (sidebar->priv->icon_view), path);
613 g_signal_handlers_unblock_by_func
614 (sidebar->priv->icon_view,
615 G_CALLBACK (ev_sidebar_icon_selection_changed), sidebar);
617 gtk_icon_view_set_cursor (GTK_ICON_VIEW (sidebar->priv->icon_view), path, NULL, FALSE);
620 gtk_tree_path_free (path);
624 thumbnail_job_completed_callback (EvJobThumbnail *job,
625 EvSidebarThumbnails *sidebar_thumbnails)
627 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
630 iter = (GtkTreeIter *) g_object_get_data (G_OBJECT (job), "tree_iter");
631 gtk_list_store_set (priv->list_store,
633 COLUMN_PIXBUF, job->thumbnail,
634 COLUMN_THUMBNAIL_SET, TRUE,
640 ev_sidebar_thumbnails_set_document (EvSidebarPage *sidebar_page,
641 EvDocument *document)
643 EvSidebarThumbnails *sidebar_thumbnails = EV_SIDEBAR_THUMBNAILS (sidebar_page);
645 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
647 g_return_if_fail (EV_IS_DOCUMENT_THUMBNAILS (document));
649 priv->page_cache = ev_page_cache_get (document);
650 priv->document = document;
651 priv->n_pages = ev_page_cache_get_n_pages (priv->page_cache);
653 ev_sidebar_thumbnails_set_loading_icon (sidebar_thumbnails);
655 ev_sidebar_thumbnails_clear_model (sidebar_thumbnails);
656 ev_sidebar_thumbnails_fill_model (sidebar_thumbnails);
658 /* Create the view widget, and remove the old one, if needed */
659 if (ev_sidebar_thumbnails_use_icon_view (sidebar_thumbnails)) {
660 if (priv->tree_view) {
661 gtk_container_remove (GTK_CONTAINER (priv->swindow), priv->tree_view);
662 priv->tree_view = NULL;
665 if (! priv->icon_view) {
666 ev_sidebar_init_icon_view (sidebar_thumbnails);
667 g_object_notify (G_OBJECT (sidebar_thumbnails), "main_widget");
669 gtk_widget_queue_resize (priv->icon_view);
672 if (priv->icon_view) {
673 gtk_container_remove (GTK_CONTAINER (priv->swindow), priv->icon_view);
674 priv->icon_view = NULL;
677 if (! priv->tree_view) {
678 ev_sidebar_init_tree_view (sidebar_thumbnails);
679 g_object_notify (G_OBJECT (sidebar_thumbnails), "main_widget");
683 /* Connect to the signal and trigger a fake callback */
684 g_signal_connect (priv->page_cache, "page-changed", G_CALLBACK (page_changed_cb), sidebar_thumbnails);
685 sidebar_thumbnails->priv->start_page = -1;
686 sidebar_thumbnails->priv->end_page = -1;
687 page_changed_cb (priv->page_cache,
688 ev_page_cache_get_current_page (priv->page_cache),
690 adjustment_changed_cb (sidebar_thumbnails);
694 ev_sidebar_thumbnails_clear_job (GtkTreeModel *model,
701 gtk_tree_model_get (model, iter, COLUMN_JOB, &job, -1);
705 g_signal_handlers_disconnect_by_func (job, thumbnail_job_completed_callback, data);
706 g_object_unref (job);
713 ev_sidebar_thumbnails_clear_model (EvSidebarThumbnails *sidebar_thumbnails)
715 EvSidebarThumbnailsPrivate *priv = sidebar_thumbnails->priv;
717 gtk_tree_model_foreach (GTK_TREE_MODEL (priv->list_store), ev_sidebar_thumbnails_clear_job, sidebar_thumbnails);
718 gtk_list_store_clear (priv->list_store);
722 ev_sidebar_thumbnails_support_document (EvSidebarPage *sidebar_page,
723 EvDocument *document)
725 return (EV_IS_DOCUMENT_THUMBNAILS (document));
729 ev_sidebar_thumbnails_get_label (EvSidebarPage *sidebar_page)
731 return _("Thumbnails");
735 ev_sidebar_thumbnails_page_iface_init (EvSidebarPageIface *iface)
737 iface->support_document = ev_sidebar_thumbnails_support_document;
738 iface->set_document = ev_sidebar_thumbnails_set_document;
739 iface->get_label = ev_sidebar_thumbnails_get_label;