Note that mouse warping doesn't work over Microsoft Remote Desktop

Fixes the documentation portion of bug https://github.com/libsdl-org/SDL/issues/4206
This commit is contained in:
Sam Lantinga 2021-07-24 10:29:34 -07:00
parent 94b7a87645
commit d89f4b3ae4

View File

@ -150,6 +150,9 @@ extern DECLSPEC Uint32 SDLCALL SDL_GetRelativeMouseState(int *x, int *y);
* *
* This function generates a mouse motion event. * This function generates a mouse motion event.
* *
* Note that this function will appear to succeed, but not actually move
* the mouse when used over Microsoft Remote Desktop.
*
* \param window the window to move the mouse into, or NULL for the current * \param window the window to move the mouse into, or NULL for the current
* mouse focus * mouse focus
* \param x the x coordinate within the window * \param x the x coordinate within the window
@ -168,6 +171,9 @@ extern DECLSPEC void SDLCALL SDL_WarpMouseInWindow(SDL_Window * window,
* A failure of this function usually means that it is unsupported by a * A failure of this function usually means that it is unsupported by a
* platform. * platform.
* *
* Note that this function will appear to succeed, but not actually move
* the mouse when used over Microsoft Remote Desktop.
*
* \param x the x coordinate * \param x the x coordinate
* \param y the y coordinate * \param y the y coordinate
* \returns 0 on success or a negative error code on failure; call * \returns 0 on success or a negative error code on failure; call
@ -186,6 +192,10 @@ extern DECLSPEC int SDLCALL SDL_WarpMouseGlobal(int x, int y);
* will try to report continuous motion in the current window. Only relative * will try to report continuous motion in the current window. Only relative
* motion events will be delivered, the mouse position will not change. * motion events will be delivered, the mouse position will not change.
* *
* Note that this function will not be able to provide continuous relative
* motion when used over Microsoft Remote Desktop, instead motion is limited
* to the bounds of the screen.
*
* This function will flush any pending mouse motion. * This function will flush any pending mouse motion.
* *
* \param enabled SDL_TRUE to enable relative mode, SDL_FALSE to disable. * \param enabled SDL_TRUE to enable relative mode, SDL_FALSE to disable.