]> Pileus Git - ~andy/gtk/blob - gdk/gdkrectangle.c
Note in docs that @dest's width and height is set to 0, 0 if the
[~andy/gtk] / gdk / gdkrectangle.c
1 /* GDK - The GIMP Drawing Kit
2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the
16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17  * Boston, MA 02111-1307, USA.
18  */
19
20 /*
21  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
22  * file for a list of people on the GTK+ Team.  See the ChangeLog
23  * files for a list of changes.  These files are distributed with
24  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
25  */
26
27 #include <config.h>
28 #include <gdk/gdk.h>
29 #include "gdkalias.h"
30
31 /**
32  * gdk_rectangle_union:
33  * @src1: a #GdkRectangle
34  * @src2: a #GdkRectangle
35  * @dest: return location for the union of @src1 and @src2
36  *
37  * Calculates the union of two rectangles.
38  * The union of rectangles @src1 and @src2 is the smallest rectangle which
39  * includes both @src1 and @src2 within it.
40  * It is allowed for @dest to be the same as either @src1 or @src2.
41  */
42 void
43 gdk_rectangle_union (GdkRectangle *src1,
44                      GdkRectangle *src2,
45                      GdkRectangle *dest)
46 {
47   gint dest_x, dest_y;
48   
49   g_return_if_fail (src1 != NULL);
50   g_return_if_fail (src2 != NULL);
51   g_return_if_fail (dest != NULL);
52
53   dest_x = MIN (src1->x, src2->x);
54   dest_y = MIN (src1->y, src2->y);
55   dest->width = MAX (src1->x + src1->width, src2->x + src2->width) - dest_x;
56   dest->height = MAX (src1->y + src1->height, src2->y + src2->height) - dest_y;
57   dest->x = dest_x;
58   dest->y = dest_y;
59 }
60
61 /**
62  * gdk_rectangle_intersect:
63  * @src1: a #GdkRectangle
64  * @src2: a #GdkRectangle
65  * @dest: return location for the intersection of @src1 and @src2
66  *
67  * Calculates the intersection of two rectangles. It is allowed for
68  * @dest to be the same as either @src1 or @src2. If the rectangles
69  * doesn't intersect, @dest's width and height is set to 0 and its x
70  * and y values are undefined.
71  *
72  * Returns: %TRUE if the rectangles intersect.
73  */
74 gboolean
75 gdk_rectangle_intersect (GdkRectangle *src1,
76                          GdkRectangle *src2,
77                          GdkRectangle *dest)
78 {
79   gint dest_x, dest_y;
80   gint dest_w, dest_h;
81   gint return_val;
82
83   g_return_val_if_fail (src1 != NULL, FALSE);
84   g_return_val_if_fail (src2 != NULL, FALSE);
85   g_return_val_if_fail (dest != NULL, FALSE);
86
87   return_val = FALSE;
88
89   dest_x = MAX (src1->x, src2->x);
90   dest_y = MAX (src1->y, src2->y);
91   dest_w = MIN (src1->x + src1->width, src2->x + src2->width) - dest_x;
92   dest_h = MIN (src1->y + src1->height, src2->y + src2->height) - dest_y;
93
94   if (dest_w > 0 && dest_h > 0)
95     {
96       dest->x = dest_x;
97       dest->y = dest_y;
98       dest->width = dest_w;
99       dest->height = dest_h;
100       return_val = TRUE;
101     }
102   else
103     {
104       dest->width = 0;
105       dest->height = 0;
106     }
107
108   return return_val;
109 }
110
111 static GdkRectangle *
112 gdk_rectangle_copy (const GdkRectangle *rectangle)
113 {
114   GdkRectangle *result = g_new (GdkRectangle, 1);
115   *result = *rectangle;
116
117   return result;
118 }
119
120 GType
121 gdk_rectangle_get_type (void)
122 {
123   static GType our_type = 0;
124   
125   if (our_type == 0)
126     our_type = g_boxed_type_register_static (g_intern_static_string ("GdkRectangle"),
127                                              (GBoxedCopyFunc)gdk_rectangle_copy,
128                                              (GBoxedFreeFunc)g_free);
129   return our_type;
130 }
131
132
133 #define __GDK_RECTANGLE_C__
134 #include "gdkaliasdef.c"