.\" This manpage content is licensed under Creative Commons
.\"  Attribution 4.0 International (CC BY 4.0)
.\"   https://creativecommons.org/licenses/by/4.0/
.\" This manpage was generated from SDL's wiki page for SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE:
.\"   https://wiki.libsdl.org/SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE
.\" Generated with SDL/build-scripts/wikiheaders.pl
.\"  revision release-3.2.10-0-g877399b2b
.\" Please report issues in this manpage's content at:
.\"   https://github.com/libsdl-org/sdlwiki/issues/new
.\" Please report issues in the generation of this manpage from the wiki at:
.\"   https://github.com/libsdl-org/SDL/issues/new?title=Misgenerated%20manpage%20for%20SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE
.\" SDL can be found at https://libsdl.org/
.de URL
\$2 \(laURL: \$1 \(ra\$3
..
.if \n[.g] .mso www.tmac
.TH SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE 3 "SDL 3.2.10" "Simple Directmedia Layer" "SDL3 FUNCTIONS"
.SH NAME
SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE \- A variable controlling whether warping a hidden mouse cursor will activate relative mouse mode\[char46]
.SH HEADER FILE
Defined in SDL3/SDL_hints\[char46]h

.SH SYNOPSIS
.nf
.B #include \(dqSDL3/SDL.h\(dq
.PP
.BI "#define SDL_HINT_MOUSE_EMULATE_WARP_WITH_RELATIVE "SDL_MOUSE_EMULATE_WARP_WITH_RELATIVE"
.fi
.SH DESCRIPTION
When this hint is set, the mouse cursor is hidden, and multiple warps to
the window center occur within a short time period, SDL will emulate mouse
warps using relative mouse mode\[char46] This can provide smoother and more
reliable mouse motion for some older games, which continuously calculate
the distance travelled by the mouse pointer and warp it back to the center
of the window, rather than using relative mouse motion\[char46]

Note that relative mouse mode may have different mouse acceleration
behavior than pointer warps\[char46]

If your application needs to repeatedly warp the hidden mouse cursor at a
high-frequency for other purposes, it should disable this hint\[char46]

The variable can be set to the following values:


\(bu "0": Attempts to warp the mouse will always be made\[char46]

\(bu "1": Some mouse warps will be emulated by forcing relative mouse mode\[char46]
  (default)

If not set, this is automatically enabled unless an application uses
relative mouse mode directly\[char46]

This hint can be set anytime\[char46]

.SH AVAILABILITY
This hint is available since SDL 3\[char46]2\[char46]0\[char46]