Deprecate the gdk_window_begin/end_paint family of functions

They are replaced by the more appropriate gdk_window_begin_draw_frame()
and gdk_window_end_draw_frame() functions.

https://bugzilla.gnome.org/show_bug.cgi?id=766675
This commit is contained in:
Emmanuele Bassi 2016-06-07 16:40:43 +01:00
parent dda6a0d385
commit c5d0522a23
3 changed files with 12 additions and 10 deletions

View File

@ -2949,7 +2949,7 @@ gdk_window_end_paint_internal (GdkWindow *window)
if (window->current_paint.surface == NULL)
{
g_warning (G_STRLOC": no preceding call to gdk_window_begin_paint_region(), see documentation");
g_warning (G_STRLOC": no preceding call to gdk_window_begin_draw_frame(), see documentation");
return;
}
@ -3043,7 +3043,8 @@ gdk_window_end_paint_internal (GdkWindow *window)
* creates a rectangular region for you. See
* gdk_window_begin_paint_region() for details.
*
**/
* Deprecated: 3.22: Use gdk_window_begin_draw_frame() instead
*/
void
gdk_window_begin_paint_rect (GdkWindow *window,
const GdkRectangle *rectangle)
@ -3101,7 +3102,8 @@ gdk_window_begin_paint_rect (GdkWindow *window,
* gdk_window_end_paint() is required for each call to
* gdk_window_begin_paint_region().
*
**/
* Deprecated: 3.22: Use gdk_window_begin_draw_frame() instead
*/
void
gdk_window_begin_paint_region (GdkWindow *window,
const cairo_region_t *region)

View File

@ -694,16 +694,16 @@ GDK_AVAILABLE_IN_ALL
cairo_region_t *gdk_window_get_visible_region(GdkWindow *window);
GDK_AVAILABLE_IN_ALL
GDK_DEPRECATED_IN_3_22_FOR(gdk_window_begin_draw_frame)
void gdk_window_begin_paint_rect (GdkWindow *window,
const GdkRectangle *rectangle);
GDK_AVAILABLE_IN_3_16
void gdk_window_mark_paint_from_clip (GdkWindow *window,
cairo_t *cr);
GDK_AVAILABLE_IN_ALL
GDK_DEPRECATED_IN_3_22_FOR(gdk_window_begin_draw_frame)
void gdk_window_begin_paint_region (GdkWindow *window,
const cairo_region_t *region);
GDK_AVAILABLE_IN_ALL
GDK_DEPRECATED_IN_3_22_FOR(gdk_window_end_draw_frame)
void gdk_window_end_paint (GdkWindow *window);
GDK_AVAILABLE_IN_3_22

View File

@ -9294,10 +9294,10 @@ gtk_widget_get_app_paintable (GtkWidget *widget)
*
* Widgets are double buffered by default; you can use this function
* to turn off the buffering. Double buffered simply means that
* gdk_window_begin_paint_region() and gdk_window_end_paint() are called
* gdk_window_begin_draw_frame() and gdk_window_end_draw_frame() are called
* automatically around expose events sent to the
* widget. gdk_window_begin_paint_region() diverts all drawing to a widget's
* window to an offscreen buffer, and gdk_window_end_paint() draws the
* widget. gdk_window_begin_draw_frame() diverts all drawing to a widget's
* window to an offscreen buffer, and gdk_window_end_draw_frame() draws the
* buffer to the screen. The result is that users see the window
* update in one smooth step, and dont see individual graphics
* primitives being rendered.
@ -9309,7 +9309,7 @@ gtk_widget_get_app_paintable (GtkWidget *widget)
* Note: if you turn off double-buffering, you have to handle
* expose events, since even the clearing to the background color or
* pixmap will not happen automatically (as it is done in
* gdk_window_begin_paint_region()).
* gdk_window_begin_draw_frame()).
*
* In 3.10 GTK and GDK have been restructured for translucent drawing. Since
* then expose events for double-buffered widgets are culled into a single