diff options
| author | Havoc Pennington <hp@pobox.com> | 2001-02-20 05:21:44 +0000 |
|---|---|---|
| committer | Havoc Pennington <hp@src.gnome.org> | 2001-02-20 05:21:44 +0000 |
| commit | 50b1ab41182a7b421c31023d3f46860f623b1a25 (patch) | |
| tree | d80ee0ad68c810d6ca475f936105e4e588baaabc /gdk/gdkregion-generic.c | |
| parent | 131aac575f648e776d4f98c96d1d71d4a4b21ee7 (diff) | |
| download | gtk+-50b1ab41182a7b421c31023d3f46860f623b1a25.tar.gz | |
add --deprecated-guards
2001-02-19 Havoc Pennington <hp@pobox.com>
* gdk/Makefile.am (SCAN_OPTIONS): add --deprecated-guards
* gdk/gdk-sections.txt: update
* gdk/gdk-docs.sgml: update
2001-02-19 Havoc Pennington <hp@pobox.com>
* gdk/gdkwindow.c: docs
* gdk/gdkrgb.c: docs
* gdk/gdkregion-generic.c: docs
* gdk/gdkgc.c (gdk_gc_set_values): docs
* gdk/gdkdraw.c: docs
* gdk/gdkdrawable.h: deprecate drawable get/set data
Diffstat (limited to 'gdk/gdkregion-generic.c')
| -rw-r--r-- | gdk/gdkregion-generic.c | 59 |
1 files changed, 45 insertions, 14 deletions
diff --git a/gdk/gdkregion-generic.c b/gdk/gdkregion-generic.c index e68c09dcfe..b049fc0358 100644 --- a/gdk/gdkregion-generic.c +++ b/gdk/gdkregion-generic.c @@ -123,6 +123,14 @@ gdk_region_new () return temp; } +/** + * gdk_region_rectangle: + * @rectangle: a #GdkRectangle + * + * Creates a new region containing the area @rectangle. + * + * Return value: a new region + **/ GdkRegion * gdk_region_rectangle (GdkRectangle *rectangle) { @@ -144,6 +152,14 @@ gdk_region_rectangle (GdkRectangle *rectangle) return temp; } +/** + * gdk_region_copy: + * @region: a #GdkRegion + * + * Copies @region, creating an identical new region. + * + * Return value: a new region identical to @region + **/ GdkRegion * gdk_region_copy (GdkRegion *region) { @@ -456,6 +472,16 @@ miIntersectO (GdkRegion *pReg, } } +/** + * gdk_region_intersect: + * @source1: a #GdkRegion + * @source2: another #GdkRegion + * + * Converts @source1 into the intersection between @source1 and @source2. + * That is, after calling this function @source2 will be unchanged and + * @source1 will be the areas the two regions have in common. + * + **/ void gdk_region_intersect (GdkRegion *region, GdkRegion *other) @@ -1310,21 +1336,15 @@ miSubtractO (GdkRegion *pReg, } } } - -/*- - *----------------------------------------------------------------------- - * gdk_region_subtract -- - * Subtract other from region and leave the result in region. - * - * Results: - * TRUE. - * - * Side Effects: - * region is overwritten. - * - *----------------------------------------------------------------------- - */ +/** + * gdk_region_subtract: + * @source1: a #GdkRegion + * @source2: another #GdkRegion + * + * Subtracts any area in @source2 from the area in @source1. + * + **/ void gdk_region_subtract (GdkRegion *region, GdkRegion *other) @@ -1346,6 +1366,17 @@ gdk_region_subtract (GdkRegion *region, miSetExtents (region); } +/** + * gdk_region_xor: + * @source1: a #GdkRegion + * @source2: another #GdkRegion + * + * XORs the two regions, placing the result in @source1. The XOR of two + * regions contains all areas which were not overlapping. That is, + * it's the union of the regions minus the intersection of the + * regions. + * + **/ void gdk_region_xor (GdkRegion *sra, GdkRegion *srb) |