SDL_WarpMouseInWindow(3)

SDL_WarpMouseInWindow3

Move the mouse cursor to the given position within the window.

Usage

#include "SDL3/SDL.h"

void SDL_WarpMouseInWindow(SDL_Window *window, float x, float y);

Header file

Defined in SDL3/SDL_mouse.h

Overview

This function generates a mouse motion event if relative mode is not enabled. If relative mode is enabled, you can force mouse events for the warp by setting the

SDL_HINT_MOUSE_RELATIVE_WARP_MOTION

hint.

Note that this function will appear to succeed, but not actually move the mouse when used over Microsoft Remote Desktop.

Function parameters

window

the window to move the mouse into, or NULL for the current mouse focus.

x

the x coordinate within the window.

y

the y coordinate within the window.

Thread safety

This function should only be called on the main thread.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.