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)."
slouken@7222
     1
slouken@7222
     2
To compile and install SDL:
slouken@7222
     3
slouken@7227
     4
    1.  Windows with Visual Studio:
slouken@7227
     5
        * Read VisualC.html
slouken@7222
     6
slouken@7227
     7
        Windows with gcc, either native or cross-compiling:
icculus@10893
     8
        * Read the FAQ at https://wiki.libsdl.org/moin.fcg/FAQWindows
slouken@7227
     9
        * Run './configure; make; make install'
slouken@7227
    10
slouken@7227
    11
        Mac OS X with Xcode:
slouken@9025
    12
        * Read docs/README-macosx.md
slouken@7222
    13
slouken@7227
    14
        Mac OS X from the command line:
slouken@7227
    15
        * Run './configure; make; make install'
slouken@7227
    16
slouken@7227
    17
        Linux and other UNIX systems:
slouken@7227
    18
        * Run './configure; make; make install'
slouken@7222
    19
slouken@7227
    20
        Android:
slouken@9025
    21
        * Read docs/README-android.md
slouken@7227
    22
slouken@7227
    23
        iOS:
slouken@9025
    24
        * Read docs/README-ios.md
slouken@7227
    25
slouken@7227
    26
        Using Cmake:
slouken@9025
    27
        * Read docs/README-cmake.md
slouken@7222
    28
slouken@7222
    29
    2.  Look at the example programs in ./test, and check out the online
icculus@10893
    30
        documentation at https://wiki.libsdl.org/
slouken@7222
    31
slouken@7222
    32
    3.  Join the SDL developer mailing list by sending E-mail to
slouken@7222
    33
    	sdl-request@libsdl.org
slouken@7222
    34
        and put "subscribe" in the subject of the message.
slouken@7222
    35
slouken@7222
    36
        Or alternatively you can use the web interface:
icculus@10893
    37
            https://www.libsdl.org/mailing-list.php
slouken@7222
    38
slouken@7222
    39
That's it!
slouken@7222
    40
Sam Lantinga <slouken@libsdl.org>