 6df89b0ad8
			
		
	
	6df89b0ad8
	
	
	
		
			
			2008-10-21 Michael Natterer <mitch@imendio.com> * gdk/gdkdraw.c * gdk/gdkimage.c * gdk/gdkscreen.c * gdk/gdkwindow.c: replace assertions for obj != NULL by GDK_IS_OBJ(), remove redundant != NULL checks when there is already a type check, add some g_return_if_fail() that were missing entirely, fix some broken indentation and spacing. svn path=/trunk/; revision=21695
		
			
				
	
	
		
			1776 lines
		
	
	
		
			51 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			1776 lines
		
	
	
		
			51 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 <math.h>
 | |
| #include <pango/pangocairo.h>
 | |
| #include "gdkcairo.h"
 | |
| #include "gdkdrawable.h"
 | |
| #include "gdkinternals.h"
 | |
| #include "gdkwindow.h"
 | |
| #include "gdkscreen.h"
 | |
| #include "gdk-pixbuf-private.h"
 | |
| #include "gdkpixbuf.h"
 | |
| #include "gdkalias.h"
 | |
| 
 | |
| static GdkImage*    gdk_drawable_real_get_image (GdkDrawable     *drawable,
 | |
| 						 gint             x,
 | |
| 						 gint             y,
 | |
| 						 gint             width,
 | |
| 						 gint             height);
 | |
| static GdkDrawable* gdk_drawable_real_get_composite_drawable (GdkDrawable  *drawable,
 | |
| 							      gint          x,
 | |
| 							      gint          y,
 | |
| 							      gint          width,
 | |
| 							      gint          height,
 | |
| 							      gint         *composite_x_offset,
 | |
| 							      gint         *composite_y_offset);
 | |
| static GdkRegion *  gdk_drawable_real_get_visible_region     (GdkDrawable  *drawable);
 | |
| static void         gdk_drawable_real_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);
 | |
|      
 | |
| 
 | |
| G_DEFINE_ABSTRACT_TYPE (GdkDrawable, gdk_drawable, G_TYPE_OBJECT)
 | |
| 
 | |
| static void
 | |
| gdk_drawable_class_init (GdkDrawableClass *klass)
 | |
| {
 | |
|   klass->get_image = gdk_drawable_real_get_image;
 | |
|   klass->get_composite_drawable = gdk_drawable_real_get_composite_drawable;
 | |
|   /* Default implementation for clip and visible region is the same */
 | |
|   klass->get_clip_region = gdk_drawable_real_get_visible_region;
 | |
|   klass->get_visible_region = gdk_drawable_real_get_visible_region;
 | |
|   klass->draw_pixbuf = gdk_drawable_real_draw_pixbuf;
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_drawable_init (GdkDrawable *drawable)
 | |
| {
 | |
| }
 | |
| 
 | |
| /* Manipulation of drawables
 | |
|  */
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_set_data:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @key: name to store the data under
 | |
|  * @data: arbitrary data
 | |
|  * @destroy_func: function to free @data, or %NULL
 | |
|  *
 | |
|  * This function is equivalent to g_object_set_data(),
 | |
|  * the #GObject variant should be used instead.
 | |
|  * 
 | |
|  **/
 | |
| void          
 | |
| gdk_drawable_set_data (GdkDrawable   *drawable,
 | |
| 		       const gchar   *key,
 | |
| 		       gpointer	      data,
 | |
| 		       GDestroyNotify destroy_func)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   
 | |
|   g_object_set_qdata_full (G_OBJECT (drawable),
 | |
|                            g_quark_from_string (key),
 | |
|                            data,
 | |
|                            destroy_func);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_data:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @key: name the data was stored under
 | |
|  * 
 | |
|  * Equivalent to g_object_get_data(); the #GObject variant should be
 | |
|  * used instead.
 | |
|  * 
 | |
|  * Return value: the data stored at @key
 | |
|  **/
 | |
| gpointer
 | |
| gdk_drawable_get_data (GdkDrawable   *drawable,
 | |
| 		       const gchar   *key)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
|   
 | |
|   return g_object_get_qdata (G_OBJECT (drawable),
 | |
|                              g_quark_try_string (key));
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_size:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @width: location to store drawable's width, or %NULL
 | |
|  * @height: location to store drawable's height, or %NULL
 | |
|  *
 | |
|  * Fills *@width and *@height with the size of @drawable.
 | |
|  * @width or @height can be %NULL if you only want the other one.
 | |
|  * 
 | |
|  * On the X11 platform, if @drawable is a #GdkWindow, the returned
 | |
|  * size is the size reported in the most-recently-processed configure
 | |
|  * event, rather than the current size on the X server.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_drawable_get_size (GdkDrawable *drawable,
 | |
| 		       gint        *width,
 | |
| 		       gint        *height)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->get_size (drawable, width, height);  
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_visual:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Gets the #GdkVisual describing the pixel format of @drawable.
 | |
|  * 
 | |
|  * Return value: a #GdkVisual
 | |
|  **/
 | |
| GdkVisual*
 | |
| gdk_drawable_get_visual (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
|   
 | |
|   return GDK_DRAWABLE_GET_CLASS (drawable)->get_visual (drawable);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_depth:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Obtains the bit depth of the drawable, that is, the number of bits
 | |
|  * that make up a pixel in the drawable's visual. Examples are 8 bits
 | |
|  * per pixel, 24 bits per pixel, etc.
 | |
|  * 
 | |
|  * Return value: number of bits per pixel
 | |
|  **/
 | |
| gint
 | |
| gdk_drawable_get_depth (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), 0);
 | |
| 
 | |
|   return GDK_DRAWABLE_GET_CLASS (drawable)->get_depth (drawable);
 | |
| }
 | |
| /**
 | |
|  * gdk_drawable_get_screen:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Gets the #GdkScreen associated with a #GdkDrawable.
 | |
|  * 
 | |
|  * Return value: the #GdkScreen associated with @drawable
 | |
|  *
 | |
|  * Since: 2.2
 | |
|  **/
 | |
| GdkScreen*
 | |
| gdk_drawable_get_screen(GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
| 
 | |
|   return GDK_DRAWABLE_GET_CLASS (drawable)->get_screen (drawable);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_display:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Gets the #GdkDisplay associated with a #GdkDrawable.
 | |
|  * 
 | |
|  * Return value: the #GdkDisplay associated with @drawable
 | |
|  *
 | |
|  * Since: 2.2
 | |
|  **/
 | |
| GdkDisplay*
 | |
| gdk_drawable_get_display (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
|   
 | |
|   return gdk_screen_get_display (gdk_drawable_get_screen (drawable));
 | |
| }
 | |
| 	
 | |
| /**
 | |
|  * gdk_drawable_set_colormap:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @colormap: a #GdkColormap
 | |
|  *
 | |
|  * Sets the colormap associated with @drawable. Normally this will
 | |
|  * happen automatically when the drawable is created; you only need to
 | |
|  * use this function if the drawable-creating function did not have a
 | |
|  * way to determine the colormap, and you then use drawable operations
 | |
|  * that require a colormap. The colormap for all drawables and
 | |
|  * graphics contexts you intend to use together should match. i.e.
 | |
|  * when using a #GdkGC to draw to a drawable, or copying one drawable
 | |
|  * to another, the colormaps should match.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_drawable_set_colormap (GdkDrawable *drawable,
 | |
|                            GdkColormap *cmap)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (cmap == NULL || gdk_drawable_get_depth (drawable)
 | |
|                     == cmap->visual->depth);
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->set_colormap (drawable, cmap);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_colormap:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Gets the colormap for @drawable, if one is set; returns
 | |
|  * %NULL otherwise.
 | |
|  * 
 | |
|  * Return value: the colormap, or %NULL
 | |
|  **/
 | |
| GdkColormap*
 | |
| gdk_drawable_get_colormap (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
| 
 | |
|   return GDK_DRAWABLE_GET_CLASS (drawable)->get_colormap (drawable);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_ref:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Deprecated equivalent of calling g_object_ref() on @drawable.
 | |
|  * (Drawables were not objects in previous versions of GDK.)
 | |
|  * 
 | |
|  * Return value: the same @drawable passed in
 | |
|  **/
 | |
| GdkDrawable*
 | |
| gdk_drawable_ref (GdkDrawable *drawable)
 | |
| {
 | |
|   return (GdkDrawable *) g_object_ref (drawable);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_unref:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Deprecated equivalent of calling g_object_unref() on @drawable.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_drawable_unref (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
| 
 | |
|   g_object_unref (drawable);
 | |
| }
 | |
| 
 | |
| /* Drawing
 | |
|  */
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_point:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @gc: a #GdkGC.
 | |
|  * @x: the x coordinate of the point.
 | |
|  * @y: the y coordinate of the point.
 | |
|  * 
 | |
|  * Draws a point, using the foreground color and other attributes of 
 | |
|  * the #GdkGC.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_point (GdkDrawable *drawable,
 | |
|                 GdkGC       *gc,
 | |
|                 gint         x,
 | |
|                 gint         y)
 | |
| {
 | |
|   GdkPoint point;
 | |
| 
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
| 
 | |
|   point.x = x;
 | |
|   point.y = y;
 | |
|   
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_points (drawable, gc, &point, 1);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_line:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap). 
 | |
|  * @gc: a #GdkGC.
 | |
|  * @x1_: the x coordinate of the start point.
 | |
|  * @y1_: the y coordinate of the start point.
 | |
|  * @x2_: the x coordinate of the end point.
 | |
|  * @y2_: the y coordinate of the end point.
 | |
|  * 
 | |
|  * Draws a line, using the foreground color and other attributes of 
 | |
|  * the #GdkGC.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_line (GdkDrawable *drawable,
 | |
| 	       GdkGC       *gc,
 | |
| 	       gint         x1,
 | |
| 	       gint         y1,
 | |
| 	       gint         x2,
 | |
| 	       gint         y2)
 | |
| {
 | |
|   GdkSegment segment;
 | |
| 
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
| 
 | |
|   segment.x1 = x1;
 | |
|   segment.y1 = y1;
 | |
|   segment.x2 = x2;
 | |
|   segment.y2 = y2;
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_segments (drawable, gc, &segment, 1);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_rectangle:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @gc: a #GdkGC.
 | |
|  * @filled: %TRUE if the rectangle should be filled.
 | |
|  * @x: the x coordinate of the left edge of the rectangle.
 | |
|  * @y: the y coordinate of the top edge of the rectangle.
 | |
|  * @width: the width of the rectangle.
 | |
|  * @height: the height of the rectangle.
 | |
|  * 
 | |
|  * Draws a rectangular outline or filled rectangle, using the foreground color
 | |
|  * and other attributes of the #GdkGC.
 | |
|  *
 | |
|  * A rectangle drawn filled is 1 pixel smaller in both dimensions than a 
 | |
|  * rectangle outlined. Calling 
 | |
|  * <literal>gdk_draw_rectangle (window, gc, TRUE, 0, 0, 20, 20)</literal> 
 | |
|  * results in a filled rectangle 20 pixels wide and 20 pixels high. Calling
 | |
|  * <literal>gdk_draw_rectangle (window, gc, FALSE, 0, 0, 20, 20)</literal> 
 | |
|  * results in an outlined rectangle with corners at (0, 0), (0, 20), (20, 20),
 | |
|  * and (20, 0), which makes it 21 pixels wide and 21 pixels high.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_rectangle (GdkDrawable *drawable,
 | |
| 		    GdkGC       *gc,
 | |
| 		    gboolean     filled,
 | |
| 		    gint         x,
 | |
| 		    gint         y,
 | |
| 		    gint         width,
 | |
| 		    gint         height)
 | |
| {  
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
| 
 | |
|   if (width < 0 || height < 0)
 | |
|     {
 | |
|       gint real_width;
 | |
|       gint real_height;
 | |
|       
 | |
|       gdk_drawable_get_size (drawable, &real_width, &real_height);
 | |
| 
 | |
|       if (width < 0)
 | |
|         width = real_width;
 | |
|       if (height < 0)
 | |
|         height = real_height;
 | |
|     }
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_rectangle (drawable, gc, filled, x, y,
 | |
|                                                      width, height);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_arc:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @gc: a #GdkGC.
 | |
|  * @filled: %TRUE if the arc should be filled, producing a 'pie slice'.
 | |
|  * @x: the x coordinate of the left edge of the bounding rectangle.
 | |
|  * @y: the y coordinate of the top edge of the bounding rectangle.
 | |
|  * @width: the width of the bounding rectangle.
 | |
|  * @height: the height of the bounding rectangle.
 | |
|  * @angle1: the start angle of the arc, relative to the 3 o'clock position,
 | |
|  *     counter-clockwise, in 1/64ths of a degree.
 | |
|  * @angle2: the end angle of the arc, relative to @angle1, in 1/64ths 
 | |
|  *     of a degree.
 | |
|  * 
 | |
|  * Draws an arc or a filled 'pie slice'. The arc is defined by the bounding
 | |
|  * rectangle of the entire ellipse, and the start and end angles of the part 
 | |
|  * of the ellipse to be drawn.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_arc (GdkDrawable *drawable,
 | |
| 	      GdkGC       *gc,
 | |
| 	      gboolean     filled,
 | |
| 	      gint         x,
 | |
| 	      gint         y,
 | |
| 	      gint         width,
 | |
| 	      gint         height,
 | |
| 	      gint         angle1,
 | |
| 	      gint         angle2)
 | |
| {  
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
| 
 | |
|   if (width < 0 || height < 0)
 | |
|     {
 | |
|       gint real_width;
 | |
|       gint real_height;
 | |
|       
 | |
|       gdk_drawable_get_size (drawable, &real_width, &real_height);
 | |
| 
 | |
|       if (width < 0)
 | |
|         width = real_width;
 | |
|       if (height < 0)
 | |
|         height = real_height;
 | |
|     }
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_arc (drawable, gc, filled,
 | |
|                                                x, y, width, height, angle1, angle2);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_polygon:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @gc: a #GdkGC.
 | |
|  * @filled: %TRUE if the polygon should be filled. The polygon is closed
 | |
|  *     automatically, connecting the last point to the first point if 
 | |
|  *     necessary.
 | |
|  * @points: an array of #GdkPoint structures specifying the points making 
 | |
|  *     up the polygon.
 | |
|  * @n_points: the number of points.
 | |
|  * 
 | |
|  * Draws an outlined or filled polygon.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_polygon (GdkDrawable    *drawable,
 | |
| 		  GdkGC          *gc,
 | |
| 		  gboolean        filled,
 | |
| 		  const GdkPoint *points,
 | |
| 		  gint            n_points)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_polygon (drawable, gc, filled,
 | |
|                                                    (GdkPoint *) points,
 | |
|                                                    n_points);
 | |
| }
 | |
| 
 | |
| /* gdk_draw_string
 | |
|  *
 | |
|  * Modified by Li-Da Lho to draw 16 bits and Multibyte strings
 | |
|  *
 | |
|  * Interface changed: add "GdkFont *font" to specify font or fontset explicitely
 | |
|  */
 | |
| /**
 | |
|  * gdk_draw_string:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @font: a #GdkFont.
 | |
|  * @gc: a #GdkGC.
 | |
|  * @x: the x coordinate of the left edge of the text.
 | |
|  * @y: the y coordinate of the baseline of the text.
 | |
|  * @string:  the string of characters to draw.
 | |
|  * 
 | |
|  * Draws a string of characters in the given font or fontset.
 | |
|  * 
 | |
|  * Deprecated: Use gdk_draw_layout() instead.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_string (GdkDrawable *drawable,
 | |
| 		 GdkFont     *font,
 | |
| 		 GdkGC       *gc,
 | |
| 		 gint         x,
 | |
| 		 gint         y,
 | |
| 		 const gchar *string)
 | |
| {
 | |
|   gdk_draw_text (drawable, font, gc, x, y, string, _gdk_font_strlen (font, string));
 | |
| }
 | |
| 
 | |
| /* gdk_draw_text
 | |
|  *
 | |
|  * Modified by Li-Da Lho to draw 16 bits and Multibyte strings
 | |
|  *
 | |
|  * Interface changed: add "GdkFont *font" to specify font or fontset explicitely
 | |
|  */
 | |
| /**
 | |
|  * gdk_draw_text:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @font: a #GdkFont.
 | |
|  * @gc: a #GdkGC.
 | |
|  * @x: the x coordinate of the left edge of the text.
 | |
|  * @y: the y coordinate of the baseline of the text.
 | |
|  * @text:  the characters to draw.
 | |
|  * @text_length: the number of characters of @text to draw.
 | |
|  * 
 | |
|  * Draws a number of characters in the given font or fontset.
 | |
|  *
 | |
|  * Deprecated: Use gdk_draw_layout() instead.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_text (GdkDrawable *drawable,
 | |
| 	       GdkFont     *font,
 | |
| 	       GdkGC       *gc,
 | |
| 	       gint         x,
 | |
| 	       gint         y,
 | |
| 	       const gchar *text,
 | |
| 	       gint         text_length)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (font != NULL);
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
|   g_return_if_fail (text != NULL);
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_text (drawable, font, gc, x, y, text, text_length);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_text_wc:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @font: a #GdkFont.
 | |
|  * @gc: a #GdkGC.
 | |
|  * @x: the x coordinate of the left edge of the text.
 | |
|  * @y: the y coordinate of the baseline of the text.
 | |
|  * @text: the wide characters to draw.
 | |
|  * @text_length: the number of characters to draw.
 | |
|  * 
 | |
|  * Draws a number of wide characters using the given font of fontset.
 | |
|  * If the font is a 1-byte font, the string is converted into 1-byte 
 | |
|  * characters (discarding the high bytes) before output.
 | |
|  * 
 | |
|  * Deprecated: Use gdk_draw_layout() instead.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_text_wc (GdkDrawable	 *drawable,
 | |
| 		  GdkFont	 *font,
 | |
| 		  GdkGC		 *gc,
 | |
| 		  gint		  x,
 | |
| 		  gint		  y,
 | |
| 		  const GdkWChar *text,
 | |
| 		  gint		  text_length)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (font != NULL);
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
|   g_return_if_fail (text != NULL);
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_text_wc (drawable, font, gc, x, y, text, text_length);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_drawable:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @gc: a #GdkGC sharing the drawable's visual and colormap
 | |
|  * @src: the source #GdkDrawable, which may be the same as @drawable
 | |
|  * @xsrc: X position in @src of rectangle to draw
 | |
|  * @ysrc: Y position in @src of rectangle to draw
 | |
|  * @xdest: X position in @drawable where the rectangle should be drawn
 | |
|  * @ydest: Y position in @drawable where the rectangle should be drawn
 | |
|  * @width: width of rectangle to draw, or -1 for entire @src width
 | |
|  * @height: height of rectangle to draw, or -1 for entire @src height
 | |
|  *
 | |
|  * Copies the @width x @height region of @src at coordinates (@xsrc,
 | |
|  * @ysrc) to coordinates (@xdest, @ydest) in @drawable.
 | |
|  * @width and/or @height may be given as -1, in which case the entire
 | |
|  * @src drawable will be copied.
 | |
|  *
 | |
|  * Most fields in @gc are not used for this operation, but notably the
 | |
|  * clip mask or clip region will be honored.
 | |
|  *
 | |
|  * The source and destination drawables must have the same visual and
 | |
|  * colormap, or errors will result. (On X11, failure to match
 | |
|  * visual/colormap results in a BadMatch error from the X server.)
 | |
|  * A common cause of this problem is an attempt to draw a bitmap to
 | |
|  * a color drawable. The way to draw a bitmap is to set the bitmap as 
 | |
|  * the stipple on the #GdkGC, set the fill mode to %GDK_STIPPLED, and 
 | |
|  * then draw the rectangle.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_drawable (GdkDrawable *drawable,
 | |
| 		   GdkGC       *gc,
 | |
| 		   GdkDrawable *src,
 | |
| 		   gint         xsrc,
 | |
| 		   gint         ysrc,
 | |
| 		   gint         xdest,
 | |
| 		   gint         ydest,
 | |
| 		   gint         width,
 | |
| 		   gint         height)
 | |
| {
 | |
|   GdkDrawable *composite;
 | |
|   gint composite_x_offset = 0;
 | |
|   gint composite_y_offset = 0;
 | |
| 
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (src));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
| 
 | |
|   if (width < 0 || height < 0)
 | |
|     {
 | |
|       gint real_width;
 | |
|       gint real_height;
 | |
|       
 | |
|       gdk_drawable_get_size (src, &real_width, &real_height);
 | |
| 
 | |
|       if (width < 0)
 | |
|         width = real_width;
 | |
|       if (height < 0)
 | |
|         height = real_height;
 | |
|     }
 | |
| 
 | |
| 
 | |
|   composite =
 | |
|     GDK_DRAWABLE_GET_CLASS (src)->get_composite_drawable (src,
 | |
|                                                           xsrc, ysrc,
 | |
|                                                           width, height,
 | |
|                                                           &composite_x_offset,
 | |
|                                                           &composite_y_offset);
 | |
| 
 | |
|   
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_drawable (drawable, gc, composite,
 | |
|                                                     xsrc - composite_x_offset,
 | |
|                                                     ysrc - composite_y_offset,
 | |
|                                                     xdest, ydest,
 | |
|                                                     width, height);
 | |
|   
 | |
|   g_object_unref (composite);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_image:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @gc: a #GdkGC.
 | |
|  * @image: the #GdkImage to draw.
 | |
|  * @xsrc: the left edge of the source rectangle within @image.
 | |
|  * @ysrc: the top of the source rectangle within @image.
 | |
|  * @xdest: the x coordinate of the destination within @drawable.
 | |
|  * @ydest: the y coordinate of the destination within @drawable.
 | |
|  * @width: the width of the area to be copied, or -1 to make the area 
 | |
|  *     extend to the right edge of @image.
 | |
|  * @height: the height of the area to be copied, or -1 to make the area 
 | |
|  *     extend to the bottom edge of @image.
 | |
|  * 
 | |
|  * Draws a #GdkImage onto a drawable.
 | |
|  * The depth of the #GdkImage must match the depth of the #GdkDrawable.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_image (GdkDrawable *drawable,
 | |
| 		GdkGC       *gc,
 | |
| 		GdkImage    *image,
 | |
| 		gint         xsrc,
 | |
| 		gint         ysrc,
 | |
| 		gint         xdest,
 | |
| 		gint         ydest,
 | |
| 		gint         width,
 | |
| 		gint         height)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_IMAGE (image));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
| 
 | |
|   if (width == -1)
 | |
|     width = image->width;
 | |
|   if (height == -1)
 | |
|     height = image->height;
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_image (drawable, gc, image, xsrc, ysrc,
 | |
|                                                  xdest, ydest, width, height);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_pixbuf:
 | |
|  * @drawable: Destination drawable.
 | |
|  * @gc: a #GdkGC, used for clipping, or %NULL
 | |
|  * @pixbuf: a #GdkPixbuf
 | |
|  * @src_x: Source X coordinate within pixbuf.
 | |
|  * @src_y: Source Y coordinates within pixbuf.
 | |
|  * @dest_x: Destination X coordinate within drawable.
 | |
|  * @dest_y: Destination Y coordinate within drawable.
 | |
|  * @width: Width of region to render, in pixels, or -1 to use pixbuf width.
 | |
|  * @height: Height of region to render, in pixels, or -1 to use pixbuf height.
 | |
|  * @dither: Dithering mode for #GdkRGB.
 | |
|  * @x_dither: X offset for dither.
 | |
|  * @y_dither: Y offset for dither.
 | |
|  * 
 | |
|  * Renders a rectangular portion of a pixbuf to a drawable.  The destination
 | |
|  * drawable must have a colormap. All windows have a colormap, however, pixmaps
 | |
|  * only have colormap by default if they were created with a non-%NULL window 
 | |
|  * argument. Otherwise a colormap must be set on them with 
 | |
|  * gdk_drawable_set_colormap().
 | |
|  *
 | |
|  * On older X servers, rendering pixbufs with an alpha channel involves round 
 | |
|  * trips to the X server, and may be somewhat slow.
 | |
|  *
 | |
|  * The clip mask of @gc is ignored, but clip rectangles and clip regions work
 | |
|  * fine.
 | |
|  *
 | |
|  * If GDK is built with the Sun mediaLib library, the gdk_draw_pixbuf
 | |
|  * function is accelerated using mediaLib, which provides hardware
 | |
|  * acceleration on Intel, AMD, and Sparc chipsets.  If desired, mediaLib
 | |
|  * support can be turned off by setting the GDK_DISABLE_MEDIALIB environment
 | |
|  * variable.
 | |
|  *
 | |
|  * Since: 2.2
 | |
|  **/
 | |
| void
 | |
| gdk_draw_pixbuf (GdkDrawable     *drawable,
 | |
|                  GdkGC           *gc,
 | |
|                  const 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)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (gc == NULL || GDK_IS_GC (gc));
 | |
|   g_return_if_fail (GDK_IS_PIXBUF (pixbuf));
 | |
| 
 | |
|   if (width == 0 || height == 0)
 | |
|     return;
 | |
| 
 | |
|   if (width == -1)
 | |
|     width = gdk_pixbuf_get_width (pixbuf);
 | |
|   if (height == -1)
 | |
|     height = gdk_pixbuf_get_height (pixbuf);
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_pixbuf (drawable, gc,
 | |
|                                                   (GdkPixbuf *) pixbuf,
 | |
| 						  src_x, src_y, dest_x, dest_y,
 | |
|                                                   width, height,
 | |
| 						  dither, x_dither, y_dither);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_points:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @gc: a #GdkGC.
 | |
|  * @points: an array of #GdkPoint structures.
 | |
|  * @n_points: the number of points to be drawn.
 | |
|  * 
 | |
|  * Draws a number of points, using the foreground color and other 
 | |
|  * attributes of the #GdkGC.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_points (GdkDrawable    *drawable,
 | |
| 		 GdkGC          *gc,
 | |
| 		 const GdkPoint *points,
 | |
| 		 gint            n_points)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail ((points != NULL) && (n_points > 0));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
|   g_return_if_fail (n_points >= 0);
 | |
| 
 | |
|   if (n_points == 0)
 | |
|     return;
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_points (drawable, gc,
 | |
|                                                   (GdkPoint *) points, n_points);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_segments:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @gc: a #GdkGC.
 | |
|  * @segs: an array of #GdkSegment structures specifying the start and 
 | |
|  *   end points of the lines to be drawn.
 | |
|  * @n_segs: the number of line segments to draw, i.e. the size of the 
 | |
|  *   @segs array.
 | |
|  * 
 | |
|  * Draws a number of unconnected lines.
 | |
|  **/
 | |
| void
 | |
| gdk_draw_segments (GdkDrawable      *drawable,
 | |
| 		   GdkGC            *gc,
 | |
| 		   const GdkSegment *segs,
 | |
| 		   gint              n_segs)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
| 
 | |
|   if (n_segs == 0)
 | |
|     return;
 | |
| 
 | |
|   g_return_if_fail (segs != NULL);
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
|   g_return_if_fail (n_segs >= 0);
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_segments (drawable, gc,
 | |
|                                                     (GdkSegment *) segs, n_segs);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_lines:
 | |
|  * @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
 | |
|  * @gc: a #GdkGC.
 | |
|  * @points: an array of #GdkPoint structures specifying the endpoints of the
 | |
|  * @n_points: the size of the @points array.
 | |
|  * 
 | |
|  * Draws a series of lines connecting the given points.
 | |
|  * The way in which joins between lines are draw is determined by the
 | |
|  * #GdkCapStyle value in the #GdkGC. This can be set with
 | |
|  * gdk_gc_set_line_attributes().
 | |
|  **/
 | |
| void
 | |
| gdk_draw_lines (GdkDrawable    *drawable,
 | |
| 		GdkGC          *gc,
 | |
| 		const GdkPoint *points,
 | |
| 		gint            n_points)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (points != NULL);
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
|   g_return_if_fail (n_points >= 0);
 | |
| 
 | |
|   if (n_points == 0)
 | |
|     return;
 | |
| 
 | |
|   GDK_DRAWABLE_GET_CLASS (drawable)->draw_lines (drawable, gc,
 | |
|                                                  (GdkPoint *) points, n_points);
 | |
| }
 | |
| 
 | |
| static void
 | |
| real_draw_glyphs (GdkDrawable       *drawable,
 | |
| 		  GdkGC	            *gc,
 | |
| 		  const PangoMatrix *matrix,
 | |
| 		  PangoFont         *font,
 | |
| 		  gdouble            x,
 | |
| 		  gdouble            y,
 | |
| 		  PangoGlyphString  *glyphs)
 | |
| {
 | |
|   cairo_t *cr;
 | |
| 
 | |
|   cr = gdk_cairo_create (drawable);
 | |
|   _gdk_gc_update_context (gc, cr, NULL, NULL, TRUE);
 | |
| 
 | |
|   if (matrix)
 | |
|     {
 | |
|       cairo_matrix_t cairo_matrix;
 | |
| 
 | |
|       cairo_matrix.xx = matrix->xx;
 | |
|       cairo_matrix.yx = matrix->yx;
 | |
|       cairo_matrix.xy = matrix->xy;
 | |
|       cairo_matrix.yy = matrix->yy;
 | |
|       cairo_matrix.x0 = matrix->x0;
 | |
|       cairo_matrix.y0 = matrix->y0;
 | |
|       
 | |
|       cairo_set_matrix (cr, &cairo_matrix);
 | |
|     }
 | |
| 
 | |
|   cairo_move_to (cr, x, y);
 | |
|   pango_cairo_show_glyph_string (cr, font, glyphs);
 | |
| 
 | |
|   cairo_destroy (cr);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_glyphs:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @gc: a #GdkGC
 | |
|  * @font: font to be used
 | |
|  * @x: X coordinate of baseline origin
 | |
|  * @y: Y coordinate of baseline origin
 | |
|  * @glyphs: the glyph string to draw
 | |
|  *
 | |
|  * This is a low-level function; 99% of text rendering should be done
 | |
|  * using gdk_draw_layout() instead.
 | |
|  *
 | |
|  * A glyph is a single image in a font. This function draws a sequence of
 | |
|  * glyphs.  To obtain a sequence of glyphs you have to understand a
 | |
|  * lot about internationalized text handling, which you don't want to
 | |
|  * understand; thus, use gdk_draw_layout() instead of this function,
 | |
|  * gdk_draw_layout() handles the details.
 | |
|  * 
 | |
|  **/
 | |
| void
 | |
| gdk_draw_glyphs (GdkDrawable      *drawable,
 | |
| 		 GdkGC            *gc,
 | |
| 		 PangoFont        *font,
 | |
| 		 gint              x,
 | |
| 		 gint              y,
 | |
| 		 PangoGlyphString *glyphs)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
|   
 | |
|   real_draw_glyphs (drawable, gc, NULL, font,
 | |
| 		    x, y, glyphs);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_glyphs_transformed:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @gc: a #GdkGC
 | |
|  * @matrix: a #PangoMatrix, or %NULL to use an identity transformation
 | |
|  * @font: the font in which to draw the string
 | |
|  * @x:       the x position of the start of the string (in Pango
 | |
|  *           units in user space coordinates)
 | |
|  * @y:       the y position of the baseline (in Pango units
 | |
|  *           in user space coordinates)
 | |
|  * @glyphs:  the glyph string to draw
 | |
|  * 
 | |
|  * Renders a #PangoGlyphString onto a drawable, possibly
 | |
|  * transforming the layed-out coordinates through a transformation
 | |
|  * matrix. Note that the transformation matrix for @font is not
 | |
|  * changed, so to produce correct rendering results, the @font
 | |
|  * must have been loaded using a #PangoContext with an identical
 | |
|  * transformation matrix to that passed in to this function.
 | |
|  *
 | |
|  * See also gdk_draw_glyphs(), gdk_draw_layout().
 | |
|  *
 | |
|  * Since: 2.6
 | |
|  **/
 | |
| void
 | |
| gdk_draw_glyphs_transformed (GdkDrawable       *drawable,
 | |
| 			     GdkGC	       *gc,
 | |
| 			     const PangoMatrix *matrix,
 | |
| 			     PangoFont         *font,
 | |
| 			     gint               x,
 | |
| 			     gint               y,
 | |
| 			     PangoGlyphString  *glyphs)
 | |
| {
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
| 
 | |
|   real_draw_glyphs (drawable, gc, matrix, font,
 | |
| 		    x / PANGO_SCALE, y / PANGO_SCALE, glyphs);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_draw_trapezoids:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @gc: a #GdkGC
 | |
|  * @trapezoids: an array of #GdkTrapezoid structures
 | |
|  * @n_trapezoids: the number of trapezoids to draw
 | |
|  * 
 | |
|  * Draws a set of anti-aliased trapezoids. The trapezoids are
 | |
|  * combined using saturation addition, then drawn over the background
 | |
|  * as a set. This is low level functionality used internally to implement
 | |
|  * rotated underlines and backgrouds when rendering a PangoLayout and is
 | |
|  * likely not useful for applications.
 | |
|  *
 | |
|  * Since: 2.6
 | |
|  **/
 | |
| void
 | |
| gdk_draw_trapezoids (GdkDrawable        *drawable,
 | |
| 		     GdkGC	        *gc,
 | |
| 		     const GdkTrapezoid *trapezoids,
 | |
| 		     gint                n_trapezoids)
 | |
| {
 | |
|   cairo_t *cr;
 | |
|   int i;
 | |
| 
 | |
|   g_return_if_fail (GDK_IS_DRAWABLE (drawable));
 | |
|   g_return_if_fail (GDK_IS_GC (gc));
 | |
|   g_return_if_fail (n_trapezoids == 0 || trapezoids != NULL);
 | |
| 
 | |
|   cr = gdk_cairo_create (drawable);
 | |
|   _gdk_gc_update_context (gc, cr, NULL, NULL, TRUE);
 | |
|   
 | |
|   for (i = 0; i < n_trapezoids; i++)
 | |
|     {
 | |
|       cairo_move_to (cr, trapezoids[i].x11, trapezoids[i].y1);
 | |
|       cairo_line_to (cr, trapezoids[i].x21, trapezoids[i].y1);
 | |
|       cairo_line_to (cr, trapezoids[i].x22, trapezoids[i].y2);
 | |
|       cairo_line_to (cr, trapezoids[i].x12, trapezoids[i].y2);
 | |
|       cairo_close_path (cr);
 | |
|     }
 | |
| 
 | |
|   cairo_fill (cr);
 | |
| 
 | |
|   cairo_destroy (cr);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_copy_to_image:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @image: a #GdkDrawable, or %NULL if a new @image should be created.
 | |
|  * @src_x: x coordinate on @drawable
 | |
|  * @src_y: y coordinate on @drawable
 | |
|  * @dest_x: x coordinate within @image. Must be 0 if @image is %NULL
 | |
|  * @dest_y: y coordinate within @image. Must be 0 if @image is %NULL
 | |
|  * @width: width of region to get
 | |
|  * @height: height or region to get
 | |
|  *
 | |
|  * Copies a portion of @drawable into the client side image structure
 | |
|  * @image. If @image is %NULL, creates a new image of size @width x @height
 | |
|  * and copies into that. See gdk_drawable_get_image() for further details.
 | |
|  * 
 | |
|  * Return value: @image, or a new a #GdkImage containing the contents
 | |
|  *               of @drawable
 | |
|  * 
 | |
|  * Since: 2.4
 | |
|  **/
 | |
| GdkImage*
 | |
| gdk_drawable_copy_to_image (GdkDrawable *drawable,
 | |
| 			    GdkImage    *image,
 | |
| 			    gint         src_x,
 | |
| 			    gint         src_y,
 | |
| 			    gint         dest_x,
 | |
| 			    gint         dest_y,
 | |
| 			    gint         width,
 | |
| 			    gint         height)
 | |
| {
 | |
|   GdkDrawable *composite;
 | |
|   gint composite_x_offset = 0;
 | |
|   gint composite_y_offset = 0;
 | |
|   GdkImage *retval;
 | |
|   GdkColormap *cmap;
 | |
|   
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
|   g_return_val_if_fail (src_x >= 0, NULL);
 | |
|   g_return_val_if_fail (src_y >= 0, NULL);
 | |
| 
 | |
|   /* FIXME? Note race condition since we get the size then
 | |
|    * get the image, and the size may have changed.
 | |
|    */
 | |
|   
 | |
|   if (width < 0 || height < 0)
 | |
|     gdk_drawable_get_size (drawable,
 | |
|                            width < 0 ? &width : NULL,
 | |
|                            height < 0 ? &height : NULL);
 | |
|   
 | |
|   composite =
 | |
|     GDK_DRAWABLE_GET_CLASS (drawable)->get_composite_drawable (drawable,
 | |
|                                                                src_x, src_y,
 | |
|                                                                width, height,
 | |
|                                                                &composite_x_offset,
 | |
|                                                                &composite_y_offset); 
 | |
|   
 | |
|   retval = GDK_DRAWABLE_GET_CLASS (composite)->_copy_to_image (composite,
 | |
| 							       image,
 | |
| 							       src_x - composite_x_offset,
 | |
| 							       src_y - composite_y_offset,
 | |
| 							       dest_x, dest_y,
 | |
| 							       width, height);
 | |
| 
 | |
|   g_object_unref (composite);
 | |
| 
 | |
|   if (!image && retval)
 | |
|     {
 | |
|       cmap = gdk_drawable_get_colormap (drawable);
 | |
|       
 | |
|       if (cmap)
 | |
| 	gdk_image_set_colormap (retval, cmap);
 | |
|     }
 | |
|   
 | |
|   return retval;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_image:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * @x: x coordinate on @drawable
 | |
|  * @y: y coordinate on @drawable
 | |
|  * @width: width of region to get
 | |
|  * @height: height or region to get
 | |
|  * 
 | |
|  * A #GdkImage stores client-side image data (pixels). In contrast,
 | |
|  * #GdkPixmap and #GdkWindow are server-side
 | |
|  * objects. gdk_drawable_get_image() obtains the pixels from a
 | |
|  * server-side drawable as a client-side #GdkImage.  The format of a
 | |
|  * #GdkImage depends on the #GdkVisual of the current display, which
 | |
|  * makes manipulating #GdkImage extremely difficult; therefore, in
 | |
|  * most cases you should use gdk_pixbuf_get_from_drawable() instead of
 | |
|  * this lower-level function. A #GdkPixbuf contains image data in a
 | |
|  * canonicalized RGB format, rather than a display-dependent format.
 | |
|  * Of course, there's a convenience vs. speed tradeoff here, so you'll
 | |
|  * want to think about what makes sense for your application.
 | |
|  *
 | |
|  * @x, @y, @width, and @height define the region of @drawable to
 | |
|  * obtain as an image.
 | |
|  *
 | |
|  * You would usually copy image data to the client side if you intend
 | |
|  * to examine the values of individual pixels, for example to darken
 | |
|  * an image or add a red tint. It would be prohibitively slow to
 | |
|  * make a round-trip request to the windowing system for each pixel,
 | |
|  * so instead you get all of them at once, modify them, then copy
 | |
|  * them all back at once.
 | |
|  *
 | |
|  * If the X server or other windowing system backend is on the local
 | |
|  * machine, this function may use shared memory to avoid copying
 | |
|  * the image data.
 | |
|  *
 | |
|  * If the source drawable is a #GdkWindow and partially offscreen
 | |
|  * or obscured, then the obscured portions of the returned image
 | |
|  * will contain undefined data.
 | |
|  * 
 | |
|  * Return value: a #GdkImage containing the contents of @drawable
 | |
|  **/
 | |
| GdkImage*
 | |
| gdk_drawable_get_image (GdkDrawable *drawable,
 | |
|                         gint         x,
 | |
|                         gint         y,
 | |
|                         gint         width,
 | |
|                         gint         height)
 | |
| {
 | |
|   GdkDrawable *composite;
 | |
|   gint composite_x_offset = 0;
 | |
|   gint composite_y_offset = 0;
 | |
|   GdkImage *retval;
 | |
|   GdkColormap *cmap;
 | |
|   
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
|   g_return_val_if_fail (x >= 0, NULL);
 | |
|   g_return_val_if_fail (y >= 0, NULL);
 | |
| 
 | |
|   /* FIXME? Note race condition since we get the size then
 | |
|    * get the image, and the size may have changed.
 | |
|    */
 | |
|   
 | |
|   if (width < 0 || height < 0)
 | |
|     gdk_drawable_get_size (drawable,
 | |
|                            width < 0 ? &width : NULL,
 | |
|                            height < 0 ? &height : NULL);
 | |
|   
 | |
|   composite =
 | |
|     GDK_DRAWABLE_GET_CLASS (drawable)->get_composite_drawable (drawable,
 | |
|                                                                x, y,
 | |
|                                                                width, height,
 | |
|                                                                &composite_x_offset,
 | |
|                                                                &composite_y_offset); 
 | |
|   
 | |
|   retval = GDK_DRAWABLE_GET_CLASS (composite)->get_image (composite,
 | |
|                                                           x - composite_x_offset,
 | |
|                                                           y - composite_y_offset,
 | |
|                                                           width, height);
 | |
| 
 | |
|   g_object_unref (composite);
 | |
| 
 | |
|   cmap = gdk_drawable_get_colormap (drawable);
 | |
|   
 | |
|   if (retval && cmap)
 | |
|     gdk_image_set_colormap (retval, cmap);
 | |
|   
 | |
|   return retval;
 | |
| }
 | |
| 
 | |
| static GdkImage*
 | |
| gdk_drawable_real_get_image (GdkDrawable     *drawable,
 | |
| 			     gint             x,
 | |
| 			     gint             y,
 | |
| 			     gint             width,
 | |
| 			     gint             height)
 | |
| {
 | |
|   return gdk_drawable_copy_to_image (drawable, NULL, x, y, 0, 0, width, height);
 | |
| }
 | |
| 
 | |
| static GdkDrawable*
 | |
| gdk_drawable_real_get_composite_drawable (GdkDrawable *drawable,
 | |
|                                           gint         x,
 | |
|                                           gint         y,
 | |
|                                           gint         width,
 | |
|                                           gint         height,
 | |
|                                           gint        *composite_x_offset,
 | |
|                                           gint        *composite_y_offset)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
| 
 | |
|   *composite_x_offset = 0;
 | |
|   *composite_y_offset = 0;
 | |
|   
 | |
|   return g_object_ref (drawable);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_clip_region:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Computes the region of a drawable that potentially can be written
 | |
|  * to by drawing primitives. This region will not take into account
 | |
|  * the clip region for the GC, and may also not take into account
 | |
|  * other factors such as if the window is obscured by other windows,
 | |
|  * but no area outside of this region will be affected by drawing
 | |
|  * primitives.
 | |
|  * 
 | |
|  * Returns: a #GdkRegion. This must be freed with gdk_region_destroy()
 | |
|  *          when you are done.
 | |
|  **/
 | |
| GdkRegion *
 | |
| gdk_drawable_get_clip_region (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
| 
 | |
|   return GDK_DRAWABLE_GET_CLASS (drawable)->get_clip_region (drawable);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * gdk_drawable_get_visible_region:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Computes the region of a drawable that is potentially visible.
 | |
|  * This does not necessarily take into account if the window is
 | |
|  * obscured by other windows, but no area outside of this region
 | |
|  * is visible.
 | |
|  * 
 | |
|  * Returns: a #GdkRegion. This must be freed with gdk_region_destroy()
 | |
|  *          when you are done.
 | |
|  **/
 | |
| GdkRegion *
 | |
| gdk_drawable_get_visible_region (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
| 
 | |
|   return GDK_DRAWABLE_GET_CLASS (drawable)->get_visible_region (drawable);
 | |
| }
 | |
| 
 | |
| static GdkRegion *
 | |
| gdk_drawable_real_get_visible_region (GdkDrawable *drawable)
 | |
| {
 | |
|   GdkRectangle rect;
 | |
| 
 | |
|   rect.x = 0;
 | |
|   rect.y = 0;
 | |
| 
 | |
|   gdk_drawable_get_size (drawable, &rect.width, &rect.height);
 | |
| 
 | |
|   return gdk_region_rectangle (&rect);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * _gdk_drawable_ref_cairo_surface:
 | |
|  * @drawable: a #GdkDrawable
 | |
|  * 
 | |
|  * Obtains a #cairo_surface_t for the given drawable. If a
 | |
|  * #cairo_surface_t for the drawable already exists, it will be
 | |
|  * referenced, otherwise a new surface will be created.
 | |
|  * 
 | |
|  * Return value: a newly referenced #cairo_surface_t that points
 | |
|  *  to @drawable. Unref with cairo_surface_destroy()
 | |
|  **/
 | |
| cairo_surface_t *
 | |
| _gdk_drawable_ref_cairo_surface (GdkDrawable *drawable)
 | |
| {
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
| 
 | |
|   return GDK_DRAWABLE_GET_CLASS (drawable)->ref_cairo_surface (drawable);
 | |
| }
 | |
| 
 | |
| static void
 | |
| composite (guchar *src_buf,
 | |
| 	   gint    src_rowstride,
 | |
| 	   guchar *dest_buf,
 | |
| 	   gint    dest_rowstride,
 | |
| 	   gint    width,
 | |
| 	   gint    height)
 | |
| {
 | |
|   guchar *src = src_buf;
 | |
|   guchar *dest = dest_buf;
 | |
| 
 | |
|   while (height--)
 | |
|     {
 | |
|       gint twidth = width;
 | |
|       guchar *p = src;
 | |
|       guchar *q = dest;
 | |
| 
 | |
|       while (twidth--)
 | |
| 	{
 | |
| 	  guchar a = p[3];
 | |
| 	  guint t;
 | |
| 
 | |
| 	  t = a * p[0] + (255 - a) * q[0] + 0x80;
 | |
| 	  q[0] = (t + (t >> 8)) >> 8;
 | |
| 	  t = a * p[1] + (255 - a) * q[1] + 0x80;
 | |
| 	  q[1] = (t + (t >> 8)) >> 8;
 | |
| 	  t = a * p[2] + (255 - a) * q[2] + 0x80;
 | |
| 	  q[2] = (t + (t >> 8)) >> 8;
 | |
| 
 | |
| 	  p += 4;
 | |
| 	  q += 3;
 | |
| 	}
 | |
|       
 | |
|       src += src_rowstride;
 | |
|       dest += dest_rowstride;
 | |
|     }
 | |
| }
 | |
| 
 | |
| static void
 | |
| composite_0888 (guchar      *src_buf,
 | |
| 		gint         src_rowstride,
 | |
| 		guchar      *dest_buf,
 | |
| 		gint         dest_rowstride,
 | |
| 		GdkByteOrder dest_byte_order,
 | |
| 		gint         width,
 | |
| 		gint         height)
 | |
| {
 | |
|   guchar *src = src_buf;
 | |
|   guchar *dest = dest_buf;
 | |
| 
 | |
|   while (height--)
 | |
|     {
 | |
|       gint twidth = width;
 | |
|       guchar *p = src;
 | |
|       guchar *q = dest;
 | |
| 
 | |
|       if (dest_byte_order == GDK_LSB_FIRST)
 | |
| 	{
 | |
| 	  while (twidth--)
 | |
| 	    {
 | |
| 	      guint t;
 | |
| 	      
 | |
| 	      t = p[3] * p[2] + (255 - p[3]) * q[0] + 0x80;
 | |
| 	      q[0] = (t + (t >> 8)) >> 8;
 | |
| 	      t = p[3] * p[1] + (255 - p[3]) * q[1] + 0x80;
 | |
| 	      q[1] = (t + (t >> 8)) >> 8;
 | |
| 	      t = p[3] * p[0] + (255 - p[3]) * q[2] + 0x80;
 | |
| 	      q[2] = (t + (t >> 8)) >> 8;
 | |
| 	      p += 4;
 | |
| 	      q += 4;
 | |
| 	    }
 | |
| 	}
 | |
|       else
 | |
| 	{
 | |
| 	  while (twidth--)
 | |
| 	    {
 | |
| 	      guint t;
 | |
| 	      
 | |
| 	      t = p[3] * p[0] + (255 - p[3]) * q[1] + 0x80;
 | |
| 	      q[1] = (t + (t >> 8)) >> 8;
 | |
| 	      t = p[3] * p[1] + (255 - p[3]) * q[2] + 0x80;
 | |
| 	      q[2] = (t + (t >> 8)) >> 8;
 | |
| 	      t = p[3] * p[2] + (255 - p[3]) * q[3] + 0x80;
 | |
| 	      q[3] = (t + (t >> 8)) >> 8;
 | |
| 	      p += 4;
 | |
| 	      q += 4;
 | |
| 	    }
 | |
| 	}
 | |
|       
 | |
|       src += src_rowstride;
 | |
|       dest += dest_rowstride;
 | |
|     }
 | |
| }
 | |
| 
 | |
| #ifdef USE_MEDIALIB
 | |
| static void
 | |
| composite_0888_medialib (guchar      *src_buf,
 | |
| 			 gint         src_rowstride,
 | |
| 			 guchar      *dest_buf,
 | |
| 			 gint         dest_rowstride,
 | |
| 			 GdkByteOrder dest_byte_order,
 | |
| 			 gint         width,
 | |
| 			 gint         height)
 | |
| {
 | |
|   guchar *src  = src_buf;
 | |
|   guchar *dest = dest_buf;
 | |
| 
 | |
|   mlib_image img_src, img_dst;
 | |
| 
 | |
|   mlib_ImageSetStruct (&img_dst,
 | |
|                        MLIB_BYTE,
 | |
|                        4,
 | |
|                        width,
 | |
|                        height,
 | |
|                        dest_rowstride,
 | |
|                        dest_buf);
 | |
| 
 | |
|   mlib_ImageSetStruct (&img_src,
 | |
|                        MLIB_BYTE,
 | |
|                        4,
 | |
|                        width,
 | |
|                        height,
 | |
|                        src_rowstride,
 | |
|                        src_buf);
 | |
| 
 | |
|   if (dest_byte_order == GDK_LSB_FIRST)
 | |
|       mlib_ImageBlendRGBA2BGRA (&img_dst, &img_src);
 | |
|   else
 | |
|       mlib_ImageBlendRGBA2ARGB (&img_dst, &img_src);
 | |
| }
 | |
| #endif
 | |
| 
 | |
| static void
 | |
| composite_565 (guchar      *src_buf,
 | |
| 	       gint         src_rowstride,
 | |
| 	       guchar      *dest_buf,
 | |
| 	       gint         dest_rowstride,
 | |
| 	       GdkByteOrder dest_byte_order,
 | |
| 	       gint         width,
 | |
| 	       gint         height)
 | |
| {
 | |
|   guchar *src = src_buf;
 | |
|   guchar *dest = dest_buf;
 | |
| 
 | |
|   while (height--)
 | |
|     {
 | |
|       gint twidth = width;
 | |
|       guchar *p = src;
 | |
|       gushort *q = (gushort *)dest;
 | |
| 
 | |
|       while (twidth--)
 | |
| 	{
 | |
| 	  guchar a = p[3];
 | |
| 	  guint tr, tg, tb;
 | |
| 	  guint tr1, tg1, tb1;
 | |
| 	  guint tmp = *q;
 | |
| 
 | |
| #if 1
 | |
| 	  /* This is fast, and corresponds to what composite() above does
 | |
| 	   * if we converted to 8-bit first.
 | |
| 	   */
 | |
| 	  tr = (tmp & 0xf800);
 | |
| 	  tr1 = a * p[0] + (255 - a) * ((tr >> 8) + (tr >> 13)) + 0x80;
 | |
| 	  tg = (tmp & 0x07e0);
 | |
| 	  tg1 = a * p[1] + (255 - a) * ((tg >> 3) + (tg >> 9)) + 0x80;
 | |
| 	  tb = (tmp & 0x001f);
 | |
| 	  tb1 = a * p[2] + (255 - a) * ((tb << 3) + (tb >> 2)) + 0x80;
 | |
| 
 | |
| 	  *q = (((tr1 + (tr1 >> 8)) & 0xf800) |
 | |
| 		(((tg1 + (tg1 >> 8)) & 0xfc00) >> 5)  |
 | |
| 		((tb1 + (tb1 >> 8)) >> 11));
 | |
| #else
 | |
| 	  /* This version correspond to the result we get with XRENDER -
 | |
| 	   * a bit of precision is lost since we convert to 8 bit after premultiplying
 | |
| 	   * instead of at the end
 | |
| 	   */
 | |
| 	  guint tr2, tg2, tb2;
 | |
| 	  guint tr3, tg3, tb3;
 | |
| 	  
 | |
| 	  tr = (tmp & 0xf800);
 | |
| 	  tr1 = (255 - a) * ((tr >> 8) + (tr >> 13)) + 0x80;
 | |
| 	  tr2 = a * p[0] + 0x80;
 | |
| 	  tr3 = ((tr1 + (tr1 >> 8)) >> 8) + ((tr2 + (tr2 >> 8)) >> 8);
 | |
| 
 | |
| 	  tg = (tmp & 0x07e0);
 | |
| 	  tg1 = (255 - a) * ((tg >> 3) + (tg >> 9)) + 0x80;
 | |
| 	  tg2 = a * p[0] + 0x80;
 | |
| 	  tg3 = ((tg1 + (tg1 >> 8)) >> 8) + ((tg2 + (tg2 >> 8)) >> 8);
 | |
| 
 | |
| 	  tb = (tmp & 0x001f);
 | |
| 	  tb1 = (255 - a) * ((tb << 3) + (tb >> 2)) + 0x80;
 | |
| 	  tb2 = a * p[0] + 0x80;
 | |
| 	  tb3 = ((tb1 + (tb1 >> 8)) >> 8) + ((tb2 + (tb2 >> 8)) >> 8);
 | |
| 
 | |
| 	  *q = (((tr3 & 0xf8) << 8) |
 | |
| 		((tg3 & 0xfc) << 3) |
 | |
| 		((tb3 >> 3)));
 | |
| #endif
 | |
| 	  
 | |
| 	  p += 4;
 | |
| 	  q++;
 | |
| 	}
 | |
|       
 | |
|       src += src_rowstride;
 | |
|       dest += dest_rowstride;
 | |
|     }
 | |
| }
 | |
| 
 | |
| static void
 | |
| gdk_drawable_real_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)
 | |
| {
 | |
|   GdkPixbuf *composited = NULL;
 | |
|   gint dwidth, dheight;
 | |
|   GdkRegion *clip;
 | |
|   GdkRegion *drect;
 | |
|   GdkRectangle tmp_rect;
 | |
| 
 | |
|   g_return_if_fail (GDK_IS_PIXBUF (pixbuf));
 | |
|   g_return_if_fail (pixbuf->colorspace == GDK_COLORSPACE_RGB);
 | |
|   g_return_if_fail (pixbuf->n_channels == 3 || pixbuf->n_channels == 4);
 | |
|   g_return_if_fail (pixbuf->bits_per_sample == 8);
 | |
| 
 | |
|   g_return_if_fail (drawable != NULL);
 | |
| 
 | |
|   if (width == -1) 
 | |
|     width = pixbuf->width;
 | |
|   if (height == -1)
 | |
|     height = pixbuf->height;
 | |
| 
 | |
|   g_return_if_fail (width >= 0 && height >= 0);
 | |
|   g_return_if_fail (src_x >= 0 && src_x + width <= pixbuf->width);
 | |
|   g_return_if_fail (src_y >= 0 && src_y + height <= pixbuf->height);
 | |
| 
 | |
|   /* Clip to the drawable; this is required for get_from_drawable() so
 | |
|    * can't be done implicitly
 | |
|    */
 | |
|   
 | |
|   if (dest_x < 0)
 | |
|     {
 | |
|       src_x -= dest_x;
 | |
|       width += dest_x;
 | |
|       dest_x = 0;
 | |
|     }
 | |
| 
 | |
|   if (dest_y < 0)
 | |
|     {
 | |
|       src_y -= dest_y;
 | |
|       height += dest_y;
 | |
|       dest_y = 0;
 | |
|     }
 | |
| 
 | |
|   gdk_drawable_get_size (drawable, &dwidth, &dheight);
 | |
| 
 | |
|   if ((dest_x + width) > dwidth)
 | |
|     width = dwidth - dest_x;
 | |
| 
 | |
|   if ((dest_y + height) > dheight)
 | |
|     height = dheight - dest_y;
 | |
| 
 | |
|   if (width <= 0 || height <= 0)
 | |
|     return;
 | |
| 
 | |
|   /* Clip to the clip region; this avoids getting more
 | |
|    * image data from the server than we need to.
 | |
|    */
 | |
|   
 | |
|   tmp_rect.x = dest_x;
 | |
|   tmp_rect.y = dest_y;
 | |
|   tmp_rect.width = width;
 | |
|   tmp_rect.height = height;
 | |
| 
 | |
|   drect = gdk_region_rectangle (&tmp_rect);
 | |
|   clip = gdk_drawable_get_clip_region (drawable);
 | |
| 
 | |
|   gdk_region_intersect (drect, clip);
 | |
| 
 | |
|   gdk_region_get_clipbox (drect, &tmp_rect);
 | |
|   
 | |
|   gdk_region_destroy (drect);
 | |
|   gdk_region_destroy (clip);
 | |
| 
 | |
|   if (tmp_rect.width == 0 ||
 | |
|       tmp_rect.height == 0)
 | |
|     return;
 | |
|   
 | |
|   /* Actually draw */
 | |
|   if (!gc)
 | |
|     gc = _gdk_drawable_get_scratch_gc (drawable, FALSE);
 | |
|   
 | |
|   if (pixbuf->has_alpha)
 | |
|     {
 | |
|       GdkVisual *visual = gdk_drawable_get_visual (drawable);
 | |
|       void (*composite_func) (guchar       *src_buf,
 | |
| 			      gint          src_rowstride,
 | |
| 			      guchar       *dest_buf,
 | |
| 			      gint          dest_rowstride,
 | |
| 			      GdkByteOrder  dest_byte_order,
 | |
| 			      gint          width,
 | |
| 			      gint          height) = NULL;
 | |
| 
 | |
|       /* First we see if we have a visual-specific composition function that can composite
 | |
|        * the pixbuf data directly onto the image
 | |
|        */
 | |
|       if (visual)
 | |
| 	{
 | |
| 	  gint bits_per_pixel = _gdk_windowing_get_bits_for_depth (gdk_drawable_get_display (drawable),
 | |
| 								   visual->depth);
 | |
| 	  
 | |
| 	  if (visual->byte_order == (G_BYTE_ORDER == G_BIG_ENDIAN ? GDK_MSB_FIRST : GDK_LSB_FIRST) &&
 | |
| 	      visual->depth == 16 &&
 | |
| 	      visual->red_mask   == 0xf800 &&
 | |
| 	      visual->green_mask == 0x07e0 &&
 | |
| 	      visual->blue_mask  == 0x001f)
 | |
| 	    composite_func = composite_565;
 | |
| 	  else if (visual->depth == 24 && bits_per_pixel == 32 &&
 | |
| 		   visual->red_mask   == 0xff0000 &&
 | |
| 		   visual->green_mask == 0x00ff00 &&
 | |
| 		   visual->blue_mask  == 0x0000ff)
 | |
| 	    {
 | |
| #ifdef USE_MEDIALIB
 | |
| 	      if (_gdk_use_medialib ())
 | |
| 	        composite_func = composite_0888_medialib;
 | |
| 	      else
 | |
| 	        composite_func = composite_0888;
 | |
| #else
 | |
| 	      composite_func = composite_0888;
 | |
| #endif
 | |
| 	    }
 | |
| 	}
 | |
| 
 | |
|       /* We can't use our composite func if we are required to dither
 | |
|        */
 | |
|       if (composite_func && !(dither == GDK_RGB_DITHER_MAX && visual->depth != 24))
 | |
| 	{
 | |
| 	  gint x0, y0;
 | |
| 	  for (y0 = 0; y0 < height; y0 += GDK_SCRATCH_IMAGE_HEIGHT)
 | |
| 	    {
 | |
| 	      gint height1 = MIN (height - y0, GDK_SCRATCH_IMAGE_HEIGHT);
 | |
| 	      for (x0 = 0; x0 < width; x0 += GDK_SCRATCH_IMAGE_WIDTH)
 | |
| 		{
 | |
| 		  gint xs0, ys0;
 | |
| 		  
 | |
| 		  gint width1 = MIN (width - x0, GDK_SCRATCH_IMAGE_WIDTH);
 | |
| 		  
 | |
| 		  GdkImage *image = _gdk_image_get_scratch (gdk_drawable_get_screen (drawable),
 | |
| 							    width1, height1,
 | |
| 							    gdk_drawable_get_depth (drawable), &xs0, &ys0);
 | |
| 		  
 | |
| 		  gdk_drawable_copy_to_image (drawable, image,
 | |
| 					      dest_x + x0, dest_y + y0,
 | |
| 					      xs0, ys0,
 | |
| 					      width1, height1);
 | |
| 		  (*composite_func) (pixbuf->pixels + (src_y + y0) * pixbuf->rowstride + (src_x + x0) * 4,
 | |
| 				     pixbuf->rowstride,
 | |
| 				     (guchar*)image->mem + ys0 * image->bpl + xs0 * image->bpp,
 | |
| 				     image->bpl,
 | |
| 				     visual->byte_order,
 | |
| 				     width1, height1);
 | |
| 		  gdk_draw_image (drawable, gc, image,
 | |
| 				  xs0, ys0,
 | |
| 				  dest_x + x0, dest_y + y0,
 | |
| 				  width1, height1);
 | |
| 		}
 | |
| 	    }
 | |
| 	  
 | |
| 	  goto out;
 | |
| 	}
 | |
|       else
 | |
| 	{
 | |
| 	  /* No special composition func, convert dest to 24 bit RGB data, composite against
 | |
| 	   * that, and convert back.
 | |
| 	   */
 | |
| 	  composited = gdk_pixbuf_get_from_drawable (NULL,
 | |
| 						     drawable,
 | |
| 						     NULL,
 | |
| 						     dest_x, dest_y,
 | |
| 						     0, 0,
 | |
| 						     width, height);
 | |
| 	  
 | |
| 	  if (composited)
 | |
| 	    composite (pixbuf->pixels + src_y * pixbuf->rowstride + src_x * 4,
 | |
| 		       pixbuf->rowstride,
 | |
| 		       composited->pixels,
 | |
| 		       composited->rowstride,
 | |
| 		       width, height);
 | |
| 	}
 | |
|     }
 | |
| 
 | |
|   if (composited)
 | |
|     {
 | |
|       src_x = 0;
 | |
|       src_y = 0;
 | |
|       pixbuf = composited;
 | |
|     }
 | |
|   
 | |
|   if (pixbuf->n_channels == 4)
 | |
|     {
 | |
|       guchar *buf = pixbuf->pixels + src_y * pixbuf->rowstride + src_x * 4;
 | |
| 
 | |
|       gdk_draw_rgb_32_image_dithalign (drawable, gc,
 | |
| 				       dest_x, dest_y,
 | |
| 				       width, height,
 | |
| 				       dither,
 | |
| 				       buf, pixbuf->rowstride,
 | |
| 				       x_dither, y_dither);
 | |
|     }
 | |
|   else				/* n_channels == 3 */
 | |
|     {
 | |
|       guchar *buf = pixbuf->pixels + src_y * pixbuf->rowstride + src_x * 3;
 | |
| 
 | |
|       gdk_draw_rgb_image_dithalign (drawable, gc,
 | |
| 				    dest_x, dest_y,
 | |
| 				    width, height,
 | |
| 				    dither,
 | |
| 				    buf, pixbuf->rowstride,
 | |
| 				    x_dither, y_dither);
 | |
|     }
 | |
| 
 | |
|  out:
 | |
|   if (composited)
 | |
|     g_object_unref (composited);
 | |
| }
 | |
| 
 | |
| /************************************************************************/
 | |
| 
 | |
| /**
 | |
|  * _gdk_drawable_get_scratch_gc:
 | |
|  * @drawable: A #GdkDrawable
 | |
|  * @graphics_exposures: Whether the returned #GdkGC should generate graphics exposures 
 | |
|  * 
 | |
|  * Returns a #GdkGC suitable for drawing on @drawable. The #GdkGC has
 | |
|  * the standard values for @drawable, except for the graphics_exposures
 | |
|  * field which is determined by the @graphics_exposures parameter.
 | |
|  *
 | |
|  * The foreground color of the returned #GdkGC is undefined. The #GdkGC
 | |
|  * must not be altered in any way, except to change its foreground color.
 | |
|  * 
 | |
|  * Return value: A #GdkGC suitable for drawing on @drawable
 | |
|  * 
 | |
|  * Since: 2.4
 | |
|  **/
 | |
| GdkGC *
 | |
| _gdk_drawable_get_scratch_gc (GdkDrawable *drawable,
 | |
| 			      gboolean     graphics_exposures)
 | |
| {
 | |
|   GdkScreen *screen;
 | |
|   gint depth;
 | |
| 
 | |
|   g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
 | |
| 
 | |
|   screen = gdk_drawable_get_screen (drawable);
 | |
| 
 | |
|   g_return_val_if_fail (!screen->closed, NULL);
 | |
| 
 | |
|   depth = gdk_drawable_get_depth (drawable) - 1;
 | |
| 
 | |
|   if (graphics_exposures)
 | |
|     {
 | |
|       if (!screen->exposure_gcs[depth])
 | |
| 	{
 | |
| 	  GdkGCValues values;
 | |
| 	  GdkGCValuesMask mask;
 | |
| 
 | |
| 	  values.graphics_exposures = TRUE;
 | |
| 	  mask = GDK_GC_EXPOSURES;  
 | |
| 
 | |
| 	  screen->exposure_gcs[depth] =
 | |
| 	    gdk_gc_new_with_values (drawable, &values, mask);
 | |
| 	}
 | |
| 
 | |
|       return screen->exposure_gcs[depth];
 | |
|     }
 | |
|   else
 | |
|     {
 | |
|       if (!screen->normal_gcs[depth])
 | |
| 	{
 | |
| 	  screen->normal_gcs[depth] =
 | |
| 	    gdk_gc_new (drawable);
 | |
| 	}
 | |
| 
 | |
|       return screen->normal_gcs[depth];
 | |
|     }
 | |
| }
 | |
| 
 | |
| #define __GDK_DRAW_C__
 | |
| #include "gdkaliasdef.c"
 |