 63f2fd9614
			
		
	
	63f2fd9614
	
	
	
		
			
			Wed Dec 22 14:22:19 2004 Søren Sandmann <sandmann@redhat.com> * tests/testtoolbar.c (timeout_cb): Add sensitivity-changing timeout. Written by Christian Persch. Wed Dec 22 14:14:02 2004 Søren Sandmann <sandmann@redhat.com> Bug #161561 * gdk/x11/gdkwindow-x11.c (tmp_{re,un}set_bg): Only set/reset the background for windows that get expose events. * gdk/gdkwindow.c (gdk_window_process_updates_internal): Remove hack to repaint !expose windows.
		
			
				
	
	
		
			2862 lines
		
	
	
		
			80 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			2862 lines
		
	
	
		
			80 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /* GDK - The GIMP Drawing Kit
 | |
|  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 | |
|  *
 | |
|  * 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.
 | |
|  */
 | |
| 
 | |
| /*
 | |
|  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
 | |
|  * file for a list of people on the GTK+ Team.  See the ChangeLog
 | |
|  * files for a list of changes.  These files are distributed with
 | |
|  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
 | |
|  */
 | |
| 
 | |
| #include <config.h>
 | |
| #include "gdkalias.h"
 | |
| #include "gdkwindow.h"
 | |
| #include "gdkinternals.h"
 | |
| #include "gdk.h"		/* For gdk_rectangle_union() */
 | |
| #include "gdkpixmap.h"
 | |
| #include "gdkdrawable.h"
 | |
| #include "gdkpixmap.h"
 | |
| #include "gdkscreen.h"
 | |
| 
 | |
| #define USE_BACKING_STORE	/* Appears to work on Win32, too, now. */
 | |
| 
 | |
| typedef struct _GdkWindowPaint GdkWindowPaint;
 | |
| 
 | |
| struct _GdkWindowPaint
 | |
| {
 | |
|   GdkRegion *region;
 | |
|   GdkPixmap *pixmap;
 | |
|   gint x_offset;
 | |
|   gint y_offset;
 | |
| };
 | |
| 
 | |
| static GdkGC *gdk_window_create_gc      (GdkDrawable     *drawable,
 | |
|                                          GdkGCValues     *values,
 | |
|                                          GdkGCValuesMask  mask);
 | |
| static void   gdk_window_draw_rectangle (GdkDrawable     *drawable,
 | |
|                                          GdkGC           *gc,
 | |
|                                          gboolean         filled,
 | |
|                                          gint             x,
 | |
|                                          gint             y,
 | |
|                                          gint             width,
 | |
|                                          gint             height);
 | |
| static void   gdk_window_draw_arc       (GdkDrawable     *drawable,
 | |
|                                          GdkGC           *gc,
 | |
|                                          gboolean         filled,
 | |
|                                          gint             x,
 | |
|                                          gint             y,
 | |
|                                          gint             width,
 | |
|                                          gint             height,
 | |
|                                          gint             angle1,
 | |
|                                          gint             angle2);
 | |
| static void   gdk_window_draw_polygon   (GdkDrawable     *drawable,
 | |
|                                          GdkGC           *gc,
 | |
|                                          gboolean         filled,
 | |
|                                          GdkPoint        *points,
 | |
|                                          gint             npoints);
 | |
| static void   gdk_window_draw_text      (GdkDrawable     *drawable,
 | |
|                                          GdkFont         *font,
 | |
|                                          GdkGC           *gc,
 | |
|                                          gint             x,
 | |
|                                          gint             y,
 | |
|                                          const gchar     *text,
 | |
|                                          gint             text_length);
 | |
| static void   gdk_window_draw_text_wc   (GdkDrawable     *drawable,
 | |
|                                          GdkFont         *font,
 | |
|                                          GdkGC           *gc,
 | |
|                                          gint             x,
 | |
|                                          gint             y,
 | |
|                                          const GdkWChar  *text,
 | |
|                                          gint             text_length);
 | |
| static void   gdk_window_draw_drawable  (GdkDrawable     *drawable,
 | |
|                                          GdkGC           *gc,
 | |
|                                          GdkPixmap       *src,
 | |
|                                          gint             xsrc,
 | |
|                                          gint             ysrc,
 | |
|                                          gint             xdest,
 | |
|                                          gint             ydest,
 | |
|                                          gint             width,
 | |
|                                          gint             height);
 | |
| static void   gdk_window_draw_points    (GdkDrawable     *drawable,
 | |
|                                          GdkGC           *gc,
 | |
|                                          GdkPoint        *points,
 | |
|                                          gint             npoints);
 | |
| static void   gdk_window_draw_segments  (GdkDrawable     *drawable,
 | |
|                                          GdkGC           *gc,
 | |
|                                          GdkSegment      *segs,
 | |
|                                          gint             nsegs);
 | |
| static void   gdk_window_draw_lines     (GdkDrawable     *drawable,
 | |
| 					 GdkGC           *gc,
 | |
| 					 GdkPoint        *points,
 | |
| 					 gint             npoints);
 | |
| 
 | |
| static void gdk_window_draw_glyphs             (GdkDrawable      *drawable,
 | |
| 						GdkGC            *gc,
 | |
| 						PangoFont        *font,
 | |
| 						gint              x,
 | |
| 						gint              y,
 | |
| 						PangoGlyphString *glyphs);
 | |
| static void gdk_window_draw_glyphs_transformed (GdkDrawable      *drawable,
 | |
| 						GdkGC            *gc,
 | |
| 						PangoMatrix      *matrix,
 | |
| 						PangoFont        *font,
 | |
| 						gint              x,
 | |
| 						gint              y,
 | |
| 						PangoGlyphString *glyphs);
 | |
| 
 | |
| static void   gdk_window_draw_image     (GdkDrawable     *drawable,
 | |
|                                          GdkGC           *gc,
 | |
|                                          GdkImage        *image,
 | |
|                                          gint             xsrc,
 | |
|                                          gint             ysrc,
 | |
|                                          gint             xdest,
 | |
|                                          gint             ydest,
 | |
|                                          gint             width,
 | |
|                                          gint             height);
 | |
| 
 | |
| static void gdk_window_draw_pixbuf (GdkDrawable     *drawable,
 | |
| 				    GdkGC           *gc,
 | |
| 				    GdkPixbuf       *pixbuf,
 | |
| 				    gint             src_x,
 | |
| 				    gint             src_y,
 | |
| 				    gint             dest_x,
 | |
| 				    gint             dest_y,
 | |
| 				    gint             width,
 | |
| 				    gint             height,
 | |
| 				    GdkRgbDither     dither,
 | |
| 				    gint             x_dither,
 | |
| 				    gint             y_dither);
 | |
| 
 | |
| static void gdk_window_draw_trapezoids (GdkDrawable   *drawable,
 | |
| 					GdkGC	      *gc,
 | |
| 					GdkTrapezoid  *trapezoids,
 | |
| 					gint           n_trapezoids);
 | |
| 
 | |
| static GdkImage* gdk_window_copy_to_image (GdkDrawable *drawable,
 | |
| 					   GdkImage    *image,
 | |
| 					   gint         src_x,
 | |
| 					   gint         src_y,
 | |
| 					   gint         dest_x,
 | |
| 					   gint         dest_y,
 | |
| 					   gint         width,
 | |
| 					   gint         height);
 | |
| 
 | |
| static void   gdk_window_real_get_size  (GdkDrawable     *drawable,
 | |
|                                          gint            *width,
 | |
|                                          gint            *height);
 | |
| 
 | |
| static GdkVisual*   gdk_window_real_get_visual   (GdkDrawable *drawable);
 | |
| static gint         gdk_window_real_get_depth    (GdkDrawable *drawable);
 | |
| static GdkScreen*   gdk_window_real_get_screen   (GdkDrawable *drawable);
 | |
| static void         gdk_window_real_set_colormap (GdkDrawable *drawable,
 | |
| 						  GdkColormap *cmap);
 | |
| static GdkColormap* gdk_window_real_get_colormap (GdkDrawable *drawable);
 | |
| 
 | |
| static GdkDrawable* gdk_window_get_composite_drawable (GdkDrawable *drawable,
 | |
| 						       gint         x,
 | |
| 						       gint         y,
 | |
| 						       gint         width,
 | |
| 						       gint         height,
 | |
| 						       gint        *composite_x_offset,
 | |
| 						       gint        *composite_y_offset);
 | |
| static GdkRegion*   gdk_window_get_clip_region        (GdkDrawable *drawable);
 | |
| static GdkRegion*   gdk_window_get_visible_region     (GdkDrawable *drawable);
 | |
| 
 | |
| static void gdk_window_free_paint_stack (GdkWindow *window);
 | |
| 
 | |
| static void gdk_window_init       (GdkWindowObject      *window);
 | |
| static void gdk_window_class_init (GdkWindowObjectClass *klass);
 | |
| static void gdk_window_finalize   (GObject              *object);
 | |
| static void gdk_window_clear_backing_rect (GdkWindow *window,
 | |
| 					   gint       x,
 | |
| 					   gint       y,
 | |
| 					   gint       width,
 | |
| 					   gint       height);
 | |
| 
 | |
| static gpointer parent_class = NULL;
 | |
| 
 | |
| GType
 | |
| gdk_window_object_get_type (void)
 | |
| {
 | |
|   static GType object_type = 0;
 | |
| 
 | |
|   if (!object_type)
 | |
|     {
 | |
|       static const GTypeInfo object_info =
 | |
|       {
 | |
|         sizeof (GdkWindowObjectClass),
 | |
|         (GBaseInitFunc) NULL,
 | |
|         (GBaseFinalizeFunc) NULL,
 | |
|         (GClassInitFunc) gdk_window_class_init,
 | |
|         NULL,           /* class_finalize */
 | |
|         NULL,           /* class_data */
 | |
|         sizeof (GdkWindowObject),
 | |
|         0,              /* n_preallocs */
 | |
|         (GInstanceInitFunc) gdk_window_init,
 | |
|       };
 | |
|       
 | |
|       object_type = g_type_register_static (GDK_TYPE_DRAWABLE,
 | |
|                                             "GdkWindow",
 | |
|                                             &object_info, 0);
 | |
|     }
 | |
|   
 | |
|   return object_type;
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_init (GdkWindowObject *window)
 | |
| {
 | |
|   /* 0-initialization is good for all other fields. */
 | |
| 
 | |
|   window->window_type = GDK_WINDOW_CHILD;
 | |
| 
 | |
|   window->state = GDK_WINDOW_STATE_WITHDRAWN;
 | |
|   
 | |
|   window->impl = g_object_new (_gdk_window_impl_get_type (), NULL);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_class_init (GdkWindowObjectClass *klass)
 | |
| {
 | |
|   GObjectClass *object_class = G_OBJECT_CLASS (klass);
 | |
|   GdkDrawableClass *drawable_class = GDK_DRAWABLE_CLASS (klass);
 | |
|   
 | |
|   parent_class = g_type_class_peek_parent (klass);
 | |
| 
 | |
|   object_class->finalize = gdk_window_finalize;
 | |
| 
 | |
|   drawable_class->create_gc = gdk_window_create_gc;
 | |
|   drawable_class->draw_rectangle = gdk_window_draw_rectangle;
 | |
|   drawable_class->draw_arc = gdk_window_draw_arc;
 | |
|   drawable_class->draw_polygon = gdk_window_draw_polygon;
 | |
|   drawable_class->draw_text = gdk_window_draw_text;
 | |
|   drawable_class->draw_text_wc = gdk_window_draw_text_wc;
 | |
|   drawable_class->draw_drawable = gdk_window_draw_drawable;
 | |
|   drawable_class->draw_points = gdk_window_draw_points;
 | |
|   drawable_class->draw_segments = gdk_window_draw_segments;
 | |
|   drawable_class->draw_lines = gdk_window_draw_lines;
 | |
|   drawable_class->draw_glyphs = gdk_window_draw_glyphs;
 | |
|   drawable_class->draw_glyphs_transformed = gdk_window_draw_glyphs_transformed;
 | |
|   drawable_class->draw_image = gdk_window_draw_image;
 | |
|   drawable_class->draw_pixbuf = gdk_window_draw_pixbuf;
 | |
|   drawable_class->draw_trapezoids = gdk_window_draw_trapezoids;
 | |
|   drawable_class->get_depth = gdk_window_real_get_depth;
 | |
|   drawable_class->get_screen = gdk_window_real_get_screen;
 | |
|   drawable_class->get_size = gdk_window_real_get_size;
 | |
|   drawable_class->set_colormap = gdk_window_real_set_colormap;
 | |
|   drawable_class->get_colormap = gdk_window_real_get_colormap;
 | |
|   drawable_class->get_visual = gdk_window_real_get_visual;
 | |
|   drawable_class->_copy_to_image = gdk_window_copy_to_image;
 | |
|   drawable_class->get_clip_region = gdk_window_get_clip_region;
 | |
|   drawable_class->get_visible_region = gdk_window_get_visible_region;
 | |
|   drawable_class->get_composite_drawable = gdk_window_get_composite_drawable;
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_finalize (GObject *object)
 | |
| {
 | |
|   GdkWindow *window = GDK_WINDOW (object);
 | |
|   GdkWindowObject *obj = (GdkWindowObject *) object;
 | |
|   
 | |
|   if (!GDK_WINDOW_DESTROYED (window))
 | |
|     {
 | |
|       if (GDK_WINDOW_TYPE (window) != GDK_WINDOW_FOREIGN)
 | |
| 	{
 | |
| 	  g_warning ("losing last reference to undestroyed window\n");
 | |
| 	  _gdk_window_destroy (window, FALSE);
 | |
| 	}
 | |
|       else
 | |
| 	/* We use TRUE here, to keep us from actually calling
 | |
| 	 * XDestroyWindow() on the window
 | |
| 	 */
 | |
| 	_gdk_window_destroy (window, TRUE);
 | |
|     }
 | |
| 
 | |
|   g_object_unref (obj->impl);
 | |
|   obj->impl = NULL;
 | |
|   
 | |
|   G_OBJECT_CLASS (parent_class)->finalize (object);
 | |
| }
 | |
| 
 | |
| static void
 | |
| window_remove_filters (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *obj = (GdkWindowObject*) window;
 | |
| 
 | |
|   if (obj->filters)
 | |
|     {
 | |
|       GList *tmp_list;
 | |
|       
 | |
|       for (tmp_list = obj->filters; tmp_list; tmp_list = tmp_list->next)
 | |
| 	g_free (tmp_list->data);
 | |
|     
 | |
|       g_list_free (obj->filters);
 | |
|       obj->filters = NULL;
 | |
|     }
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * _gdk_window_destroy_hierarchy:
 | |
|  * @window: a #GdkWindow
 | |
|  * @recursing: If TRUE, then this is being called because a parent
 | |
|  *            was destroyed. This generally means that the call to the 
 | |
|  *            windowing system to destroy the window can be omitted, since
 | |
|  *            it will be destroyed as a result of the parent being destroyed.
 | |
|  *            Unless @foreign_destroy.           
 | |
|  * @foreign_destroy: If TRUE, the window or a parent was destroyed by some 
 | |
|  *            external agency. The window has already been destroyed and no 
 | |
|  *            windowing system calls should be made. (This may never happen
 | |
|  *            for some windowing systems.)
 | |
|  *
 | |
|  * Internal function to destroy a window. Like gdk_window_destroy(),
 | |
|  * but does not drop the reference count created by gdk_window_new().
 | |
|  **/
 | |
| static void
 | |
| _gdk_window_destroy_hierarchy (GdkWindow *window,
 | |
| 			       gboolean   recursing,
 | |
| 			       gboolean   foreign_destroy)
 | |
| {
 | |
|   GdkWindowObject *private;
 | |
|   GdkWindowObject *temp_private;
 | |
|   GdkWindow *temp_window;
 | |
|   GList *children;
 | |
|   GList *tmp;
 | |
|   
 | |
|   g_return_if_fail (window != NULL);
 | |
|   
 | |
|   private = (GdkWindowObject*) window;
 | |
|   
 | |
|   if (GDK_WINDOW_DESTROYED (window))
 | |
|     return;
 | |
|     
 | |
|   switch (GDK_WINDOW_TYPE (window))
 | |
|     {
 | |
|     case GDK_WINDOW_TOPLEVEL:
 | |
|     case GDK_WINDOW_CHILD:
 | |
|     case GDK_WINDOW_DIALOG:
 | |
|     case GDK_WINDOW_TEMP:
 | |
|     case GDK_WINDOW_FOREIGN:
 | |
|       if (GDK_WINDOW_TYPE (window) == GDK_WINDOW_FOREIGN && !foreign_destroy)
 | |
| 	{
 | |
| 	  /* Logically, it probably makes more sense to send
 | |
| 	   * a "destroy yourself" message to the foreign window
 | |
| 	   * whether or not it's in our heirarchy; but for historical
 | |
| 	   * reasons, we only send "destroy yourself" messages to
 | |
| 	   * foreign windows in our heirarchy.
 | |
| 	   */
 | |
| 	  if (private->parent)
 | |
| 	    _gdk_windowing_window_destroy_foreign (window);
 | |
| 
 | |
| 	  /* Also for historical reasons, we remove any filters
 | |
| 	   * on a foreign window when it or a parent is destroyed;
 | |
| 	   * this likely causes problems if two separate portions
 | |
| 	   * of code are maintaining filter lists on a foreign window.
 | |
| 	   */
 | |
| 	  window_remove_filters (window);
 | |
| 	}
 | |
|       else
 | |
| 	{
 | |
| 	  private->state |= GDK_WINDOW_STATE_WITHDRAWN;
 | |
| 	  
 | |
| 	  if (private->parent)
 | |
| 	    {
 | |
| 	      GdkWindowObject *parent_private = (GdkWindowObject *)private->parent;
 | |
| 	      if (parent_private->children)
 | |
| 		parent_private->children = g_list_remove (parent_private->children, window);
 | |
| 	    }
 | |
| 
 | |
| 	  _gdk_window_clear_update_area (window);
 | |
| 	  gdk_window_free_paint_stack (window);
 | |
| 	  
 | |
| 	  if (private->bg_pixmap &&
 | |
|               private->bg_pixmap != GDK_PARENT_RELATIVE_BG &&
 | |
|               private->bg_pixmap != GDK_NO_BG)
 | |
| 	    {
 | |
| 	      g_object_unref (private->bg_pixmap);
 | |
| 	      private->bg_pixmap = NULL;
 | |
| 	    }
 | |
| 	  
 | |
| 	  if (GDK_WINDOW_TYPE (window) == GDK_WINDOW_FOREIGN)
 | |
| 	    g_assert (private->children == NULL);
 | |
| 	  else
 | |
| 	    {
 | |
| 	      children = tmp = private->children;
 | |
| 	      private->children = NULL;
 | |
| 	      
 | |
| 	      while (tmp)
 | |
| 		{
 | |
| 		  temp_window = tmp->data;
 | |
| 		  tmp = tmp->next;
 | |
| 		  
 | |
| 		  temp_private = (GdkWindowObject*) temp_window;
 | |
| 		  if (temp_private)
 | |
| 		    _gdk_window_destroy_hierarchy (temp_window,
 | |
|                                                    TRUE, foreign_destroy);
 | |
| 		}
 | |
| 	      
 | |
| 	      g_list_free (children);
 | |
| 	    }
 | |
| 	  
 | |
| 	  _gdk_windowing_window_destroy (window, recursing, foreign_destroy);
 | |
| 	  private->parent = NULL;
 | |
| 	  private->destroyed = TRUE;
 | |
| 
 | |
| 	  window_remove_filters (window);
 | |
| 
 | |
|           gdk_drawable_set_colormap (GDK_DRAWABLE (window), NULL);
 | |
| 	}
 | |
|       break;
 | |
|       
 | |
|     case GDK_WINDOW_ROOT:
 | |
|       g_error ("attempted to destroy root window");
 | |
|       break;
 | |
|     }
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * _gdk_window_destroy:
 | |
|  * @window: a #GdkWindow
 | |
|  * @foreign_destroy: If TRUE, the window or a parent was destroyed by some
 | |
|  *            external agency. The window has already been destroyed and no
 | |
|  *            windowing system calls should be made. (This may never happen
 | |
|  *            for some windowing systems.)
 | |
|  *
 | |
|  * Internal function to destroy a window. Like gdk_window_destroy(),
 | |
|  * but does not drop the reference count created by gdk_window_new().
 | |
|  **/
 | |
| void
 | |
| _gdk_window_destroy (GdkWindow *window,
 | |
| 		     gboolean   foreign_destroy)
 | |
| {
 | |
|   _gdk_window_destroy_hierarchy (window, FALSE, foreign_destroy);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_destroy:
 | |
|  * @window: a #GdkWindow
 | |
|  *
 | |
|  * Destroys the window system resources associated with @window and decrements @window's
 | |
|  * reference count. The window system resources for all children of @window are also
 | |
|  * destroyed, but the children's reference counts are not decremented.
 | |
|  *
 | |
|  * Note that a window will not be destroyed automatically when its reference count
 | |
|  * reaches zero. You must call this function yourself before that happens.
 | |
|  *
 | |
|  **/
 | |
| void
 | |
| gdk_window_destroy (GdkWindow *window)
 | |
| {
 | |
|   _gdk_window_destroy_hierarchy (window, FALSE, FALSE);
 | |
|   g_object_unref (window);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_set_user_data:
 | |
|  * @window: a #GdkWindow
 | |
|  * @user_data: user data
 | |
|  *
 | |
|  * For most purposes this function is deprecated in favor of
 | |
|  * g_object_set_data(). However, for historical reasons GTK+ stores
 | |
|  * the #GtkWidget that owns a #GdkWindow as user data on the
 | |
|  * #GdkWindow. So, custom widget implementations should use
 | |
|  * this function for that. If GTK+ receives an event for a #GdkWindow,
 | |
|  * and the user data for the window is non-%NULL, GTK+ will assume the
 | |
|  * user data is a #GtkWidget, and forward the event to that widget.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_set_user_data (GdkWindow *window,
 | |
| 			  gpointer   user_data)
 | |
| {
 | |
|   g_return_if_fail (window != NULL);
 | |
|   
 | |
|   ((GdkWindowObject*)window)->user_data = user_data;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_user_data:
 | |
|  * @window: a #GdkWindow
 | |
|  * @data: return location for user data
 | |
|  *
 | |
|  * Retrieves the user data for @window, which is normally the widget
 | |
|  * that @window belongs to. See gdk_window_set_user_data().
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_get_user_data (GdkWindow *window,
 | |
| 			  gpointer  *data)
 | |
| {
 | |
|   g_return_if_fail (window != NULL);
 | |
|   
 | |
|   *data = ((GdkWindowObject*)window)->user_data;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_window_type:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Gets the type of the window. See #GdkWindowType.
 | |
|  * 
 | |
|  * Return value: type of window
 | |
|  **/
 | |
| GdkWindowType
 | |
| gdk_window_get_window_type (GdkWindow *window)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), (GdkWindowType) -1);
 | |
|   
 | |
|   return GDK_WINDOW_TYPE (window);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_position:
 | |
|  * @window: a #GdkWindow
 | |
|  * @x: X coordinate of window
 | |
|  * @y: Y coordinate of window
 | |
|  *
 | |
|  * Obtains the position of the window as reported in the
 | |
|  * most-recently-processed #GdkEventConfigure. Contrast with
 | |
|  * gdk_window_get_geometry() which queries the X server for the
 | |
|  * current window position, regardless of which events have been
 | |
|  * received or processed.
 | |
|  *
 | |
|  * The position coordinates are relative to the window's parent window.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_get_position (GdkWindow *window,
 | |
| 			 gint      *x,
 | |
| 			 gint      *y)
 | |
| {
 | |
|   GdkWindowObject *obj;
 | |
|   
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
|   
 | |
|   obj = (GdkWindowObject*) window;
 | |
|   
 | |
|   if (x)
 | |
|     *x = obj->x;
 | |
|   if (y)
 | |
|     *y = obj->y;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_parent:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Obtains the parent of @window, as known to GDK. Does not query the
 | |
|  * X server; thus this returns the parent as passed to gdk_window_new(),
 | |
|  * not the actual parent. This should never matter unless you're using
 | |
|  * Xlib calls mixed with GDK calls on the X11 platform. It may also
 | |
|  * matter for toplevel windows, because the window manager may choose
 | |
|  * to reparent them.
 | |
|  * 
 | |
|  * Return value: parent of @window
 | |
|  **/
 | |
| GdkWindow*
 | |
| gdk_window_get_parent (GdkWindow *window)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), NULL);
 | |
|   
 | |
|   return (GdkWindow*) ((GdkWindowObject*) window)->parent;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_toplevel:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Gets the toplevel window that's an ancestor of @window.
 | |
|  * 
 | |
|  * Return value: the toplevel window containing @window
 | |
|  **/
 | |
| GdkWindow*
 | |
| gdk_window_get_toplevel (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *obj;
 | |
|   
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), NULL);
 | |
| 
 | |
|   obj = (GdkWindowObject *)window;
 | |
|   while (GDK_WINDOW_TYPE (obj) == GDK_WINDOW_CHILD)
 | |
|     obj = (GdkWindowObject *)obj->parent;
 | |
|   
 | |
|   return GDK_WINDOW (obj);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_children:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Gets the list of children of @window known to GDK.
 | |
|  * This function only returns children created via GDK,
 | |
|  * so for example it's useless when used with the root window;
 | |
|  * it only returns windows an application created itself.
 | |
|  *
 | |
|  * The returned list must be freed, but the elements in the
 | |
|  * list need not be.
 | |
|  * 
 | |
|  * Return value: list of child windows inside @window
 | |
|  **/
 | |
| GList*
 | |
| gdk_window_get_children (GdkWindow *window)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), NULL);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (window))
 | |
|     return NULL;
 | |
| 
 | |
|   return g_list_copy (GDK_WINDOW_OBJECT (window)->children);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_peek_children:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Like gdk_window_get_children(), but does not copy the list of
 | |
|  * children, so the list does not need to be freed.
 | |
|  * 
 | |
|  * Return value: a reference to the list of child windows in @window
 | |
|  **/
 | |
| GList *
 | |
| gdk_window_peek_children (GdkWindow *window)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), NULL);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (window))
 | |
|     return NULL;
 | |
| 
 | |
|   return GDK_WINDOW_OBJECT (window)->children;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_add_filter:
 | |
|  * @window: a #GdkWindow
 | |
|  * @function: filter callback
 | |
|  * @data: data to pass to filter callback
 | |
|  *
 | |
|  * Adds an event filter to @window, allowing you to intercept events
 | |
|  * before they reach GDK. This is a low-level operation and makes it
 | |
|  * easy to break GDK and/or GTK+, so you have to know what you're
 | |
|  * doing. Pass %NULL for @window to get all events for all windows,
 | |
|  * instead of events for a specific window.
 | |
|  * 
 | |
|  **/
 | |
| void          
 | |
| gdk_window_add_filter (GdkWindow     *window,
 | |
| 		       GdkFilterFunc  function,
 | |
| 		       gpointer       data)
 | |
| {
 | |
|   GdkWindowObject *private;
 | |
|   GList *tmp_list;
 | |
|   GdkEventFilter *filter;
 | |
|   
 | |
|   g_return_if_fail (window == NULL || GDK_IS_WINDOW (window));
 | |
| 
 | |
|   private = (GdkWindowObject*) window;
 | |
|   if (private && GDK_WINDOW_DESTROYED (window))
 | |
|     return;
 | |
|   
 | |
|   if (private)
 | |
|     tmp_list = private->filters;
 | |
|   else
 | |
|     tmp_list = _gdk_default_filters;
 | |
|   
 | |
|   while (tmp_list)
 | |
|     {
 | |
|       filter = (GdkEventFilter *)tmp_list->data;
 | |
|       if ((filter->function == function) && (filter->data == data))
 | |
| 	return;
 | |
|       tmp_list = tmp_list->next;
 | |
|     }
 | |
|   
 | |
|   filter = g_new (GdkEventFilter, 1);
 | |
|   filter->function = function;
 | |
|   filter->data = data;
 | |
|   
 | |
|   if (private)
 | |
|     private->filters = g_list_append (private->filters, filter);
 | |
|   else
 | |
|     _gdk_default_filters = g_list_append (_gdk_default_filters, filter);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_remove_filter:
 | |
|  * @window: a #GdkWindow
 | |
|  * @function: previously-added filter function
 | |
|  * @data: user data for previously-added filter function
 | |
|  *
 | |
|  * Remove a filter previously added with gdk_window_add_filter().
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_remove_filter (GdkWindow     *window,
 | |
| 			  GdkFilterFunc  function,
 | |
| 			  gpointer       data)
 | |
| {
 | |
|   GdkWindowObject *private;
 | |
|   GList *tmp_list, *node;
 | |
|   GdkEventFilter *filter;
 | |
|   
 | |
|   g_return_if_fail (window == NULL || GDK_IS_WINDOW (window));
 | |
| 
 | |
|   private = (GdkWindowObject*) window;
 | |
|   
 | |
|   if (private)
 | |
|     tmp_list = private->filters;
 | |
|   else
 | |
|     tmp_list = _gdk_default_filters;
 | |
|   
 | |
|   while (tmp_list)
 | |
|     {
 | |
|       filter = (GdkEventFilter *)tmp_list->data;
 | |
|       node = tmp_list;
 | |
|       tmp_list = tmp_list->next;
 | |
|       
 | |
|       if ((filter->function == function) && (filter->data == data))
 | |
| 	{
 | |
| 	  if (private)
 | |
| 	    private->filters = g_list_remove_link (private->filters, node);
 | |
| 	  else
 | |
| 	    _gdk_default_filters = g_list_remove_link (_gdk_default_filters, node);
 | |
| 	  g_list_free_1 (node);
 | |
| 	  g_free (filter);
 | |
| 	  
 | |
| 	  return;
 | |
| 	}
 | |
|     }
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_screen_get_toplevel_windows:
 | |
|  * @screen: The #GdkScreen where the toplevels are located.
 | |
|  * 
 | |
|  * Obtains a list of all toplevel windows known to GDK on the screen @screen.
 | |
|  * A toplevel window is a child of the root window (see
 | |
|  * gdk_get_default_root_window()).
 | |
|  *
 | |
|  * The returned list should be freed with g_list_free(), but
 | |
|  * its elements need not be freed.
 | |
|  * 
 | |
|  * Return value: list of toplevel windows, free with g_list_free()
 | |
|  *
 | |
|  * Since: 2.2
 | |
|  **/
 | |
| GList *
 | |
| gdk_screen_get_toplevel_windows (GdkScreen *screen)
 | |
| {
 | |
|   GdkWindow * root_window;
 | |
|   GList *new_list = NULL;
 | |
|   GList *tmp_list;
 | |
|   
 | |
|   g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
 | |
|   
 | |
|   root_window = gdk_screen_get_root_window (screen);
 | |
| 
 | |
|   tmp_list = ((GdkWindowObject *)root_window)->children;
 | |
|   while (tmp_list)
 | |
|     {
 | |
|       if (GDK_WINDOW_TYPE (tmp_list->data) != GDK_WINDOW_FOREIGN)
 | |
| 	new_list = g_list_prepend (new_list, tmp_list->data);
 | |
|       tmp_list = tmp_list->next;
 | |
|     }
 | |
|   
 | |
|   return new_list;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_toplevels:
 | |
|  * 
 | |
|  * Obtains a list of all toplevel windows known to GDK on the default
 | |
|  * screen (see gdk_window_get_toplevels_for_screen()).
 | |
|  * A toplevel window is a child of the root window (see
 | |
|  * gdk_get_default_root_window()).
 | |
|  *
 | |
|  * The returned list should be freed with g_list_free(), but
 | |
|  * its elements need not be freed.
 | |
|  * 
 | |
|  * Return value: list of toplevel windows, free with g_list_free()
 | |
|  **/
 | |
| GList *
 | |
| gdk_window_get_toplevels (void)
 | |
| {
 | |
|   return gdk_screen_get_toplevel_windows (gdk_screen_get_default ());
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_is_visible:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Checks whether the window has been mapped (with gdk_window_show() or
 | |
|  * gdk_window_show_unraised()).
 | |
|  * 
 | |
|  * Return value: %TRUE if the window is mapped
 | |
|  **/
 | |
| gboolean 
 | |
| gdk_window_is_visible (GdkWindow *window)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), FALSE);
 | |
|   
 | |
|   return GDK_WINDOW_IS_MAPPED (window);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_is_viewable:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Check if the window and all ancestors of the window are
 | |
|  * mapped. (This is not necessarily "viewable" in the X sense, since
 | |
|  * we only check as far as we have GDK window parents, not to the root
 | |
|  * window.)
 | |
|  *
 | |
|  * Return value: %TRUE if the window is viewable
 | |
|  **/
 | |
| gboolean 
 | |
| gdk_window_is_viewable (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   GdkScreen *screen;
 | |
|   GdkWindow *root_window;
 | |
|   
 | |
|   g_return_val_if_fail (window != NULL, FALSE);
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), FALSE);
 | |
| 
 | |
|   screen = gdk_drawable_get_screen (window);
 | |
|   root_window = gdk_screen_get_root_window (screen);
 | |
|   
 | |
|   while (private && 
 | |
| 	 (private != (GdkWindowObject *)root_window) &&
 | |
| 	 (GDK_WINDOW_TYPE (private) != GDK_WINDOW_FOREIGN))
 | |
|     {
 | |
|       if (GDK_WINDOW_DESTROYED (private) || !GDK_WINDOW_IS_MAPPED (private))
 | |
| 	return FALSE;
 | |
|       
 | |
|       private = (GdkWindowObject *)private->parent;
 | |
|     }
 | |
|   
 | |
|   return TRUE;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_state:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Gets the bitwise OR of the currently active window state flags,
 | |
|  * from the #GdkWindowState enumeration.
 | |
|  * 
 | |
|  * Return value: window state bitfield
 | |
|  **/
 | |
| GdkWindowState
 | |
| gdk_window_get_state (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), FALSE);
 | |
|   
 | |
|   return private->state;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_begin_paint_rect:
 | |
|  * @window: a #GdkWindow
 | |
|  * @rectangle: rectangle you intend to draw to
 | |
|  *
 | |
|  * A convenience wrapper around gdk_window_begin_paint_region() which
 | |
|  * creates a rectangular region for you. See
 | |
|  * gdk_window_begin_paint_region() for details.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_begin_paint_rect (GdkWindow    *window,
 | |
| 			     GdkRectangle *rectangle)
 | |
| {
 | |
|   GdkRegion *region;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   region = gdk_region_rectangle (rectangle);
 | |
|   gdk_window_begin_paint_region (window, region);
 | |
|   gdk_region_destroy (region);
 | |
| }
 | |
| 
 | |
| #ifdef GDK_WINDOWING_X11
 | |
| #include "x11/gdkx.h"
 | |
| #endif
 | |
| 
 | |
| /**
 | |
|  * gdk_window_begin_paint_region:
 | |
|  * @window: a #GdkWindow
 | |
|  * @region: region you intend to draw to
 | |
|  *
 | |
|  * Indicates that you are beginning the process of redrawing @region.
 | |
|  * A backing store (offscreen buffer) large enough to contain @region
 | |
|  * will be created. The backing store will be initialized with the
 | |
|  * background color or background pixmap for @window. Then, all
 | |
|  * drawing operations performed on @window will be diverted to the
 | |
|  * backing store.  When you call gdk_window_end_paint(), the backing
 | |
|  * store will be copied to @window, making it visible onscreen. Only
 | |
|  * the part of @window contained in @region will be modified; that is,
 | |
|  * drawing operations are clipped to @region.
 | |
|  *
 | |
|  * The net result of all this is to remove flicker, because the user
 | |
|  * sees the finished product appear all at once when you call
 | |
|  * gdk_window_end_paint(). If you draw to @window directly without
 | |
|  * calling gdk_window_begin_paint_region(), the user may see flicker
 | |
|  * as individual drawing operations are performed in sequence.  The
 | |
|  * clipping and background-initializing features of
 | |
|  * gdk_window_begin_paint_region() are conveniences for the
 | |
|  * programmer, so you can avoid doing that work yourself.
 | |
|  *
 | |
|  * When using GTK+, the widget system automatically places calls to
 | |
|  * gdk_window_begin_paint_region() and gdk_window_end_paint() around
 | |
|  * emissions of the expose_event signal. That is, if you're writing an
 | |
|  * expose event handler, you can assume that the exposed area in
 | |
|  * #GdkEventExpose has already been cleared to the window background,
 | |
|  * is already set as the clip region, and already has a backing store.
 | |
|  * Therefore in most cases, application code need not call
 | |
|  * gdk_window_begin_paint_region(). (You can disable the automatic
 | |
|  * calls around expose events on a widget-by-widget basis by calling
 | |
|  * gtk_widget_set_double_buffered().)
 | |
|  *
 | |
|  * If you call this function multiple times before calling the
 | |
|  * matching gdk_window_end_paint(), the backing stores are pushed onto
 | |
|  * a stack. gdk_window_end_paint() copies the topmost backing store
 | |
|  * onscreen, subtracts the topmost region from all other regions in
 | |
|  * the stack, and pops the stack. All drawing operations affect only
 | |
|  * the topmost backing store in the stack. One matching call to
 | |
|  * gdk_window_end_paint() is required for each call to
 | |
|  * gdk_window_begin_paint_region().
 | |
|  * 
 | |
|  **/
 | |
| void	      
 | |
| gdk_window_begin_paint_region (GdkWindow *window,
 | |
| 			       GdkRegion *region)
 | |
| {
 | |
| #ifdef USE_BACKING_STORE
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   GdkRectangle clip_box;
 | |
|   GdkWindowPaint *paint;
 | |
|   GSList *list;
 | |
|   
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (window))
 | |
|     return;
 | |
| 
 | |
|   gdk_region_get_clipbox (region, &clip_box);
 | |
| 
 | |
|   paint = g_new (GdkWindowPaint, 1);
 | |
|   paint->region = gdk_region_copy (region);
 | |
|   paint->x_offset = clip_box.x;
 | |
|   paint->y_offset = clip_box.y;
 | |
|   paint->pixmap =
 | |
|     gdk_pixmap_new (window,
 | |
| 		    MAX (clip_box.width, 1), MAX (clip_box.height, 1), -1);
 | |
| 
 | |
|   for (list = private->paint_stack; list != NULL; list = list->next)
 | |
|     {
 | |
|       GdkWindowPaint *tmp_paint = list->data;
 | |
| 
 | |
|       gdk_region_subtract (tmp_paint->region, paint->region);
 | |
|     }
 | |
|   
 | |
|   private->paint_stack = g_slist_prepend (private->paint_stack, paint);
 | |
| 
 | |
|   if (!gdk_region_empty (region))
 | |
|     {
 | |
|       gdk_window_clear_backing_rect (window,
 | |
| 				     clip_box.x, clip_box.y,
 | |
| 				     clip_box.width, clip_box.height);
 | |
|     }
 | |
| #endif /* USE_BACKING_STORE */
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_end_paint:
 | |
|  * @window: a #GdkWindow
 | |
|  *
 | |
|  * Indicates that the backing store created by the most recent call to
 | |
|  * gdk_window_begin_paint_region() should be copied onscreen and
 | |
|  * deleted, leaving the next-most-recent backing store or no backing
 | |
|  * store at all as the active paint region. See
 | |
|  * gdk_window_begin_paint_region() for full details. It is an error to
 | |
|  * call this function without a matching
 | |
|  * gdk_window_begin_paint_region() first.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_end_paint (GdkWindow *window)
 | |
| {
 | |
| #ifdef USE_BACKING_STORE
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   GdkWindowPaint *paint;
 | |
|   GdkGC *tmp_gc;
 | |
|   GdkRectangle clip_box;
 | |
|   gint x_offset, y_offset;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (window))
 | |
|     return;
 | |
| 
 | |
|   if (private->paint_stack == NULL)
 | |
|     {
 | |
|       g_warning (G_STRLOC": no preceding call to gdk_window_begin_paint_region(), see documentation");
 | |
|       return;
 | |
|     }
 | |
| 
 | |
|   paint = private->paint_stack->data;
 | |
|   private->paint_stack = g_slist_delete_link (private->paint_stack, 
 | |
|                                               private->paint_stack);
 | |
| 
 | |
|   gdk_region_get_clipbox (paint->region, &clip_box);
 | |
| 
 | |
|   tmp_gc = _gdk_drawable_get_scratch_gc (window, FALSE);
 | |
| 
 | |
|   _gdk_windowing_window_get_offsets (window, &x_offset, &y_offset);
 | |
| 
 | |
|   gdk_gc_set_clip_region (tmp_gc, paint->region);
 | |
|   gdk_gc_set_clip_origin (tmp_gc, - x_offset, - y_offset);
 | |
| 
 | |
|   gdk_draw_drawable (private->impl, tmp_gc, paint->pixmap,
 | |
|                      clip_box.x - paint->x_offset,
 | |
|                      clip_box.y - paint->y_offset,
 | |
|                      clip_box.x - x_offset, clip_box.y - y_offset,
 | |
|                      clip_box.width, clip_box.height);
 | |
| 
 | |
|   /* Reset clip region of the cached GdkGC */
 | |
|   gdk_gc_set_clip_region (tmp_gc, NULL);
 | |
|   
 | |
|   g_object_unref (paint->pixmap);
 | |
|   gdk_region_destroy (paint->region);
 | |
|   g_free (paint);
 | |
| #endif /* USE_BACKING_STORE */
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_free_paint_stack (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GSList *tmp_list = private->paint_stack;
 | |
| 
 | |
|       while (tmp_list)
 | |
| 	{
 | |
| 	  GdkWindowPaint *paint = tmp_list->data;
 | |
| 
 | |
| 	  if (tmp_list == private->paint_stack)
 | |
| 	    g_object_unref (paint->pixmap);
 | |
| 		  
 | |
| 	  gdk_region_destroy (paint->region);
 | |
| 	  g_free (paint);
 | |
| 
 | |
| 	  tmp_list = tmp_list->next;
 | |
| 	}
 | |
| 
 | |
|       g_slist_free (private->paint_stack);
 | |
|       private->paint_stack = NULL;
 | |
|     }
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_get_offsets (GdkWindow *window,
 | |
| 			gint      *x_offset,
 | |
| 			gint      *y_offset)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       *x_offset = paint->x_offset;
 | |
|       *y_offset = paint->y_offset;
 | |
|     }
 | |
|   else
 | |
|     _gdk_windowing_window_get_offsets (window, x_offset, y_offset);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_internal_paint_info:
 | |
|  * @window: a #GdkWindow
 | |
|  * @real_drawable: location to store the drawable to which drawing should be 
 | |
|  *            done.
 | |
|  * @x_offset: location to store the X offset between coordinates in @window,
 | |
|  *            and the underlying window system primitive coordinates for 
 | |
|  *            *@real_drawable.
 | |
|  * @y_offset: location to store the Y offset between coordinates in @window,
 | |
|  *            and the underlying window system primitive coordinates for
 | |
|  *            *@real_drawable.
 | |
|  * 
 | |
|  * If you bypass the GDK layer and use windowing system primitives to
 | |
|  * draw directly onto a #GdkWindow, then you need to deal with two
 | |
|  * details: there may be an offset between GDK coordinates and windowing
 | |
|  * system coordinates, and GDK may have redirected drawing to a offscreen
 | |
|  * pixmap as the result of a gdk_window_begin_paint_region() calls.
 | |
|  * This function allows retrieving the information you need to compensate
 | |
|  * for these effects.
 | |
|  *
 | |
|  * This function exposes details of the GDK implementation, and is thus
 | |
|  * likely to change in future releases of GDK.
 | |
|  **/
 | |
| void
 | |
| gdk_window_get_internal_paint_info (GdkWindow    *window,
 | |
| 				    GdkDrawable **real_drawable,
 | |
| 				    gint         *x_offset,
 | |
| 				    gint         *y_offset)
 | |
| {
 | |
|   gint x_off, y_off;
 | |
|   
 | |
|   GdkWindowObject *private;
 | |
| 
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   private = (GdkWindowObject *)window;
 | |
| 
 | |
|   if (real_drawable)
 | |
|     {
 | |
|       if (private->paint_stack)
 | |
| 	{
 | |
| 	  GdkWindowPaint *paint = private->paint_stack->data;
 | |
| 	  *real_drawable = paint->pixmap;
 | |
| 	}
 | |
|       else
 | |
| 	*real_drawable = window;
 | |
|     }
 | |
| 
 | |
|   gdk_window_get_offsets (window, &x_off, &y_off);
 | |
| 
 | |
|   if (x_offset)
 | |
|     *x_offset = x_off;
 | |
|   if (y_offset)
 | |
|     *y_offset = y_off;
 | |
| }
 | |
| 
 | |
| #define OFFSET_GC(gc)                                         \
 | |
|     gint x_offset, y_offset; 				      \
 | |
|     gint old_clip_x = gc->clip_x_origin;    \
 | |
|     gint old_clip_y = gc->clip_y_origin;    \
 | |
|     gint old_ts_x = gc->ts_x_origin;        \
 | |
|     gint old_ts_y = gc->ts_y_origin;        \
 | |
|     gdk_window_get_offsets (drawable, &x_offset, &y_offset);  \
 | |
|     if (x_offset != 0 || y_offset != 0)             	      \
 | |
|       {                                                       \
 | |
|         gdk_gc_set_clip_origin (gc, old_clip_x - x_offset,    \
 | |
| 	  	                old_clip_y - y_offset);       \
 | |
|         gdk_gc_set_ts_origin (gc, old_ts_x - x_offset,        \
 | |
| 	  	              old_ts_y - y_offset);           \
 | |
|       }
 | |
| 
 | |
| #define RESTORE_GC(gc)                                      \
 | |
|     if (x_offset != 0 || y_offset != 0)       		    \
 | |
|      {                                                      \
 | |
|        gdk_gc_set_clip_origin (gc, old_clip_x, old_clip_y); \
 | |
|        gdk_gc_set_ts_origin (gc, old_ts_x, old_ts_y);       \
 | |
|      }
 | |
| 
 | |
| static GdkGC *
 | |
| gdk_window_create_gc (GdkDrawable     *drawable,
 | |
|                       GdkGCValues     *values,
 | |
|                       GdkGCValuesMask  mask)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (drawable), NULL);
 | |
|   
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return NULL;
 | |
| 
 | |
|   return gdk_gc_new_with_values (((GdkWindowObject *) drawable)->impl,
 | |
|                                  values, mask);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_rectangle (GdkDrawable *drawable,
 | |
| 			   GdkGC       *gc,
 | |
| 			   gboolean     filled,
 | |
| 			   gint         x,
 | |
| 			   gint         y,
 | |
| 			   gint         width,
 | |
| 			   gint         height)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_rectangle (paint->pixmap, gc, filled,
 | |
| 			  x - x_offset, y - y_offset, width, height);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_rectangle (private->impl, gc, filled,
 | |
|                         x - x_offset, y - y_offset, width, height);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_arc (GdkDrawable *drawable,
 | |
| 		     GdkGC       *gc,
 | |
| 		     gboolean     filled,
 | |
| 		     gint         x,
 | |
| 		     gint         y,
 | |
| 		     gint         width,
 | |
| 		     gint         height,
 | |
| 		     gint         angle1,
 | |
| 		     gint         angle2)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_arc (paint->pixmap, gc, filled,
 | |
| 		    x - x_offset, y - y_offset,
 | |
| 		    width, height, angle1, angle2);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_arc (private->impl, gc, filled,
 | |
|                   x - x_offset, y - y_offset,
 | |
|                   width, height, angle1, angle2);
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_polygon (GdkDrawable *drawable,
 | |
| 			 GdkGC       *gc,
 | |
| 			 gboolean     filled,
 | |
| 			 GdkPoint    *points,
 | |
| 			 gint         npoints)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   GdkPoint *new_points;
 | |
|   
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (x_offset != 0 || y_offset != 0)
 | |
|     {
 | |
|       int i;
 | |
|       
 | |
|       new_points = g_new (GdkPoint, npoints);
 | |
|       for (i=0; i<npoints; i++)
 | |
| 	{
 | |
| 	  new_points[i].x = points[i].x - x_offset;
 | |
| 	  new_points[i].y = points[i].y - y_offset;
 | |
| 	}
 | |
|     }
 | |
|   else
 | |
|     new_points = points;
 | |
| 
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_polygon (paint->pixmap, gc, filled, new_points, npoints);
 | |
| 
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_polygon (private->impl, gc, filled, new_points, npoints);
 | |
|   
 | |
|   if (new_points != points)
 | |
|     g_free (new_points);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_text (GdkDrawable *drawable,
 | |
| 		      GdkFont     *font,
 | |
| 		      GdkGC       *gc,
 | |
| 		      gint         x,
 | |
| 		      gint         y,
 | |
| 		      const gchar *text,
 | |
| 		      gint         text_length)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_text (paint->pixmap, font, gc, 
 | |
| 		     x - x_offset, y - y_offset, text, text_length);
 | |
| 
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_text (private->impl, font, gc,
 | |
|                    x - x_offset, y - y_offset, text, text_length);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_text_wc (GdkDrawable    *drawable,
 | |
| 			 GdkFont        *font,
 | |
| 			 GdkGC          *gc,
 | |
| 			 gint            x,
 | |
| 			 gint            y,
 | |
| 			 const GdkWChar *text,
 | |
| 			 gint            text_length)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_text_wc (paint->pixmap, font, gc, 
 | |
| 			x - x_offset, y - y_offset, text, text_length);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_text_wc (private->impl, font, gc,
 | |
|                       x - x_offset, y - y_offset, text, text_length);
 | |
|   
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static GdkDrawable*
 | |
| gdk_window_get_composite_drawable (GdkDrawable *drawable,
 | |
|                                    gint         x,
 | |
|                                    gint         y,
 | |
|                                    gint         width,
 | |
|                                    gint         height,
 | |
|                                    gint        *composite_x_offset,
 | |
|                                    gint        *composite_y_offset)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   GSList *list;
 | |
|   GdkPixmap *tmp_pixmap;
 | |
|   GdkRectangle rect;
 | |
|   GdkGC *tmp_gc;
 | |
|   gboolean overlap_buffer;
 | |
| 
 | |
|   _gdk_windowing_window_get_offsets (drawable,
 | |
| 				     composite_x_offset,
 | |
| 				     composite_y_offset);
 | |
|   
 | |
|   if ((GDK_IS_WINDOW (drawable) && GDK_WINDOW_DESTROYED (drawable))
 | |
|       || private->paint_stack == NULL)
 | |
|     {
 | |
|       /* No backing store */
 | |
|       return g_object_ref (drawable);
 | |
|     }
 | |
| 
 | |
|   /* See if the buffered part is overlapping the part we want
 | |
|    * to get
 | |
|    */
 | |
|   rect.x = x;
 | |
|   rect.y = y;
 | |
|   rect.width = width;
 | |
|   rect.height = height;
 | |
| 
 | |
|   overlap_buffer = FALSE;
 | |
|   
 | |
|   for (list = private->paint_stack; list != NULL; list = list->next)
 | |
|     {
 | |
|       GdkWindowPaint *paint = list->data;
 | |
|       GdkOverlapType overlap;
 | |
| 
 | |
|       overlap = gdk_region_rect_in (paint->region, &rect);
 | |
| 
 | |
|       if (overlap == GDK_OVERLAP_RECTANGLE_IN)
 | |
| 	{
 | |
| 	  *composite_x_offset = paint->x_offset;
 | |
| 	  *composite_y_offset = paint->y_offset;
 | |
| 	  
 | |
| 	  return g_object_ref (paint->pixmap);
 | |
| 	}
 | |
|       else if (overlap == GDK_OVERLAP_RECTANGLE_PART)
 | |
| 	{
 | |
| 	  overlap_buffer = TRUE;
 | |
| 	  break;
 | |
| 	}
 | |
|     }
 | |
| 
 | |
|   if (!overlap_buffer)
 | |
|     return g_object_ref (drawable);
 | |
| 
 | |
|   tmp_pixmap = gdk_pixmap_new (drawable, width, height, -1);
 | |
|   tmp_gc = _gdk_drawable_get_scratch_gc (tmp_pixmap, FALSE);
 | |
| 
 | |
|   /* Copy the current window contents */
 | |
|   gdk_draw_drawable (tmp_pixmap,
 | |
|                      tmp_gc,
 | |
|                      private->impl,
 | |
|                      x - *composite_x_offset,
 | |
|                      y - *composite_y_offset,
 | |
|                      0, 0,
 | |
|                      width, height);
 | |
| 
 | |
|   /* paint the backing stores */
 | |
|   for (list = private->paint_stack; list != NULL; list = list->next)
 | |
|     {
 | |
|       GdkWindowPaint *paint = list->data;
 | |
| 
 | |
|       gdk_gc_set_clip_region (tmp_gc, paint->region);
 | |
|       gdk_gc_set_clip_origin (tmp_gc, -x, -y);
 | |
|       
 | |
|       gdk_draw_drawable (tmp_pixmap, tmp_gc, paint->pixmap,
 | |
| 			 x - paint->x_offset,
 | |
| 			 y - paint->y_offset,
 | |
| 			 0, 0, width, height);
 | |
|     }
 | |
| 
 | |
|   /* Reset clip region of the cached GdkGC */
 | |
|   gdk_gc_set_clip_region (tmp_gc, NULL);
 | |
| 
 | |
|   /* Set these to location of tmp_pixmap within the window */
 | |
|   *composite_x_offset = x;
 | |
|   *composite_y_offset = y;
 | |
| 
 | |
|   return tmp_pixmap;
 | |
| }
 | |
| 
 | |
| static GdkRegion*
 | |
| gdk_window_get_clip_region (GdkDrawable *drawable)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   GdkRegion *result;
 | |
| 
 | |
|   result = gdk_drawable_get_clip_region (private->impl);
 | |
| 
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkRegion *paint_region = gdk_region_new ();
 | |
|       GSList *tmp_list = private->paint_stack;
 | |
| 
 | |
|       while (tmp_list)
 | |
| 	{
 | |
| 	  GdkWindowPaint *paint = tmp_list->data;
 | |
| 	  
 | |
| 	  gdk_region_union (paint_region, paint->region);
 | |
| 
 | |
|           tmp_list = tmp_list->next;
 | |
| 	}
 | |
| 
 | |
|       gdk_region_intersect (result, paint_region);
 | |
|       gdk_region_destroy (paint_region);
 | |
|     }
 | |
| 
 | |
|   return result;
 | |
| }
 | |
| 
 | |
| static GdkRegion*
 | |
| gdk_window_get_visible_region (GdkDrawable *drawable)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject*) drawable;
 | |
|   
 | |
|   return gdk_drawable_get_visible_region (private->impl);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_drawable (GdkDrawable *drawable,
 | |
| 			  GdkGC       *gc,
 | |
| 			  GdkPixmap   *src,
 | |
| 			  gint         xsrc,
 | |
| 			  gint         ysrc,
 | |
| 			  gint         xdest,
 | |
| 			  gint         ydest,
 | |
| 			  gint         width,
 | |
| 			  gint         height)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   OFFSET_GC (gc);
 | |
|   
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
| 
 | |
|   /* If we have a backing pixmap draw to that */
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_drawable (paint->pixmap, gc,
 | |
|                          src, xsrc, ysrc,
 | |
| 			 xdest - x_offset, ydest - y_offset, width, height);
 | |
| 
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_drawable (private->impl, gc,
 | |
|                        src, xsrc, ysrc,
 | |
|                        xdest - x_offset, ydest - y_offset,
 | |
|                        width, height);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_points (GdkDrawable *drawable,
 | |
| 			GdkGC       *gc,
 | |
| 			GdkPoint    *points,
 | |
| 			gint         npoints)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   GdkPoint *new_points;
 | |
|   
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (x_offset != 0 || y_offset != 0)
 | |
|     {
 | |
|       gint i;
 | |
| 
 | |
|       new_points = g_new (GdkPoint, npoints);
 | |
|       for (i=0; i<npoints; i++)
 | |
| 	{
 | |
| 	  new_points[i].x = points[i].x - x_offset;
 | |
| 	  new_points[i].y = points[i].y - y_offset;
 | |
| 	}
 | |
|     }
 | |
|   else
 | |
|     new_points = points;
 | |
| 
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_points (paint->pixmap, gc, new_points, npoints);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_points (private->impl, gc, points, npoints);
 | |
| 
 | |
|   if (new_points != points)
 | |
|     g_free (new_points);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_segments (GdkDrawable *drawable,
 | |
| 			  GdkGC       *gc,
 | |
| 			  GdkSegment  *segs,
 | |
| 			  gint         nsegs)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   GdkSegment *new_segs;
 | |
| 
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (x_offset != 0 || y_offset != 0)
 | |
|     {
 | |
|       gint i;
 | |
| 
 | |
|       new_segs = g_new (GdkSegment, nsegs);
 | |
|       for (i=0; i<nsegs; i++)
 | |
| 	{
 | |
| 	  new_segs[i].x1 = segs[i].x1 - x_offset;
 | |
| 	  new_segs[i].y1 = segs[i].y1 - y_offset;
 | |
| 	  new_segs[i].x2 = segs[i].x2 - x_offset;
 | |
| 	  new_segs[i].y2 = segs[i].y2 - y_offset;
 | |
| 	}
 | |
|     }
 | |
|   else
 | |
|     new_segs = segs;
 | |
| 
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_segments (paint->pixmap, gc, new_segs, nsegs);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_segments (private->impl, gc, new_segs, nsegs);
 | |
|   
 | |
|   if (new_segs != segs)
 | |
|     g_free (new_segs);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_lines (GdkDrawable *drawable,
 | |
| 		       GdkGC       *gc,
 | |
| 		       GdkPoint    *points,
 | |
| 		       gint         npoints)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   GdkPoint *new_points;
 | |
| 
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (x_offset != 0 || y_offset != 0)
 | |
|     {
 | |
|       gint i;
 | |
| 
 | |
|       new_points = g_new (GdkPoint, npoints);
 | |
|       for (i=0; i<npoints; i++)
 | |
| 	{
 | |
| 	  new_points[i].x = points[i].x - x_offset;
 | |
| 	  new_points[i].y = points[i].y - y_offset;
 | |
| 	}
 | |
|     }
 | |
|   else
 | |
|     new_points = points;
 | |
| 
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_lines (paint->pixmap, gc, new_points, npoints);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_lines (private->impl, gc, new_points, npoints);
 | |
| 
 | |
|   if (new_points != points)
 | |
|     g_free (new_points);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_glyphs (GdkDrawable      *drawable,
 | |
| 			GdkGC            *gc,
 | |
| 			PangoFont        *font,
 | |
| 			gint              x,
 | |
| 			gint              y,
 | |
| 			PangoGlyphString *glyphs)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
| 
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
| 
 | |
|       gdk_draw_glyphs (paint->pixmap, gc, font, x - x_offset, y - y_offset, glyphs);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_glyphs (private->impl, gc, font,
 | |
|                      x - x_offset, y - y_offset, glyphs);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_glyphs_transformed (GdkDrawable      *drawable,
 | |
| 				    GdkGC            *gc,
 | |
| 				    PangoMatrix      *matrix,
 | |
| 				    PangoFont        *font,
 | |
| 				    gint              x,
 | |
| 				    gint              y,
 | |
| 				    PangoGlyphString *glyphs)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   PangoMatrix tmp_matrix;
 | |
| 
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
| 
 | |
|   if (x_offset != 0 || y_offset != 0)
 | |
|     {
 | |
|       if (matrix)
 | |
| 	{
 | |
| 	  tmp_matrix = *matrix;
 | |
| 	  tmp_matrix.x0 -= x_offset;
 | |
| 	  tmp_matrix.y0 -= y_offset;
 | |
| 	  matrix = &tmp_matrix;
 | |
| 	}
 | |
|       else
 | |
| 	{
 | |
| 	  x -= x_offset * PANGO_SCALE;
 | |
| 	  y -= y_offset * PANGO_SCALE;
 | |
| 	}
 | |
|     }
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
| 
 | |
|       gdk_draw_glyphs_transformed (paint->pixmap, gc, matrix, font, x, y, glyphs);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_glyphs_transformed (private->impl, gc, matrix, font, x, y, glyphs);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static GdkGC *
 | |
| gdk_window_get_bg_gc (GdkWindow      *window,
 | |
| 		      GdkWindowPaint *paint)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
| 
 | |
|   guint gc_mask = 0;
 | |
|   GdkGCValues gc_values;
 | |
| 
 | |
|   if (private->bg_pixmap == GDK_PARENT_RELATIVE_BG && private->parent)
 | |
|     {
 | |
|       GdkWindowPaint tmp_paint = *paint;
 | |
|       tmp_paint.x_offset += private->x;
 | |
|       tmp_paint.y_offset += private->y;
 | |
|       
 | |
|       return gdk_window_get_bg_gc (GDK_WINDOW (private->parent), &tmp_paint);
 | |
|     }
 | |
|   else if (private->bg_pixmap && 
 | |
|            private->bg_pixmap != GDK_PARENT_RELATIVE_BG && 
 | |
|            private->bg_pixmap != GDK_NO_BG)
 | |
|     {
 | |
|       gc_values.fill = GDK_TILED;
 | |
|       gc_values.tile = private->bg_pixmap;
 | |
|       
 | |
|       gc_mask = GDK_GC_FILL | GDK_GC_TILE;
 | |
| 
 | |
|       return gdk_gc_new_with_values (paint->pixmap, &gc_values, gc_mask);
 | |
|     }
 | |
|   else
 | |
|     {
 | |
|       GdkGC *gc = _gdk_drawable_get_scratch_gc (paint->pixmap, FALSE);
 | |
| 
 | |
|       gdk_gc_set_foreground (gc, &(private->bg_color));
 | |
| 
 | |
|       return g_object_ref (gc);
 | |
|     }
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_clear_backing_rect (GdkWindow *window,
 | |
| 			       gint       x,
 | |
| 			       gint       y,
 | |
| 			       gint       width,
 | |
| 			       gint       height)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   GdkWindowPaint *paint = private->paint_stack->data;
 | |
|   GdkGC *tmp_gc;
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (window))
 | |
|     return;
 | |
| 
 | |
|   tmp_gc = gdk_window_get_bg_gc (window, paint);
 | |
|   gdk_gc_set_clip_region (tmp_gc, paint->region);
 | |
|   
 | |
|   gdk_draw_rectangle (window, tmp_gc, TRUE,
 | |
| 		      x, y, width, height);
 | |
| 
 | |
|   gdk_gc_set_clip_region (tmp_gc, NULL);
 | |
|   
 | |
|   g_object_unref (tmp_gc);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_clear:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Clears an entire @window to the background color or background pixmap.
 | |
|  **/
 | |
| void
 | |
| gdk_window_clear (GdkWindow *window)
 | |
| {
 | |
|   gint width, height;
 | |
|   
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   gdk_drawable_get_size (GDK_DRAWABLE (window), &width, &height);
 | |
|   
 | |
|   gdk_window_clear_area (window, 0, 0,
 | |
|                          width, height);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_clear_area:
 | |
|  * @window: a #GdkWindow
 | |
|  * @x: x coordinate of rectangle to clear
 | |
|  * @y: y coordinate of rectangle to clear
 | |
|  * @width: width of rectangle to clear
 | |
|  * @height: height of rectangle to clear
 | |
|  *
 | |
|  * Clears an area of @window to the background color or background pixmap.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_clear_area (GdkWindow *window,
 | |
| 		       gint       x,
 | |
| 		       gint       y,
 | |
| 		       gint       width,
 | |
| 		       gint       height)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     gdk_window_clear_backing_rect (window, x, y, width, height);
 | |
|   else
 | |
|     _gdk_windowing_window_clear_area (window, x, y, width, height);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_clear_area_e:
 | |
|  * @window: a #GdkWindow
 | |
|  * @x: x coordinate of rectangle to clear
 | |
|  * @y: y coordinate of rectangle to clear
 | |
|  * @width: width of rectangle to clear
 | |
|  * @height: height of rectangle to clear
 | |
|  *
 | |
|  * Like gdk_window_clear_area(), but also generates an expose event for
 | |
|  * the cleared area.
 | |
|  *
 | |
|  * This function has a stupid name because it dates back to the mists
 | |
|  * time, pre-GDK-1.0.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_clear_area_e (GdkWindow *window,
 | |
| 		         gint       x,
 | |
| 		         gint       y,
 | |
| 		         gint       width,
 | |
| 		         gint       height)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     gdk_window_clear_backing_rect (window, x, y, width, height);
 | |
| 
 | |
|   _gdk_windowing_window_clear_area_e (window, x, y, width, height);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_image (GdkDrawable *drawable,
 | |
|                        GdkGC       *gc,
 | |
|                        GdkImage    *image,
 | |
|                        gint         xsrc,
 | |
|                        gint         ysrc,
 | |
|                        gint         xdest,
 | |
|                        gint         ydest,
 | |
|                        gint         width,
 | |
|                        gint         height)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
| 
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_image (paint->pixmap, gc, image, xsrc, ysrc,
 | |
|                       xdest - x_offset, ydest - y_offset,
 | |
|                       width, height);
 | |
| 
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_image (private->impl, gc, image, xsrc, ysrc,
 | |
|                     xdest - x_offset, ydest - y_offset,
 | |
|                     width, height);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_pixbuf (GdkDrawable     *drawable,
 | |
| 			GdkGC           *gc,
 | |
| 			GdkPixbuf       *pixbuf,
 | |
| 			gint             src_x,
 | |
| 			gint             src_y,
 | |
| 			gint             dest_x,
 | |
| 			gint             dest_y,
 | |
| 			gint             width,
 | |
| 			gint             height,
 | |
| 			GdkRgbDither     dither,
 | |
| 			gint             x_dither,
 | |
| 			gint             y_dither)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (gc)
 | |
|     {
 | |
|       OFFSET_GC (gc);
 | |
|   
 | |
|       if (private->paint_stack)
 | |
| 	{
 | |
| 	  GdkWindowPaint *paint = private->paint_stack->data;
 | |
| 	  gdk_draw_pixbuf (paint->pixmap, gc, pixbuf, src_x, src_y,
 | |
| 			   dest_x - x_offset, dest_y - y_offset,
 | |
| 			   width, height,
 | |
| 			   dither, x_dither - x_offset, y_dither - y_offset);
 | |
| 	}
 | |
|       else
 | |
| 	gdk_draw_pixbuf (private->impl, gc, pixbuf, src_x, src_y,
 | |
| 			 dest_x - x_offset, dest_y - y_offset,
 | |
| 			 width, height,
 | |
| 			 dither, x_dither, y_dither);
 | |
|       
 | |
|       RESTORE_GC (gc);
 | |
|     }
 | |
|   else
 | |
|     {
 | |
|       gint x_offset, y_offset;
 | |
|       gdk_window_get_offsets (drawable, &x_offset, &y_offset);
 | |
|       
 | |
|       if (private->paint_stack)
 | |
| 	{
 | |
| 	  GdkWindowPaint *paint = private->paint_stack->data;
 | |
| 	  gdk_draw_pixbuf (paint->pixmap, gc, pixbuf, src_x, src_y,
 | |
| 			   dest_x - x_offset, dest_y - y_offset,
 | |
| 			   width, height,
 | |
| 			    dither, x_dither - x_offset, y_dither - y_offset);
 | |
| 	}
 | |
|       else
 | |
| 	gdk_draw_pixbuf (private->impl, gc, pixbuf, src_x, src_y,
 | |
| 			 dest_x - x_offset, dest_y - y_offset,
 | |
| 			 width, height,
 | |
| 			 dither, x_dither, y_dither);
 | |
|     }
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_draw_trapezoids (GdkDrawable   *drawable,
 | |
| 			    GdkGC	  *gc,
 | |
| 			    GdkTrapezoid  *trapezoids,
 | |
| 			    gint           n_trapezoids)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)drawable;
 | |
|   GdkTrapezoid *new_trapezoids = NULL;
 | |
| 
 | |
|   OFFSET_GC (gc);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   if (x_offset != 0 || y_offset != 0)
 | |
|     {
 | |
|       gint i;
 | |
| 
 | |
|       new_trapezoids = g_new (GdkTrapezoid, n_trapezoids);
 | |
|       for (i=0; i < n_trapezoids; i++)
 | |
| 	{
 | |
| 	  new_trapezoids[i].y1 = trapezoids[i].y1 - y_offset;
 | |
| 	  new_trapezoids[i].x11 = trapezoids[i].x11 - x_offset;
 | |
| 	  new_trapezoids[i].x21 = trapezoids[i].x21 - x_offset;
 | |
| 	  new_trapezoids[i].y2 = trapezoids[i].y2 - y_offset;
 | |
| 	  new_trapezoids[i].x12 = trapezoids[i].x12 - x_offset;
 | |
| 	  new_trapezoids[i].x22 = trapezoids[i].x22 - x_offset;
 | |
| 	}
 | |
| 
 | |
|       trapezoids = new_trapezoids;
 | |
|     }
 | |
| 
 | |
|   if (private->paint_stack)
 | |
|     {
 | |
|       GdkWindowPaint *paint = private->paint_stack->data;
 | |
|       gdk_draw_trapezoids (paint->pixmap, gc, trapezoids, n_trapezoids);
 | |
|     }
 | |
|   else
 | |
|     gdk_draw_trapezoids (private->impl, gc, trapezoids, n_trapezoids);
 | |
|   
 | |
|   if (new_trapezoids)
 | |
|     g_free (new_trapezoids);
 | |
| 
 | |
|   RESTORE_GC (gc);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_real_get_size (GdkDrawable *drawable,
 | |
|                           gint *width,
 | |
|                           gint *height)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_WINDOW (drawable));
 | |
| 
 | |
|   gdk_drawable_get_size (GDK_WINDOW_OBJECT (drawable)->impl,
 | |
|                          width, height);
 | |
| }
 | |
| 
 | |
| static GdkVisual*
 | |
| gdk_window_real_get_visual (GdkDrawable *drawable)
 | |
| {
 | |
|   GdkColormap *colormap;
 | |
| 
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (drawable), NULL);
 | |
| 
 | |
|   colormap = gdk_drawable_get_colormap (drawable);
 | |
|   return colormap ? gdk_colormap_get_visual (colormap) : NULL;
 | |
| }
 | |
| 
 | |
| static gint
 | |
| gdk_window_real_get_depth (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (drawable), 0);
 | |
| 
 | |
|   return ((GdkWindowObject *)GDK_WINDOW (drawable))->depth;
 | |
| }
 | |
| 
 | |
| static GdkScreen*
 | |
| gdk_window_real_get_screen (GdkDrawable *drawable)
 | |
| {
 | |
|   return gdk_drawable_get_screen (GDK_WINDOW_OBJECT (drawable)->impl);
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_real_set_colormap (GdkDrawable *drawable,
 | |
|                               GdkColormap *cmap)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_WINDOW (drawable));  
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return;
 | |
|   
 | |
|   gdk_drawable_set_colormap (((GdkWindowObject*)drawable)->impl, cmap);
 | |
| }
 | |
| 
 | |
| static GdkColormap*
 | |
| gdk_window_real_get_colormap (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (drawable), NULL);
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return NULL;
 | |
|   
 | |
|   return gdk_drawable_get_colormap (((GdkWindowObject*)drawable)->impl);
 | |
| }
 | |
|                       
 | |
| static GdkImage*
 | |
| gdk_window_copy_to_image (GdkDrawable     *drawable,
 | |
| 			  GdkImage        *image,
 | |
| 			  gint             src_x,
 | |
| 			  gint             src_y,
 | |
| 			  gint             dest_x,
 | |
| 			  gint             dest_y,
 | |
| 			  gint             width,
 | |
| 			  gint             height)
 | |
| {
 | |
|   gint x_offset, y_offset;
 | |
|   
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (drawable), NULL);
 | |
|   
 | |
|   if (GDK_WINDOW_DESTROYED (drawable))
 | |
|     return NULL;
 | |
| 
 | |
|   /* If we're here, a composite image was not necessary, so
 | |
|    * we can ignore the paint stack.
 | |
|    */
 | |
|   
 | |
|   _gdk_windowing_window_get_offsets (drawable, &x_offset, &y_offset);
 | |
|   
 | |
|   return gdk_drawable_copy_to_image (((GdkWindowObject*)drawable)->impl,
 | |
| 				     image,
 | |
| 				     src_x - x_offset,
 | |
| 				     src_y - y_offset,
 | |
| 				     dest_x, dest_y,
 | |
| 				     width, height);
 | |
| }
 | |
| 
 | |
| /* Code for dirty-region queueing
 | |
|  */
 | |
| static GSList *update_windows = NULL;
 | |
| static guint update_idle = 0;
 | |
| static gboolean debug_updates = FALSE;
 | |
| 
 | |
| static gboolean
 | |
| gdk_window_update_idle (gpointer data)
 | |
| {
 | |
|   GDK_THREADS_ENTER ();
 | |
|   gdk_window_process_all_updates ();
 | |
|   GDK_THREADS_LEAVE ();
 | |
|   
 | |
|   return FALSE;
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_schedule_update (GdkWindow *window)
 | |
| {
 | |
|   if (window && GDK_WINDOW_OBJECT (window)->update_freeze_count)
 | |
|     return;
 | |
| 
 | |
|   if (!update_idle)
 | |
|     {
 | |
|       update_idle = g_idle_add_full (GDK_PRIORITY_REDRAW,
 | |
| 				     gdk_window_update_idle, NULL, NULL);
 | |
|     }
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_window_process_updates_internal (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   gboolean save_region = FALSE;
 | |
| 
 | |
|   /* If an update got queued during update processing, we can get a
 | |
|    * window in the update queue that has an empty update_area.
 | |
|    * just ignore it.
 | |
|    */
 | |
|   if (private->update_area)
 | |
|     {
 | |
|       GdkRegion *update_area = private->update_area;
 | |
|       private->update_area = NULL;
 | |
|       
 | |
|       if (_gdk_event_func && gdk_window_is_viewable (window))
 | |
| 	{
 | |
| 	  GdkRectangle window_rect;
 | |
| 	  GdkRegion *expose_region;
 | |
| 	  GdkRegion *window_region;
 | |
|           gint width, height;
 | |
| 
 | |
|           if (debug_updates)
 | |
|             {
 | |
|               /* Make sure we see the red invalid area before redrawing. */
 | |
|               gdk_display_sync (gdk_drawable_get_display (window));
 | |
|               g_usleep (70000);
 | |
|             }
 | |
|           
 | |
| 	  save_region = _gdk_windowing_window_queue_antiexpose (window, update_area);
 | |
| 
 | |
| 	  if (save_region)
 | |
| 	    expose_region = gdk_region_copy (update_area);
 | |
| 	  else
 | |
| 	    expose_region = update_area;
 | |
| 	  
 | |
|           gdk_drawable_get_size (GDK_DRAWABLE (private), &width, &height);
 | |
| 
 | |
| 	  window_rect.x = 0;
 | |
| 	  window_rect.y = 0;
 | |
| 	  window_rect.width = width;
 | |
| 	  window_rect.height = height;
 | |
| 
 | |
| 	  window_region = gdk_region_rectangle (&window_rect);
 | |
| 	  gdk_region_intersect (expose_region,
 | |
| 				window_region);
 | |
| 	  gdk_region_destroy (window_region);
 | |
| 	  
 | |
| 	  if (!gdk_region_empty (expose_region) &&
 | |
| 	      (private->event_mask & GDK_EXPOSURE_MASK))
 | |
| 	    {
 | |
| 	      GdkEvent event;
 | |
| 	      
 | |
| 	      event.expose.type = GDK_EXPOSE;
 | |
| 	      event.expose.window = g_object_ref (window);
 | |
| 	      event.expose.count = 0;
 | |
| 	      event.expose.region = expose_region;
 | |
| 	      gdk_region_get_clipbox (expose_region, &event.expose.area);
 | |
| 	      
 | |
| 	      (*_gdk_event_func) (&event, _gdk_event_data);
 | |
| 	      
 | |
| 	      g_object_unref (window);
 | |
| 	    }
 | |
| 
 | |
| 	  if (expose_region != update_area)
 | |
| 	    gdk_region_destroy (expose_region);
 | |
| 	}
 | |
|       if (!save_region)
 | |
| 	gdk_region_destroy (update_area);
 | |
|     }
 | |
| }
 | |
| 
 | |
| static void
 | |
| flush_all_displays (void)
 | |
| {
 | |
|   GSList *displays = gdk_display_manager_list_displays (gdk_display_manager_get ());
 | |
|   GSList *tmp_list;
 | |
| 
 | |
|   for (tmp_list = displays; tmp_list; tmp_list = tmp_list->next)
 | |
|     gdk_display_flush (tmp_list->data);
 | |
| 
 | |
|   g_slist_free (displays);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_process_all_updates:
 | |
|  *
 | |
|  * Calls gdk_window_process_updates() for all windows (see #GdkWindow)
 | |
|  * in the application.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_process_all_updates (void)
 | |
| {
 | |
|   GSList *old_update_windows = update_windows;
 | |
|   GSList *tmp_list = update_windows;
 | |
| 
 | |
|   if (update_idle)
 | |
|     g_source_remove (update_idle);
 | |
|   
 | |
|   update_windows = NULL;
 | |
|   update_idle = 0;
 | |
| 
 | |
|   g_slist_foreach (old_update_windows, (GFunc)g_object_ref, NULL);
 | |
|   
 | |
|   while (tmp_list)
 | |
|     {
 | |
|       GdkWindowObject *private = (GdkWindowObject *)tmp_list->data;
 | |
|       
 | |
|       if (private->update_freeze_count)
 | |
| 	update_windows = g_slist_prepend (update_windows, private);
 | |
|       else
 | |
| 	gdk_window_process_updates_internal (tmp_list->data);
 | |
|       
 | |
|       g_object_unref (tmp_list->data);
 | |
|       tmp_list = tmp_list->next;
 | |
|     }
 | |
| 
 | |
|   g_slist_free (old_update_windows);
 | |
| 
 | |
|   flush_all_displays ();
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_process_updates:
 | |
|  * @window: a #GdkWindow
 | |
|  * @update_children: whether to also process updates for child windows
 | |
|  *
 | |
|  * Sends one or more expose events to @window. The areas in each 
 | |
|  * expose event will cover the entire update area for the window (see
 | |
|  * gdk_window_invalidate_region() for details). Normally GDK calls
 | |
|  * gdk_window_process_all_updates() on your behalf, so there's no
 | |
|  * need to call this function unless you want to force expose events
 | |
|  * to be delivered immediately and synchronously (vs. the usual
 | |
|  * case, where GDK delivers them in an idle handler). Occasionally
 | |
|  * this is useful to produce nicer scrolling behavior, for example.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_process_updates (GdkWindow *window,
 | |
| 			    gboolean   update_children)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
|   
 | |
|   if (private->update_area && !private->update_freeze_count)
 | |
|     {      
 | |
|       gdk_window_process_updates_internal (window);
 | |
|       update_windows = g_slist_remove (update_windows, window);
 | |
|     }
 | |
| 
 | |
|   if (update_children)
 | |
|     {
 | |
|       GList *tmp_list = private->children;
 | |
|       while (tmp_list)
 | |
| 	{
 | |
| 	  gdk_window_process_updates (tmp_list->data, TRUE);
 | |
| 	  tmp_list = tmp_list->next;
 | |
| 	}
 | |
|     }
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_invalidate_rect:
 | |
|  * @window: a #GdkWindow
 | |
|  * @rect: rectangle to invalidate
 | |
|  * @invalidate_children: whether to also invalidate child windows
 | |
|  *
 | |
|  * A convenience wrapper around gdk_window_invalidate_region() which
 | |
|  * invalidates a rectangular region. See
 | |
|  * gdk_window_invalidate_region() for details.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_invalidate_rect   (GdkWindow    *window,
 | |
| 			      GdkRectangle *rect,
 | |
| 			      gboolean      invalidate_children)
 | |
| {
 | |
|   GdkRectangle window_rect;
 | |
|   GdkRegion *region;
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (window))
 | |
|     return;
 | |
|   
 | |
|   if (private->input_only || !GDK_WINDOW_IS_MAPPED (window))
 | |
|     return;
 | |
| 
 | |
|   if (!rect)
 | |
|     {
 | |
|       window_rect.x = 0;
 | |
|       window_rect.y = 0;
 | |
|       gdk_drawable_get_size (GDK_DRAWABLE (window),
 | |
|                              &window_rect.width,
 | |
|                              &window_rect.height);
 | |
|       rect = &window_rect;
 | |
|     }
 | |
| 
 | |
|   region = gdk_region_rectangle (rect);
 | |
|   gdk_window_invalidate_region (window, region, invalidate_children);
 | |
|   gdk_region_destroy (region);
 | |
| }
 | |
| 
 | |
| static void
 | |
| draw_ugly_color (GdkWindow *window,
 | |
|                 GdkRegion *region)
 | |
| {
 | |
|   /* Draw ugly color all over the newly-invalid region */
 | |
|   GdkColor ugly_color = { 0, 50000, 10000, 10000 };
 | |
|   GdkGC *ugly_gc;
 | |
|   GdkRectangle clipbox;
 | |
|     
 | |
|   ugly_gc = gdk_gc_new (window);
 | |
|   gdk_gc_set_rgb_fg_color (ugly_gc, &ugly_color);
 | |
|   gdk_gc_set_clip_region (ugly_gc, region);
 | |
| 
 | |
|   gdk_region_get_clipbox (region, &clipbox);
 | |
|   
 | |
|   gdk_draw_rectangle (window,
 | |
| 		      ugly_gc,
 | |
| 		      TRUE,
 | |
| 		      clipbox.x, clipbox.y,
 | |
| 		      clipbox.width, clipbox.height);
 | |
|   
 | |
|   g_object_unref (ugly_gc);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_invalidate_maybe_recurse:
 | |
|  * @window: a #GdkWindow
 | |
|  * @region: a #GdkRegion
 | |
|  * @child_func: function to use to decide if to recurse to a child,
 | |
|  *              %NULL means never recurse.
 | |
|  * @user_data: data passed to @child_func
 | |
|  *
 | |
|  * Adds @region to the update area for @window. The update area is the
 | |
|  * region that needs to be redrawn, or "dirty region." The call
 | |
|  * gdk_window_process_updates() sends one or more expose events to the
 | |
|  * window, which together cover the entire update area. An
 | |
|  * application would normally redraw the contents of @window in
 | |
|  * response to those expose events.
 | |
|  *
 | |
|  * GDK will call gdk_window_process_all_updates() on your behalf
 | |
|  * whenever your program returns to the main loop and becomes idle, so
 | |
|  * normally there's no need to do that manually, you just need to
 | |
|  * invalidate regions that you know should be redrawn.
 | |
|  *
 | |
|  * The @child_func parameter controls whether the region of
 | |
|  * each child window that intersects @region will also be invalidated.
 | |
|  * Only children for which @child_func returns TRUE will have the area
 | |
|  * invalidated.
 | |
|  **/
 | |
| void
 | |
| gdk_window_invalidate_maybe_recurse (GdkWindow *window,
 | |
| 				     GdkRegion *region,
 | |
| 				     gboolean (*child_func) (GdkWindow *, gpointer),
 | |
| 				     gpointer   user_data)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   GdkRegion *visible_region;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   if (GDK_WINDOW_DESTROYED (window))
 | |
|     return;
 | |
|   
 | |
|   if (private->input_only || !GDK_WINDOW_IS_MAPPED (window))
 | |
|     return;
 | |
| 
 | |
|   visible_region = gdk_drawable_get_visible_region (window);
 | |
|   gdk_region_intersect (visible_region, region);
 | |
| 
 | |
|   if (!gdk_region_empty (visible_region))
 | |
|     {
 | |
|       if (debug_updates)
 | |
|         draw_ugly_color (window, region);
 | |
|       
 | |
|       if (private->update_area)
 | |
| 	{
 | |
| 	  gdk_region_union (private->update_area, visible_region);
 | |
| 	}
 | |
|       else
 | |
| 	{
 | |
| 	  update_windows = g_slist_prepend (update_windows, window);
 | |
| 	  private->update_area = gdk_region_copy (visible_region);
 | |
| 	  
 | |
| 	  gdk_window_schedule_update (window);
 | |
| 	}
 | |
|       
 | |
|       if (child_func)
 | |
| 	{
 | |
| 	  GList *tmp_list;
 | |
| 	  
 | |
| 	  tmp_list = private->children;
 | |
| 	  while (tmp_list)
 | |
| 	    {
 | |
| 	      GdkWindowObject *child = tmp_list->data;
 | |
| 	      tmp_list = tmp_list->next;
 | |
| 
 | |
| 	      if (!child->input_only && (*child_func) ((GdkWindow *)child, user_data))
 | |
| 		{
 | |
| 		  GdkRegion *child_region;
 | |
| 		  gint x, y;
 | |
| 
 | |
| 		  gdk_window_get_position ((GdkWindow *)child, &x, &y);
 | |
| 
 | |
| 		  /* This copy could be saved with a little more complexity */
 | |
| 		  child_region = gdk_region_copy (visible_region);
 | |
| 		  gdk_region_offset (child_region, - x, - y);
 | |
| 		  
 | |
| 		  gdk_window_invalidate_maybe_recurse ((GdkWindow *)child, child_region, child_func, user_data);
 | |
| 		  
 | |
| 		  gdk_region_destroy (child_region);
 | |
| 		}
 | |
| 	    }
 | |
| 	}
 | |
|     }
 | |
|   
 | |
|   gdk_region_destroy (visible_region);
 | |
| }
 | |
| 
 | |
| static gboolean
 | |
| true_predicate (GdkWindow *window,
 | |
| 		gpointer   user_data)
 | |
| {
 | |
|   return TRUE;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_invalidate_region:
 | |
|  * @window: a #GdkWindow
 | |
|  * @region: a #GdkRegion
 | |
|  * @invalidate_children: %TRUE to also invalidate child windows 
 | |
|  *
 | |
|  * Adds @region to the update area for @window. The update area is the
 | |
|  * region that needs to be redrawn, or "dirty region." The call
 | |
|  * gdk_window_process_updates() sends one or more expose events to the
 | |
|  * window, which together cover the entire update area. An
 | |
|  * application would normally redraw the contents of @window in
 | |
|  * response to those expose events.
 | |
|  *
 | |
|  * GDK will call gdk_window_process_all_updates() on your behalf
 | |
|  * whenever your program returns to the main loop and becomes idle, so
 | |
|  * normally there's no need to do that manually, you just need to
 | |
|  * invalidate regions that you know should be redrawn.
 | |
|  *
 | |
|  * The @invalidate_children parameter controls whether the region of
 | |
|  * each child window that intersects @region will also be invalidated.
 | |
|  * If %FALSE, then the update area for child windows will remain
 | |
|  * unaffected. See gdk_window_invalidate_maybe_recurse if you need
 | |
|  * fine grained control over which children are invalidated.
 | |
|  **/
 | |
| void
 | |
| gdk_window_invalidate_region (GdkWindow *window,
 | |
| 			      GdkRegion *region,
 | |
| 			      gboolean   invalidate_children)
 | |
| {
 | |
|   gdk_window_invalidate_maybe_recurse (window, region,
 | |
| 				       invalidate_children ?
 | |
| 				         true_predicate : (gboolean (*) (GdkWindow *, gpointer))NULL,
 | |
| 				       NULL);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_update_area:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Transfers ownership of the update area from @window to the caller
 | |
|  * of the function. That is, after calling this function, @window will
 | |
|  * no longer have an invalid/dirty region; the update area is removed
 | |
|  * from @window and handed to you. If a window has no update area,
 | |
|  * gdk_window_get_update_area() returns %NULL. You are responsible for
 | |
|  * calling gdk_region_destroy() on the returned region if it's non-%NULL.
 | |
|  * 
 | |
|  * Return value: the update area for @window
 | |
|  **/
 | |
| GdkRegion *
 | |
| gdk_window_get_update_area (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
|   GdkRegion *tmp_region;
 | |
| 
 | |
|   g_return_val_if_fail (window != NULL, NULL);
 | |
|   g_return_val_if_fail (GDK_IS_WINDOW (window), NULL);
 | |
| 
 | |
|   if (private->update_area)
 | |
|     {
 | |
|       tmp_region = private->update_area;
 | |
|       private->update_area = NULL;
 | |
| 
 | |
|       update_windows = g_slist_remove (update_windows, window);
 | |
|       
 | |
|       return tmp_region;
 | |
|     }
 | |
|   else
 | |
|     return NULL;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * _gdk_window_clear_update_area:
 | |
|  * @window: a #GdkWindow.
 | |
|  * 
 | |
|  * Internal function to clear the update area for a window. This
 | |
|  * is called when the window is hidden or destroyed.
 | |
|  **/
 | |
| void
 | |
| _gdk_window_clear_update_area (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   if (private->update_area)
 | |
|     {
 | |
|       update_windows = g_slist_remove (update_windows, window);
 | |
|       
 | |
|       gdk_region_destroy (private->update_area);
 | |
|       private->update_area = NULL;
 | |
|     }
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_freeze_updates:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Temporarily freezes a window such that it won't receive expose
 | |
|  * events.  The window will begin receiving expose events again when
 | |
|  * gdk_window_thaw_updates() is called. If gdk_window_freeze_updates()
 | |
|  * has been called more than once, gdk_window_thaw_updates() must be called
 | |
|  * an equal number of times to begin processing exposes.
 | |
|  **/
 | |
| void
 | |
| gdk_window_freeze_updates (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
| 
 | |
|   private->update_freeze_count++;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_thaw_updates:
 | |
|  * @window: a #GdkWindow
 | |
|  * 
 | |
|  * Thaws a window frozen with gdk_window_freeze_updates().
 | |
|  **/
 | |
| void
 | |
| gdk_window_thaw_updates (GdkWindow *window)
 | |
| {
 | |
|   GdkWindowObject *private = (GdkWindowObject *)window;
 | |
| 
 | |
|   g_return_if_fail (window != NULL);
 | |
|   g_return_if_fail (GDK_IS_WINDOW (window));
 | |
|   g_return_if_fail (private->update_freeze_count > 0);
 | |
| 
 | |
|   if (--private->update_freeze_count == 0)
 | |
|     gdk_window_schedule_update (window);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_set_debug_updates:
 | |
|  * @setting: %TRUE to turn on update debugging
 | |
|  *
 | |
|  * With update debugging enabled, calls to
 | |
|  * gdk_window_invalidate_region() clear the invalidated region of the
 | |
|  * screen to a noticeable color, and GDK pauses for a short time
 | |
|  * before sending exposes to windows during
 | |
|  * gdk_window_process_updates().  The net effect is that you can see
 | |
|  * the invalid region for each window and watch redraws as they
 | |
|  * occur. This allows you to diagnose inefficiencies in your application.
 | |
|  *
 | |
|  * In essence, because the GDK rendering model prevents all flicker,
 | |
|  * if you are redrawing the same region 400 times you may never
 | |
|  * notice, aside from noticing a speed problem. Enabling update
 | |
|  * debugging causes GTK to flicker slowly and noticeably, so you can
 | |
|  * see exactly what's being redrawn when, in what order.
 | |
|  *
 | |
|  * The --gtk-debug=updates command line option passed to GTK+ programs
 | |
|  * enables this debug option at application startup time. That's
 | |
|  * usually more useful than calling gdk_window_set_debug_updates()
 | |
|  * yourself, though you might want to use this function to enable
 | |
|  * updates sometime after application startup time.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_window_set_debug_updates (gboolean setting)
 | |
| {
 | |
|   debug_updates = setting;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_constrain_size:
 | |
|  * @geometry: a #GdkGeometry structure
 | |
|  * @flags: a mask indicating what portions of @geometry are set
 | |
|  * @width: desired width of window
 | |
|  * @height: desired height of the window
 | |
|  * @new_width: location to store resulting width
 | |
|  * @new_height: location to store resulting height
 | |
|  * 
 | |
|  * Constrains a desired width and height according to a 
 | |
|  * set of geometry hints (such as minimum and maximum size).
 | |
|  */
 | |
| void
 | |
| gdk_window_constrain_size (GdkGeometry *geometry,
 | |
| 			   guint        flags,
 | |
| 			   gint         width,
 | |
| 			   gint         height,
 | |
| 			   gint        *new_width,
 | |
| 			   gint        *new_height)
 | |
| {
 | |
|   /* This routine is partially borrowed from fvwm.
 | |
|    *
 | |
|    * Copyright 1993, Robert Nation
 | |
|    *     You may use this code for any purpose, as long as the original
 | |
|    *     copyright remains in the source code and all documentation
 | |
|    *
 | |
|    * which in turn borrows parts of the algorithm from uwm
 | |
|    */
 | |
|   gint min_width = 0;
 | |
|   gint min_height = 0;
 | |
|   gint base_width = 0;
 | |
|   gint base_height = 0;
 | |
|   gint xinc = 1;
 | |
|   gint yinc = 1;
 | |
|   gint max_width = G_MAXINT;
 | |
|   gint max_height = G_MAXINT;
 | |
|   
 | |
| #define FLOOR(value, base)	( ((gint) ((value) / (base))) * (base) )
 | |
| 
 | |
|   if ((flags & GDK_HINT_BASE_SIZE) && (flags & GDK_HINT_MIN_SIZE))
 | |
|     {
 | |
|       base_width = geometry->base_width;
 | |
|       base_height = geometry->base_height;
 | |
|       min_width = geometry->min_width;
 | |
|       min_height = geometry->min_height;
 | |
|     }
 | |
|   else if (flags & GDK_HINT_BASE_SIZE)
 | |
|     {
 | |
|       base_width = geometry->base_width;
 | |
|       base_height = geometry->base_height;
 | |
|       min_width = geometry->base_width;
 | |
|       min_height = geometry->base_height;
 | |
|     }
 | |
|   else if (flags & GDK_HINT_MIN_SIZE)
 | |
|     {
 | |
|       base_width = geometry->min_width;
 | |
|       base_height = geometry->min_height;
 | |
|       min_width = geometry->min_width;
 | |
|       min_height = geometry->min_height;
 | |
|     }
 | |
| 
 | |
|   if (flags & GDK_HINT_MAX_SIZE)
 | |
|     {
 | |
|       max_width = geometry->max_width ;
 | |
|       max_height = geometry->max_height;
 | |
|     }
 | |
| 
 | |
|   if (flags & GDK_HINT_RESIZE_INC)
 | |
|     {
 | |
|       xinc = MAX (xinc, geometry->width_inc);
 | |
|       yinc = MAX (yinc, geometry->height_inc);
 | |
|     }
 | |
|   
 | |
|   /* clamp width and height to min and max values
 | |
|    */
 | |
|   width = CLAMP (width, min_width, max_width);
 | |
|   height = CLAMP (height, min_height, max_height);
 | |
|   
 | |
|   /* shrink to base + N * inc
 | |
|    */
 | |
|   width = base_width + FLOOR (width - base_width, xinc);
 | |
|   height = base_height + FLOOR (height - base_height, yinc);
 | |
| 
 | |
|   /* constrain aspect ratio, according to:
 | |
|    *
 | |
|    *                width     
 | |
|    * min_aspect <= -------- <= max_aspect
 | |
|    *                height    
 | |
|    */
 | |
|   
 | |
|   if (flags & GDK_HINT_ASPECT &&
 | |
|       geometry->min_aspect > 0 &&
 | |
|       geometry->max_aspect > 0)
 | |
|     {
 | |
|       gint delta;
 | |
| 
 | |
|       if (geometry->min_aspect * height > width)
 | |
| 	{
 | |
| 	  delta = FLOOR (height - width / geometry->min_aspect, yinc);
 | |
| 	  if (height - delta >= min_height)
 | |
| 	    height -= delta;
 | |
| 	  else
 | |
| 	    { 
 | |
| 	      delta = FLOOR (height * geometry->min_aspect - width, xinc);
 | |
| 	      if (width + delta <= max_width) 
 | |
| 		width += delta;
 | |
| 	    }
 | |
| 	}
 | |
|       
 | |
|       if (geometry->max_aspect * height < width)
 | |
| 	{
 | |
| 	  delta = FLOOR (width - height * geometry->max_aspect, xinc);
 | |
| 	  if (width - delta >= min_width) 
 | |
| 	    width -= delta;
 | |
| 	  else
 | |
| 	    {
 | |
| 	      delta = FLOOR (width / geometry->max_aspect - height, yinc);
 | |
| 	      if (height + delta <= max_height)
 | |
| 		height += delta;
 | |
| 	    }
 | |
| 	}
 | |
|     }
 | |
| 
 | |
| #undef FLOOR
 | |
|   
 | |
|   *new_width = width;
 | |
|   *new_height = height;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_get_pointer:
 | |
|  * @window: a #GdkWindow
 | |
|  * @x: return location for X coordinate of pointer
 | |
|  * @y: return location for Y coordinate of pointer
 | |
|  * @mask: return location for modifier mask
 | |
|  *
 | |
|  * Obtains the current pointer position and modifier state.
 | |
|  * The position is given in coordinates relative to @window.
 | |
|  * 
 | |
|  * Return value: the window containing the pointer (as with
 | |
|  * gdk_window_at_pointer()), or %NULL if the window containing the
 | |
|  * pointer isn't known to GDK
 | |
|  **/
 | |
| GdkWindow*
 | |
| gdk_window_get_pointer (GdkWindow	  *window,
 | |
| 			gint		  *x,
 | |
| 			gint		  *y,
 | |
| 			GdkModifierType   *mask)
 | |
| {
 | |
|   GdkDisplay *display;
 | |
|   gint tmp_x, tmp_y;
 | |
|   GdkModifierType tmp_mask;
 | |
|   GdkWindow *child;
 | |
|   
 | |
|   g_return_val_if_fail (window == NULL || GDK_IS_WINDOW (window), NULL);
 | |
| 
 | |
|   if (window)
 | |
|     {
 | |
|       display = gdk_drawable_get_display (window);
 | |
|     }
 | |
|   else
 | |
|     {
 | |
|       GdkScreen *screen = gdk_screen_get_default ();
 | |
| 
 | |
|       display = gdk_screen_get_display (screen);
 | |
|       window = gdk_screen_get_root_window (screen);
 | |
|       
 | |
|       GDK_NOTE (MULTIHEAD,
 | |
| 		g_message ("Passing NULL for window to gdk_window_get_pointer()\n"
 | |
| 			   "is not multihead safe"));
 | |
|     }
 | |
| 
 | |
|   child = display->pointer_hooks->window_get_pointer (display, window, &tmp_x, &tmp_y, &tmp_mask);
 | |
| 
 | |
|   if (x)
 | |
|     *x = tmp_x;
 | |
|   if (y)
 | |
|     *y = tmp_y;
 | |
|   if (mask)
 | |
|     *mask = tmp_mask;
 | |
| 
 | |
|   return child;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_at_pointer:
 | |
|  * @win_x: return location for origin of the window under the pointer
 | |
|  * @win_y: return location for origin of the window under the pointer
 | |
|  * 
 | |
|  * Obtains the window underneath the mouse pointer, returning the
 | |
|  * location of that window in @win_x, @win_y. Returns %NULL if the
 | |
|  * window under the mouse pointer is not known to GDK (if the window
 | |
|  * belongs to another application and a #GdkWindow hasn't been created
 | |
|  * for it with gdk_window_foreign_new())
 | |
|  *
 | |
|  * NOTE: For multihead-aware widgets or applications use
 | |
|  * gdk_display_get_window_at_pointer() instead.
 | |
|  * 
 | |
|  * Return value: window under the mouse pointer
 | |
|  **/
 | |
| GdkWindow*
 | |
| gdk_window_at_pointer (gint *win_x,
 | |
| 		       gint *win_y)
 | |
| {
 | |
|   return gdk_display_get_window_at_pointer (gdk_display_get_default (), win_x, win_y);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_get_default_root_window:
 | |
|  * 
 | |
|  * Obtains the root window (parent all other windows are inside)
 | |
|  * for the default display and screen.
 | |
|  * 
 | |
|  * Return value: the default root window
 | |
|  **/
 | |
| GdkWindow *
 | |
| gdk_get_default_root_window (void)
 | |
| {
 | |
|   return gdk_screen_get_root_window (gdk_screen_get_default ());
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_window_foreign_new:
 | |
|  * @anid: a native window handle.
 | |
|  * 
 | |
|  * Wraps a native window for the default display in a #GdkWindow.
 | |
|  * This may fail if the window has been destroyed.
 | |
|  *
 | |
|  * For example in the X backend, a native window handle is an Xlib
 | |
|  * <type>XID</type>.
 | |
|  * 
 | |
|  * Return value: the newly-created #GdkWindow wrapper for the 
 | |
|  *    native window or %NULL if the window has been destroyed.
 | |
|  **/
 | |
| GdkWindow *
 | |
| gdk_window_foreign_new (GdkNativeWindow anid)
 | |
| {
 | |
|   return gdk_window_foreign_new_for_display (gdk_display_get_default (), anid);
 | |
| }
 | |
| 
 |