/* gtkcellrendererpixbuf.c * Copyright (C) 2000 Red Hat, Inc., Jonathan Blandford * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library 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 * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library. If not, see . */ #include "config.h" #include #include #include "gtkcellrendererpixbuf.h" #include "gtkiconhelperprivate.h" #include "gtkicontheme.h" #include "gtkintl.h" #include "gtkprivate.h" #include "gtkstylecontextprivate.h" #include "a11y/gtkimagecellaccessible.h" /** * SECTION:gtkcellrendererpixbuf * @Short_description: Renders a pixbuf in a cell * @Title: GtkCellRendererPixbuf * * A #GtkCellRendererPixbuf can be used to render an image in a cell. It allows * to render either a given #GdkPixbuf (set via the * #GtkCellRendererPixbuf:pixbuf property) or a named icon (set via the * #GtkCellRendererPixbuf:icon-name property). * * To support the tree view, #GtkCellRendererPixbuf also supports rendering two * alternative pixbufs, when the #GtkCellRenderer:is-expander property is %TRUE. * If the #GtkCellRenderer:is-expanded property is %TRUE and the * #GtkCellRendererPixbuf:pixbuf-expander-open property is set to a pixbuf, it * renders that pixbuf, if the #GtkCellRenderer:is-expanded property is %FALSE * and the #GtkCellRendererPixbuf:pixbuf-expander-closed property is set to a * pixbuf, it renders that one. */ static void gtk_cell_renderer_pixbuf_get_property (GObject *object, guint param_id, GValue *value, GParamSpec *pspec); static void gtk_cell_renderer_pixbuf_set_property (GObject *object, guint param_id, const GValue *value, GParamSpec *pspec); static void gtk_cell_renderer_pixbuf_get_size (GtkCellRenderer *cell, GtkWidget *widget, const GdkRectangle *rectangle, gint *x_offset, gint *y_offset, gint *width, gint *height); static void gtk_cell_renderer_pixbuf_snapshot (GtkCellRenderer *cell, GtkSnapshot *snapshot, GtkWidget *widget, const GdkRectangle *background_area, const GdkRectangle *cell_area, GtkCellRendererState flags); enum { PROP_0, PROP_PIXBUF, PROP_PIXBUF_EXPANDER_OPEN, PROP_PIXBUF_EXPANDER_CLOSED, PROP_SURFACE, PROP_TEXTURE, PROP_ICON_SIZE, PROP_ICON_NAME, PROP_GICON }; struct _GtkCellRendererPixbufPrivate { GtkImageDefinition *image_def; GtkIconSize icon_size; GdkPixbuf *pixbuf_expander_open; GdkPixbuf *pixbuf_expander_closed; }; G_DEFINE_TYPE_WITH_PRIVATE (GtkCellRendererPixbuf, gtk_cell_renderer_pixbuf, GTK_TYPE_CELL_RENDERER) static void gtk_cell_renderer_pixbuf_init (GtkCellRendererPixbuf *cellpixbuf) { GtkCellRendererPixbufPrivate *priv; cellpixbuf->priv = gtk_cell_renderer_pixbuf_get_instance_private (cellpixbuf); priv = cellpixbuf->priv; priv->image_def = gtk_image_definition_new_empty (); } static void gtk_cell_renderer_pixbuf_finalize (GObject *object) { GtkCellRendererPixbuf *cellpixbuf = GTK_CELL_RENDERER_PIXBUF (object); GtkCellRendererPixbufPrivate *priv = cellpixbuf->priv; gtk_image_definition_unref (priv->image_def); if (priv->pixbuf_expander_open) g_object_unref (priv->pixbuf_expander_open); if (priv->pixbuf_expander_closed) g_object_unref (priv->pixbuf_expander_closed); G_OBJECT_CLASS (gtk_cell_renderer_pixbuf_parent_class)->finalize (object); } static void gtk_cell_renderer_pixbuf_class_init (GtkCellRendererPixbufClass *class) { GObjectClass *object_class = G_OBJECT_CLASS (class); GtkCellRendererClass *cell_class = GTK_CELL_RENDERER_CLASS (class); object_class->finalize = gtk_cell_renderer_pixbuf_finalize; object_class->get_property = gtk_cell_renderer_pixbuf_get_property; object_class->set_property = gtk_cell_renderer_pixbuf_set_property; cell_class->get_size = gtk_cell_renderer_pixbuf_get_size; cell_class->snapshot = gtk_cell_renderer_pixbuf_snapshot; g_object_class_install_property (object_class, PROP_PIXBUF, g_param_spec_object ("pixbuf", P_("Pixbuf Object"), P_("The pixbuf to render"), GDK_TYPE_PIXBUF, GTK_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_PIXBUF_EXPANDER_OPEN, g_param_spec_object ("pixbuf-expander-open", P_("Pixbuf Expander Open"), P_("Pixbuf for open expander"), GDK_TYPE_PIXBUF, GTK_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_PIXBUF_EXPANDER_CLOSED, g_param_spec_object ("pixbuf-expander-closed", P_("Pixbuf Expander Closed"), P_("Pixbuf for closed expander"), GDK_TYPE_PIXBUF, GTK_PARAM_READWRITE)); /** * GtkCellRendererPixbuf:surface: * * Since: 3.10 */ g_object_class_install_property (object_class, PROP_SURFACE, g_param_spec_boxed ("surface", P_("surface"), P_("The surface to render"), CAIRO_GOBJECT_TYPE_SURFACE, GTK_PARAM_READWRITE)); /** * GtkCellRendererPixbuf:texture: * * Since: 3.94 */ g_object_class_install_property (object_class, PROP_TEXTURE, g_param_spec_object ("texture", P_("Texture"), P_("The texture to render"), GDK_TYPE_TEXTURE, GTK_PARAM_READWRITE)); /** * GtkCellRendererPixbuf:icon-size: * * The #GtkIconSize value that specifies the size of the rendered icon. * * Since: 3.94 */ g_object_class_install_property (object_class, PROP_ICON_SIZE, g_param_spec_enum ("icon-size", P_("Icon Size"), P_("The GtkIconSize value that specifies the size of the rendered icon"), GTK_TYPE_ICON_SIZE, GTK_ICON_SIZE_INHERIT, GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY)); /** * GtkCellRendererPixbuf:icon-name: * * The name of the themed icon to display. * This property only has an effect if not overridden by the "pixbuf" property. * * Since: 2.8 */ g_object_class_install_property (object_class, PROP_ICON_NAME, g_param_spec_string ("icon-name", P_("Icon Name"), P_("The name of the icon from the icon theme"), NULL, GTK_PARAM_READWRITE)); /** * GtkCellRendererPixbuf:gicon: * * The GIcon representing the icon to display. * If the icon theme is changed, the image will be updated * automatically. * * Since: 2.14 */ g_object_class_install_property (object_class, PROP_GICON, g_param_spec_object ("gicon", P_("Icon"), P_("The GIcon being displayed"), G_TYPE_ICON, GTK_PARAM_READWRITE)); gtk_cell_renderer_class_set_accessible_type (cell_class, GTK_TYPE_IMAGE_CELL_ACCESSIBLE); } static void gtk_cell_renderer_pixbuf_get_property (GObject *object, guint param_id, GValue *value, GParamSpec *pspec) { GtkCellRendererPixbuf *cellpixbuf = GTK_CELL_RENDERER_PIXBUF (object); GtkCellRendererPixbufPrivate *priv = cellpixbuf->priv; cairo_surface_t *surface; GdkPixbuf *pixbuf; switch (param_id) { case PROP_PIXBUF: pixbuf = NULL; surface = gtk_image_definition_get_surface (priv->image_def); if (surface) { pixbuf = gdk_pixbuf_get_from_surface (surface, 0, 0, cairo_image_surface_get_width (surface), cairo_image_surface_get_height (surface)); cairo_surface_destroy (surface); } g_value_take_object (value, pixbuf); break; case PROP_PIXBUF_EXPANDER_OPEN: g_value_set_object (value, priv->pixbuf_expander_open); break; case PROP_PIXBUF_EXPANDER_CLOSED: g_value_set_object (value, priv->pixbuf_expander_closed); break; case PROP_SURFACE: g_value_set_boxed (value, gtk_image_definition_get_surface (priv->image_def)); break; case PROP_TEXTURE: g_value_set_object (value, gtk_image_definition_get_texture (priv->image_def)); break; case PROP_ICON_SIZE: g_value_set_enum (value, priv->icon_size); break; case PROP_ICON_NAME: g_value_set_string (value, gtk_image_definition_get_icon_name (priv->image_def)); break; case PROP_GICON: g_value_set_object (value, gtk_image_definition_get_gicon (priv->image_def)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec); break; } } static void notify_storage_type (GtkCellRendererPixbuf *cellpixbuf, GtkImageType storage_type) { switch (storage_type) { case GTK_IMAGE_SURFACE: g_object_notify (G_OBJECT (cellpixbuf), "surface"); break; case GTK_IMAGE_TEXTURE: g_object_notify (G_OBJECT (cellpixbuf), "texture"); break; case GTK_IMAGE_ICON_NAME: g_object_notify (G_OBJECT (cellpixbuf), "icon-name"); break; case GTK_IMAGE_GICON: g_object_notify (G_OBJECT (cellpixbuf), "gicon"); break; default: g_assert_not_reached (); case GTK_IMAGE_EMPTY: break; } } static void take_image_definition (GtkCellRendererPixbuf *cellpixbuf, GtkImageDefinition *def) { GtkCellRendererPixbufPrivate *priv; GtkImageType old_storage_type, new_storage_type; if (def == NULL) def = gtk_image_definition_new_empty (); priv = cellpixbuf->priv; old_storage_type = gtk_image_definition_get_storage_type (priv->image_def); new_storage_type = gtk_image_definition_get_storage_type (def); if (new_storage_type != old_storage_type) notify_storage_type (cellpixbuf, old_storage_type); gtk_image_definition_unref (priv->image_def); priv->image_def = def; } static void gtk_cell_renderer_pixbuf_set_icon_size (GtkCellRendererPixbuf *cellpixbuf, GtkIconSize icon_size) { GtkCellRendererPixbufPrivate *priv = cellpixbuf->priv; if (priv->icon_size == icon_size) return; priv->icon_size = icon_size; g_object_notify (G_OBJECT (cellpixbuf), "icon-size"); } static void gtk_cell_renderer_pixbuf_set_property (GObject *object, guint param_id, const GValue *value, GParamSpec *pspec) { GtkCellRendererPixbuf *cellpixbuf = GTK_CELL_RENDERER_PIXBUF (object); GtkCellRendererPixbufPrivate *priv = cellpixbuf->priv; cairo_surface_t *surface; GdkPixbuf *pixbuf; switch (param_id) { case PROP_PIXBUF: surface = NULL; pixbuf = g_value_get_object (value); if (pixbuf) surface = gdk_cairo_surface_create_from_pixbuf (pixbuf, 1, NULL); take_image_definition (cellpixbuf, gtk_image_definition_new_surface (surface)); break; case PROP_PIXBUF_EXPANDER_OPEN: if (priv->pixbuf_expander_open) g_object_unref (priv->pixbuf_expander_open); priv->pixbuf_expander_open = (GdkPixbuf*) g_value_dup_object (value); break; case PROP_PIXBUF_EXPANDER_CLOSED: if (priv->pixbuf_expander_closed) g_object_unref (priv->pixbuf_expander_closed); priv->pixbuf_expander_closed = (GdkPixbuf*) g_value_dup_object (value); break; case PROP_SURFACE: take_image_definition (cellpixbuf, gtk_image_definition_new_surface (g_value_get_boxed (value))); break; case PROP_TEXTURE: take_image_definition (cellpixbuf, gtk_image_definition_new_texture (g_value_get_object (value))); break; case PROP_ICON_SIZE: gtk_cell_renderer_pixbuf_set_icon_size (cellpixbuf, g_value_get_enum (value)); break; case PROP_ICON_NAME: take_image_definition (cellpixbuf, gtk_image_definition_new_icon_name (g_value_get_string (value))); break; case PROP_GICON: take_image_definition (cellpixbuf, gtk_image_definition_new_gicon (g_value_get_object (value))); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec); break; } } /** * gtk_cell_renderer_pixbuf_new: * * Creates a new #GtkCellRendererPixbuf. Adjust rendering * parameters using object properties. Object properties can be set * globally (with g_object_set()). Also, with #GtkTreeViewColumn, you * can bind a property to a value in a #GtkTreeModel. For example, you * can bind the “pixbuf” property on the cell renderer to a pixbuf value * in the model, thus rendering a different image in each row of the * #GtkTreeView. * * Returns: the new cell renderer **/ GtkCellRenderer * gtk_cell_renderer_pixbuf_new (void) { return g_object_new (GTK_TYPE_CELL_RENDERER_PIXBUF, NULL); } static void create_icon_helper (GtkIconHelper *icon_helper, GtkCellRendererPixbuf *cellpixbuf, GtkWidget *widget) { GtkCellRendererPixbufPrivate *priv = cellpixbuf->priv; gtk_icon_helper_init (icon_helper, gtk_style_context_get_node (gtk_widget_get_style_context (widget)), widget); _gtk_icon_helper_set_force_scale_pixbuf (icon_helper, TRUE); _gtk_icon_helper_set_definition (icon_helper, priv->image_def); } static void gtk_cell_renderer_pixbuf_get_size (GtkCellRenderer *cell, GtkWidget *widget, const GdkRectangle *cell_area, gint *x_offset, gint *y_offset, gint *width, gint *height) { GtkCellRendererPixbuf *cellpixbuf = (GtkCellRendererPixbuf *) cell; GtkCellRendererPixbufPrivate *priv = cellpixbuf->priv; gint pixbuf_width = 0; gint pixbuf_height = 0; gint calc_width; gint calc_height; gint xpad, ypad; GtkStyleContext *context; GtkIconHelper icon_helper; context = gtk_widget_get_style_context (widget); gtk_style_context_save (context); gtk_style_context_add_class (context, GTK_STYLE_CLASS_IMAGE); gtk_icon_size_set_style_classes (gtk_style_context_get_node (context), priv->icon_size); create_icon_helper (&icon_helper, cellpixbuf, widget); if (!_gtk_icon_helper_get_is_empty (&icon_helper)) _gtk_icon_helper_get_size (&icon_helper, &pixbuf_width, &pixbuf_height); gtk_icon_helper_destroy (&icon_helper); gtk_style_context_restore (context); if (priv->pixbuf_expander_open) { pixbuf_width = MAX (pixbuf_width, gdk_pixbuf_get_width (priv->pixbuf_expander_open)); pixbuf_height = MAX (pixbuf_height, gdk_pixbuf_get_height (priv->pixbuf_expander_open)); } if (priv->pixbuf_expander_closed) { pixbuf_width = MAX (pixbuf_width, gdk_pixbuf_get_width (priv->pixbuf_expander_closed)); pixbuf_height = MAX (pixbuf_height, gdk_pixbuf_get_height (priv->pixbuf_expander_closed)); } gtk_cell_renderer_get_padding (cell, &xpad, &ypad); calc_width = (gint) xpad * 2 + pixbuf_width; calc_height = (gint) ypad * 2 + pixbuf_height; if (cell_area && pixbuf_width > 0 && pixbuf_height > 0) { gfloat xalign, yalign; gtk_cell_renderer_get_alignment (cell, &xalign, &yalign); if (x_offset) { *x_offset = (((gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL) ? (1.0 - xalign) : xalign) * (cell_area->width - calc_width)); *x_offset = MAX (*x_offset, 0); } if (y_offset) { *y_offset = (yalign * (cell_area->height - calc_height)); *y_offset = MAX (*y_offset, 0); } } else { if (x_offset) *x_offset = 0; if (y_offset) *y_offset = 0; } if (width) *width = calc_width; if (height) *height = calc_height; } static void gtk_cell_renderer_pixbuf_snapshot (GtkCellRenderer *cell, GtkSnapshot *snapshot, GtkWidget *widget, const GdkRectangle *background_area, const GdkRectangle *cell_area, GtkCellRendererState flags) { GtkCellRendererPixbuf *cellpixbuf = (GtkCellRendererPixbuf *) cell; GtkCellRendererPixbufPrivate *priv = cellpixbuf->priv; GtkStyleContext *context; GdkRectangle pix_rect; GdkRectangle draw_rect; gboolean is_expander; gint xpad, ypad; GtkIconHelper icon_helper; cairo_surface_t *surface; gtk_cell_renderer_pixbuf_get_size (cell, widget, (GdkRectangle *) cell_area, &pix_rect.x, &pix_rect.y, &pix_rect.width, &pix_rect.height); gtk_cell_renderer_get_padding (cell, &xpad, &ypad); pix_rect.x += cell_area->x + xpad; pix_rect.y += cell_area->y + ypad; pix_rect.width -= xpad * 2; pix_rect.height -= ypad * 2; if (!gdk_rectangle_intersect (cell_area, &pix_rect, &draw_rect)) return; context = gtk_widget_get_style_context (widget); gtk_style_context_save (context); gtk_style_context_add_class (context, GTK_STYLE_CLASS_IMAGE); gtk_icon_size_set_style_classes (gtk_style_context_get_node (context), priv->icon_size); g_object_get (cell, "is-expander", &is_expander, NULL); if (is_expander) { gboolean is_expanded; g_object_get (cell, "is-expanded", &is_expanded, NULL); if (is_expanded && priv->pixbuf_expander_open != NULL) { gtk_icon_helper_init (&icon_helper, gtk_style_context_get_node (context), widget); surface = gdk_cairo_surface_create_from_pixbuf (priv->pixbuf_expander_open, 1, NULL); _gtk_icon_helper_set_surface (&icon_helper, surface); cairo_surface_destroy (surface); } else if (!is_expanded && priv->pixbuf_expander_closed != NULL) { gtk_icon_helper_init (&icon_helper, gtk_style_context_get_node (context), widget); surface = gdk_cairo_surface_create_from_pixbuf (priv->pixbuf_expander_closed, 1, NULL); _gtk_icon_helper_set_surface (&icon_helper, surface); cairo_surface_destroy (surface); } else { create_icon_helper (&icon_helper, cellpixbuf, widget); } } else { create_icon_helper (&icon_helper, cellpixbuf, widget); } gtk_snapshot_offset (snapshot, pix_rect.x, pix_rect.y); gtk_icon_helper_snapshot (&icon_helper, snapshot); gtk_snapshot_offset (snapshot, - pix_rect.x, - pix_rect.y); gtk_icon_helper_destroy (&icon_helper); gtk_style_context_restore (context); }