]> Pileus Git - ~andy/gtk/commitdiff
API: Remove shape_combine_mask functions from gdk
authorBenjamin Otte <otte@redhat.com>
Sat, 14 Aug 2010 04:46:25 +0000 (06:46 +0200)
committerBenjamin Otte <otte@redhat.com>
Sun, 26 Sep 2010 13:02:59 +0000 (15:02 +0200)
This removes gdk_window_shape_combine_mask() and
gdk_window_input_shape_combine_mask(). GdkBitmap is going away and a
replacement exists via the combine_region() functions and
gdk_cairo_region_create_from_surface().

docs/reference/gdk/gdk3-sections.txt
gdk/gdk.symbols
gdk/gdkwindow.c
gdk/gdkwindow.h

index 0f4534ed2d0885c94e24b2fd12b0571a939a7fe1..f04d698d18b3ec33f9799d57af6a9a955918c230 100644 (file)
@@ -466,11 +466,9 @@ gdk_window_remove_filter
 GdkFilterFunc
 GdkFilterReturn
 GdkXEvent
-gdk_window_shape_combine_mask
 gdk_window_shape_combine_region
 gdk_window_set_child_shapes
 gdk_window_merge_child_shapes
-gdk_window_input_shape_combine_mask
 gdk_window_input_shape_combine_region
 gdk_window_set_child_input_shapes
 gdk_window_merge_child_input_shapes
index 9d048fe15c79e5e5a72d6846501f51a267299eea..e694ee28c549b0e1cc04bdf5466d5f268b19e42a 100644 (file)
@@ -594,11 +594,9 @@ gdk_window_has_native
 gdk_window_set_background
 gdk_window_set_back_pixmap
 gdk_window_set_cursor
-gdk_window_shape_combine_mask
 gdk_window_shape_combine_region
 gdk_window_set_child_shapes
 gdk_window_merge_child_shapes
-gdk_window_input_shape_combine_mask
 gdk_window_input_shape_combine_region
 gdk_window_set_child_input_shapes
 gdk_window_merge_child_input_shapes
index 339a935ce3eb552c0eac2eed77549cdaf0bc073a..8ac96356a0231f8d91dc20f196982bde0e60ceba 100644 (file)
@@ -7676,55 +7676,6 @@ gdk_window_coords_from_parent (GdkWindow *window,
     }
 }
 
-/**
- * gdk_window_shape_combine_mask:
- * @window: a #GdkWindow
- * @mask: shape mask
- * @x: X position of shape mask with respect to @window
- * @y: Y position of shape mask with respect to @window
- *
- * Applies a shape mask to @window. Pixels in @window corresponding to
- * set bits in the @mask will be visible; pixels in @window
- * corresponding to unset bits in the @mask will be transparent. This
- * gives a non-rectangular window.
- *
- * If @mask is %NULL, the shape mask will be unset, and the @x/@y
- * parameters are not used.
- *
- * On the X11 platform, this uses an X server extension which is
- * widely available on most common platforms, but not available on
- * very old X servers, and occasionally the implementation will be
- * buggy. On servers without the shape extension, this function
- * will do nothing.
- *
- * This function works on both toplevel and child windows.
- */
-void
-gdk_window_shape_combine_mask (GdkWindow *window,
-                              GdkBitmap *mask,
-                              gint       x,
-                              gint       y)
-{
-  GdkWindowObject *private;
-  cairo_region_t *region;
-
-  g_return_if_fail (GDK_IS_WINDOW (window));
-
-  private = (GdkWindowObject *) window;
-
-  if (mask)
-    region = _gdk_windowing_get_shape_for_mask (mask);
-  else
-    region = NULL;
-
-  gdk_window_shape_combine_region (window,
-                                  region,
-                                  x, y);
-
-  if (region)
-    cairo_region_destroy (region);
-}
-
 /**
  * gdk_window_shape_combine_region:
  * @window: a #GdkWindow
@@ -7733,8 +7684,7 @@ gdk_window_shape_combine_mask (GdkWindow *window,
  * @offset_y: Y position of @shape_region in @window coordinates
  *
  * Makes pixels in @window outside @shape_region be transparent,
- * so that the window may be nonrectangular. See also
- * gdk_window_shape_combine_mask() to use a bitmap as the mask.
+ * so that the window may be nonrectangular.
  *
  * If @shape_region is %NULL, the shape will be unset, so the whole
  * window will be opaque again. @offset_x and @offset_y are ignored
@@ -7866,7 +7816,7 @@ gdk_window_set_child_shapes (GdkWindow *window)
  * Merges the shape masks for any child windows into the
  * shape mask for @window. i.e. the union of all masks
  * for @window and its children will become the new mask
- * for @window. See gdk_window_shape_combine_mask().
+ * for @window. See gdk_window_shape_combine_region().
  *
  * This function is distinct from gdk_window_set_child_shapes()
  * because it includes @window's shape mask in the set of shapes to
@@ -7880,58 +7830,6 @@ gdk_window_merge_child_shapes (GdkWindow *window)
   do_child_shapes (window, TRUE);
 }
 
-/**
- * gdk_window_input_shape_combine_mask:
- * @window: a #GdkWindow
- * @mask: (allow-none): shape mask, or %NULL
- * @x: X position of shape mask with respect to @window
- * @y: Y position of shape mask with respect to @window
- *
- * Like gdk_window_shape_combine_mask(), but the shape applies
- * only to event handling. Mouse events which happen while
- * the pointer position corresponds to an unset bit in the
- * mask will be passed on the window below @window.
- *
- * An input shape is typically used with RGBA windows.
- * The alpha channel of the window defines which pixels are
- * invisible and allows for nicely antialiased borders,
- * and the input shape controls where the window is
- * "clickable".
- *
- * On the X11 platform, this requires version 1.1 of the
- * shape extension.
- *
- * On the Win32 platform, this functionality is not present and the
- * function does nothing.
- *
- * Since: 2.10
- */
-void
-gdk_window_input_shape_combine_mask (GdkWindow *window,
-                                    GdkBitmap *mask,
-                                    gint       x,
-                                    gint       y)
-{
-  GdkWindowObject *private;
-  cairo_region_t *region;
-
-  g_return_if_fail (GDK_IS_WINDOW (window));
-
-  private = (GdkWindowObject *) window;
-
-  if (mask)
-    region = _gdk_windowing_get_shape_for_mask (mask);
-  else
-    region = NULL;
-
-  gdk_window_input_shape_combine_region (window,
-                                        region,
-                                        x, y);
-
-  if (region != NULL)
-    cairo_region_destroy (region);
-}
-
 /**
  * gdk_window_input_shape_combine_region:
  * @window: a #GdkWindow
@@ -8048,7 +7946,7 @@ gdk_window_set_child_input_shapes (GdkWindow *window)
  * Merges the input shape masks for any child windows into the
  * input shape mask for @window. i.e. the union of all input masks
  * for @window and its children will become the new input mask
- * for @window. See gdk_window_input_shape_combine_mask().
+ * for @window. See gdk_window_input_shape_combine_region().
  *
  * This function is distinct from gdk_window_set_child_input_shapes()
  * because it includes @window's input shape mask in the set of
index 2724c05c207eaf823d7cf6cf581c8ab9660e0b44..6e44defd2a45df3090e6f351860b23d3e1f8f5a3 100644 (file)
@@ -575,10 +575,6 @@ gboolean      gdk_window_ensure_native        (GdkWindow       *window);
  * This allows for making shaped (partially transparent) windows
  * - cool feature, needed for Drag and Drag for example.
  */
-void gdk_window_shape_combine_mask  (GdkWindow       *window,
-                                     GdkBitmap       *mask,
-                                     gint             x,
-                                     gint             y);
 void gdk_window_shape_combine_region (GdkWindow              *window,
                                       const cairo_region_t *shape_region,
                                       gint            offset_x,
@@ -606,10 +602,6 @@ void gdk_window_set_composited   (GdkWindow *window,
  */
 void gdk_window_merge_child_shapes         (GdkWindow       *window);
 
-void gdk_window_input_shape_combine_mask   (GdkWindow       *window,
-                                           GdkBitmap       *mask,
-                                           gint             x,
-                                           gint             y);
 void gdk_window_input_shape_combine_region (GdkWindow       *window,
                                             const cairo_region_t *shape_region,
                                             gint             offset_x,