gdkWindowSetComposited: gdkWindowSetComposited

In RGtk2: R Bindings for Gtk 2.8.0 and Above

Description

Sets a GdkWindow as composited, or unsets it. Composited windows do not automatically have their contents drawn to the screen. Drawing is redirected to an offscreen buffer and an expose event is emitted on the parent of the composited window. It is the responsibility of the parent's expose handler to manually merge the off-screen content onto the screen in whatever way it sees fit. See for an example.

Usage

gdkWindowSetComposited(object, composited)

Arguments

object	a GdkWindow
composited	TRUE to set the window as composited

Details

It only makes sense for child windows to be composited; see gdkWindowSetOpacity if you need translucent toplevel windows.

An additional effect of this call is that the area of this window is no longer clipped from regions marked for invalidation on its parent. Draws done on the parent window are also no longer clipped by the child.

This call is only supported on some systems (currently, only X11 with new enough Xcomposite and Xdamage extensions). You must call gdkDisplaySupportsComposite to check if setting a window as composited is supported before attempting to do so. Since 2.12

Author(s)

Derived by RGtkGen from GTK+ documentation

RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.