INSTALL.txt
author Ryan C. Gordon
Mon, 21 Aug 2017 00:42:06 -0400
changeset 11334 749cb40916f2
parent 10893 54480745c410
permissions -rw-r--r--
x11: specify event mask for buttons when grabbing pointer (thanks, Stas!).

This fixes a strange corner case (notes appended below), and should be
safe to do anyhow.

Fixes Bugzilla #3674.

"I did more tests.
It appears the bug only happens if there is
another window on the screen that has "always
on top" property. For me it is xawtv - it is
always opened in a screen corner. Closing
xawtv or removing "always on top" property
from it makes the problem to go away.
Plus, it doesn't appear like the buttons are
not delivered at all. It appears that instead
the button presses are delivered on some mouse
positions, but not delivered when you move the
mouse to other part of the window... So this is
really weird and is likely somewhere deep in the
Xorg.
Maybe somehow it happens that the cursor is
actually above the xawtv window, but, because
my app uses grab, it is not visible there, and
in that case the events are not delivered to
my app?
But with my patch the button events are
always delivered flawlessly, it seems.

Hmm, and that indeed seems to explain my problem:
if the mask is set properly and my app uses
grab, then, even if the mouse is above some
other window, the events would still be delivered
to the grabbing app, which is what actually wanted
because my app uses relative mouse mode, so it
doesn't know the pointer can cross some other window
(my app draws the pointer itself).
So my current theory is that my patch only enforces
the mouse grab, which otherwise can be tricked by
some other window preventing the button events
delivery (but motion events are still delivered
via xinput2, which makes it all look very obscure)."
     1 
     2 To compile and install SDL:
     3 
     4     1.  Windows with Visual Studio:
     5         * Read VisualC.html
     6 
     7         Windows with gcc, either native or cross-compiling:
     8         * Read the FAQ at https://wiki.libsdl.org/moin.fcg/FAQWindows
     9         * Run './configure; make; make install'
    10 
    11         Mac OS X with Xcode:
    12         * Read docs/README-macosx.md
    13 
    14         Mac OS X from the command line:
    15         * Run './configure; make; make install'
    16 
    17         Linux and other UNIX systems:
    18         * Run './configure; make; make install'
    19 
    20         Android:
    21         * Read docs/README-android.md
    22 
    23         iOS:
    24         * Read docs/README-ios.md
    25 
    26         Using Cmake:
    27         * Read docs/README-cmake.md
    28 
    29     2.  Look at the example programs in ./test, and check out the online
    30         documentation at https://wiki.libsdl.org/
    31 
    32     3.  Join the SDL developer mailing list by sending E-mail to
    33     	sdl-request@libsdl.org
    34         and put "subscribe" in the subject of the message.
    35 
    36         Or alternatively you can use the web interface:
    37             https://www.libsdl.org/mailing-list.php
    38 
    39 That's it!
    40 Sam Lantinga <slouken@libsdl.org>