Re: Add unredirect block / request hints

[Adel Gadllah <adel gadllah gmail com>]

Hi,

New version of the patch is attached.

Thanks,
Adel

From e4be44eae9a4f7c1e3740fd17cf5b5a15e5e82b8 Mon Sep 17 00:00:00 2001
From: Adel Gadllah <adel gadllah gmail com>
Date: Tue, 14 Feb 2012 14:30:28 +0100
Subject: [PATCH] Add _NET_WM_BYPASS_COMPOSITOR hint

Adds a property that allows client windows to hint the compositor that they
should or should never be unredirected / run uncomposited.
---
 wm-spec/wm-spec.xml | 25 +++++++++++++++++++++++++
 1 Datei geändert, 25 Zeilen hinzugefügt(+)

diff --git a/wm-spec/wm-spec.xml b/wm-spec/wm-spec.xml
index 87dc02d..1a810cb 100644
--- a/wm-spec/wm-spec.xml
+++ b/wm-spec/wm-spec.xml
@@ -1578,6 +1578,28 @@ Rationale: This gives the compositing manager more room for optimizations.
 For example, it can avoid drawing occluded portions behind the window.
         </para>
         </sect2>
+
+ <sect2><title>_NET_WM_BYPASS_COMPOSITOR</title>
+        <programlisting><![CDATA[
+_NET_WM_BYPASS_COMPOSITOR, CARDINAL/32
+]]></programlisting>
+        <para>
+The Client MAY set this property to hint the compositor that the window would
+benefit from running uncomposited (i.e not redirected offscreen) or that the window
+might be hurt from being uncomposited (like an ARGB or shaped window).
+A value of 1 hints the compositor to disabling compositing of this window.
+A value of 2 hints the compositor to not disabling compositing of this window.
+Any other value means no preference. The compositing manager MAY bypass compositing
+for both fullscreen and non-fullscreen windows if bypassing is requested, but MUST NOT
+bypass if it would cause differences from the composited appearance.
+        </para>
+        <para>
+Rationale: Some applications like fullscreen games might want run without the overhead
+of being redirected offscreen (to avoid extra copies) and thus perform better. While others
+like applications that use ARGB or shaped windows want to always run composited.
+        </para>
+        </sect2>
+
 </sect1>
 <sect1>
     <title>Window Manager Protocols</title>
@@ -2283,6 +2305,9 @@ OR OTHER DEALINGS IN THE SOFTWARE.
         <sect2>
         <title>Changes since 1.4draft</title>
         <itemizedlist>
+            <listitem><para>
+Added _NET_WM_BYPASS_COMPOSITOR.
+            </para></listitem>
             <listitem><para>
 Added _NET_WM_STATE_FOCUSED.
             </para></listitem>
--
1.7.11.7