gtkoffscreenwindow.c 10.1 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
/*
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 *
 * Authors: Cody Russell <crussell@canonical.com>
 *          Alexander Larsson <alexl@redhat.com>
 */

21 22
#include "config.h"

23
#include "gtkoffscreenwindow.h"
Emmanuele Bassi's avatar
Emmanuele Bassi committed
24
#include "gtkwidgetprivate.h"
25
#include "gtkcontainerprivate.h"
26
#include "gtkprivate.h"
27

28
/**
29
 * SECTION:gtkoffscreenwindow
30
 * @short_description: A toplevel to manage offscreen rendering of child widgets
31
 * @title: GtkOffscreenWindow
32
 *
33
 * GtkOffscreenWindow is strictly intended to be used for obtaining
34
 * snapshots of widgets that are not part of a normal widget hierarchy.
35 36 37
 * Since #GtkOffscreenWindow is a toplevel widget you cannot obtain
 * snapshots of a full window with it since you cannot pack a toplevel
 * widget in another toplevel.
38
 *
Cody Russell's avatar
Cody Russell committed
39
 * The idea is to take a widget and manually set the state of it,
40
 * add it to a GtkOffscreenWindow and then retrieve the snapshot
41
 * as a #cairo_surface_t or #GdkPixbuf.
42
 *
43
 * GtkOffscreenWindow derives from #GtkWindow only as an implementation
44 45 46
 * detail.  Applications should not use any API specific to #GtkWindow
 * to operate on this object.  It should be treated as a #GtkBin that
 * has no parent widget.
47
 *
48
 * When contained offscreen widgets are redrawn, GtkOffscreenWindow
49
 * will emit a #GtkWidget::damage-event signal.
50 51
 */

52 53 54
G_DEFINE_TYPE (GtkOffscreenWindow, gtk_offscreen_window, GTK_TYPE_WINDOW);

static void
55 56 57
gtk_offscreen_window_get_preferred_width (GtkWidget *widget,
					  gint      *minimum,
					  gint      *natural)
58 59
{
  GtkBin *bin = GTK_BIN (widget);
Javier Jardón's avatar
Javier Jardón committed
60
  GtkWidget *child;
61
  gint border_width;
62
  gint default_width;
63 64 65

  border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));

66 67
  *minimum = border_width * 2;
  *natural = border_width * 2;
68

Javier Jardón's avatar
Javier Jardón committed
69
  child = gtk_bin_get_child (bin);
70 71

  if (child != NULL && gtk_widget_get_visible (child))
72
    {
73
      gint child_min, child_nat;
74

75
      gtk_widget_get_preferred_width (child, &child_min, &child_nat);
76

77 78
      *minimum += child_min;
      *natural += child_nat;
79 80 81
    }

  gtk_window_get_default_size (GTK_WINDOW (widget),
82
                               &default_width, NULL);
83

84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
  *minimum = MAX (*minimum, default_width);
  *natural = MAX (*natural, default_width);
}

static void
gtk_offscreen_window_get_preferred_height (GtkWidget *widget,
					   gint      *minimum,
					   gint      *natural)
{
  GtkBin *bin = GTK_BIN (widget);
  GtkWidget *child;
  gint border_width;
  gint default_height;

  border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));

  *minimum = border_width * 2;
  *natural = border_width * 2;

  child = gtk_bin_get_child (bin);

  if (child != NULL && gtk_widget_get_visible (child))
    {
      gint child_min, child_nat;

      gtk_widget_get_preferred_height (child, &child_min, &child_nat);

      *minimum += child_min;
      *natural += child_nat;
    }

  gtk_window_get_default_size (GTK_WINDOW (widget),
                               NULL, &default_height);

  *minimum = MAX (*minimum, default_height);
  *natural = MAX (*natural, default_height);
120 121 122 123 124 125 126
}

static void
gtk_offscreen_window_size_allocate (GtkWidget *widget,
                                    GtkAllocation *allocation)
{
  GtkBin *bin = GTK_BIN (widget);
Javier Jardón's avatar
Javier Jardón committed
127
  GtkWidget *child;
128 129
  gint border_width;

130
  gtk_widget_set_allocation (widget, allocation);
131 132 133

  border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));

134
  if (gtk_widget_get_realized (widget))
135
    gdk_window_move_resize (gtk_widget_get_window (widget),
136 137 138 139 140
                            allocation->x,
                            allocation->y,
                            allocation->width,
                            allocation->height);

Javier Jardón's avatar
Javier Jardón committed
141
  child = gtk_bin_get_child (bin);
142 143

  if (child != NULL && gtk_widget_get_visible (child))
144 145 146 147 148 149 150 151
    {
      GtkAllocation  child_alloc;

      child_alloc.x = border_width;
      child_alloc.y = border_width;
      child_alloc.width = allocation->width - 2 * border_width;
      child_alloc.height = allocation->height - 2 * border_width;

Javier Jardón's avatar
Javier Jardón committed
152
      gtk_widget_size_allocate (child, &child_alloc);
153 154 155 156 157 158 159 160
    }

  gtk_widget_queue_draw (widget);
}

static void
gtk_offscreen_window_realize (GtkWidget *widget)
{
161
  GtkAllocation allocation;
162
  GtkBin *bin;
Javier Jardón's avatar
Javier Jardón committed
163
  GtkWidget *child;
164
  GdkWindow *window;
165 166 167 168 169
  GdkWindowAttr attributes;
  gint attributes_mask;

  bin = GTK_BIN (widget);

170
  gtk_widget_set_realized (widget, TRUE);
171

172 173 174 175 176 177
  gtk_widget_get_allocation (widget, &allocation);

  attributes.x = allocation.x;
  attributes.y = allocation.y;
  attributes.width = allocation.width;
  attributes.height = allocation.height;
178 179 180 181 182
  attributes.window_type = GDK_WINDOW_OFFSCREEN;
  attributes.event_mask = gtk_widget_get_events (widget) | GDK_EXPOSURE_MASK;
  attributes.visual = gtk_widget_get_visual (widget);
  attributes.wclass = GDK_INPUT_OUTPUT;

183
  attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
184

185 186 187 188
  window = gdk_window_new (gtk_widget_get_parent_window (widget),
                           &attributes, attributes_mask);
  gtk_widget_set_window (widget, window);
  gdk_window_set_user_data (window, widget);
189

Javier Jardón's avatar
Javier Jardón committed
190 191
  child = gtk_bin_get_child (bin);
  if (child)
192
    gtk_widget_set_parent_window (child, window);
193

194 195
  gtk_style_context_set_background (gtk_widget_get_style_context (widget),
                                    window);
196 197 198 199 200 201 202 203
}

static void
gtk_offscreen_window_resize (GtkWidget *widget)
{
  GtkAllocation allocation = { 0, 0 };
  GtkRequisition requisition;

204
  gtk_widget_get_preferred_size (widget, &requisition, NULL);
205 206 207 208 209 210 211 212 213 214 215 216

  allocation.width  = requisition.width;
  allocation.height = requisition.height;
  gtk_widget_size_allocate (widget, &allocation);
}

static void
move_focus (GtkWidget       *widget,
            GtkDirectionType dir)
{
  gtk_widget_child_focus (widget, dir);

217
  if (!gtk_container_get_focus_child (GTK_CONTAINER (widget)))
218 219 220 221 222 223 224 225 226
    gtk_window_set_focus (GTK_WINDOW (widget), NULL);
}

static void
gtk_offscreen_window_show (GtkWidget *widget)
{
  gboolean need_resize;
  GtkContainer *container;

227
  _gtk_widget_set_visible_flag (widget, TRUE);
228 229

  container = GTK_CONTAINER (widget);
230 231
  need_resize = _gtk_container_get_need_resize (container) || !gtk_widget_get_realized (widget);
  _gtk_container_set_need_resize (container, FALSE);
232 233 234 235 236 237 238 239 240 241 242 243 244 245

  if (need_resize)
    gtk_offscreen_window_resize (widget);

  gtk_widget_map (widget);

  /* Try to make sure that we have some focused widget */
  if (!gtk_window_get_focus (GTK_WINDOW (widget)))
    move_focus (widget, GTK_DIR_TAB_FORWARD);
}

static void
gtk_offscreen_window_hide (GtkWidget *widget)
{
246
  _gtk_widget_set_visible_flag (widget, FALSE);
247 248 249 250 251 252 253 254
  gtk_widget_unmap (widget);
}

static void
gtk_offscreen_window_check_resize (GtkContainer *container)
{
  GtkWidget *widget = GTK_WIDGET (container);

255
  if (gtk_widget_get_visible (widget))
256 257 258 259 260 261 262 263 264 265 266 267 268 269 270
    gtk_offscreen_window_resize (widget);
}

static void
gtk_offscreen_window_class_init (GtkOffscreenWindowClass *class)
{
  GtkWidgetClass *widget_class;
  GtkContainerClass *container_class;

  widget_class = GTK_WIDGET_CLASS (class);
  container_class = GTK_CONTAINER_CLASS (class);

  widget_class->realize = gtk_offscreen_window_realize;
  widget_class->show = gtk_offscreen_window_show;
  widget_class->hide = gtk_offscreen_window_hide;
271 272
  widget_class->get_preferred_width = gtk_offscreen_window_get_preferred_width;
  widget_class->get_preferred_height = gtk_offscreen_window_get_preferred_height;
273 274 275 276 277 278
  widget_class->size_allocate = gtk_offscreen_window_size_allocate;

  container_class->check_resize = gtk_offscreen_window_check_resize;
}

static void
Cody Russell's avatar
Cody Russell committed
279
gtk_offscreen_window_init (GtkOffscreenWindow *window)
280 281 282
{
}

283
/* --- functions --- */
284 285 286 287
/**
 * gtk_offscreen_window_new:
 *
 * Creates a toplevel container widget that is used to retrieve
288
 * snapshots of widgets without showing them on the screen.
289 290
 *
 * Return value: A pointer to a #GtkWidget
291 292
 *
 * Since: 2.20
293
 */
294 295 296 297 298 299
GtkWidget *
gtk_offscreen_window_new (void)
{
  return g_object_new (gtk_offscreen_window_get_type (), NULL);
}

300
/**
301
 * gtk_offscreen_window_get_surface:
302
 * @offscreen: the #GtkOffscreenWindow contained widget.
303 304
 *
 * Retrieves a snapshot of the contained widget in the form of
305
 * a #cairo_surface_t.  If you need to keep this around over window
306 307
 * resizes then you should add a reference to it.
 *
308 309
 * Returns: (transfer none): A #cairo_surface_t pointer to the offscreen
 *     surface, or %NULL.
310 311
 *
 * Since: 2.20
312
 */
313 314
cairo_surface_t *
gtk_offscreen_window_get_surface (GtkOffscreenWindow *offscreen)
315 316 317
{
  g_return_val_if_fail (GTK_IS_OFFSCREEN_WINDOW (offscreen), NULL);

318
  return gdk_offscreen_window_get_surface (gtk_widget_get_window (GTK_WIDGET (offscreen)));
319 320 321 322
}

/**
 * gtk_offscreen_window_get_pixbuf:
323
 * @offscreen: the #GtkOffscreenWindow contained widget.
324 325 326 327 328 329
 *
 * Retrieves a snapshot of the contained widget in the form of
 * a #GdkPixbuf.  This is a new pixbuf with a reference count of 1,
 * and the application should unreference it once it is no longer
 * needed.
 *
330
 * Returns: (transfer full): A #GdkPixbuf pointer, or %NULL.
331 332
 *
 * Since: 2.20
333
 */
334 335 336
GdkPixbuf *
gtk_offscreen_window_get_pixbuf (GtkOffscreenWindow *offscreen)
{
337
  cairo_surface_t *surface;
338
  GdkPixbuf *pixbuf = NULL;
339
  GdkWindow *window;
340 341 342

  g_return_val_if_fail (GTK_IS_OFFSCREEN_WINDOW (offscreen), NULL);

343 344
  window = gtk_widget_get_window (GTK_WIDGET (offscreen));
  surface = gdk_offscreen_window_get_surface (window);
345

346
  if (surface != NULL)
347
    {
348 349
      pixbuf = gdk_pixbuf_get_from_surface (surface,
                                            0, 0,
350 351
                                            gdk_window_get_width (window),
                                            gdk_window_get_height (window));
352 353 354 355
    }

  return pixbuf;
}