-
Notifications
You must be signed in to change notification settings - Fork 42
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
a2a3fa0
commit 768b13e
Showing
2 changed files
with
45 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,41 @@ | ||
###### (This is the documentation for SDL3, which is the current stable version. [SDL2](https://wiki.libsdl.org/SDL2/) was the previous version!) | ||
# SDL_HINT_JOYSTICK_ENHANCED_REPORTS | ||
|
||
A variable controlling whether enhanced reports should be used for controllers when using the HIDAPI driver. | ||
|
||
## Header File | ||
|
||
Defined in [<SDL3/SDL_hints.h>](https://github.com/libsdl-org/SDL/blob/main/include/SDL3/SDL_hints.h) | ||
|
||
## Syntax | ||
|
||
```c | ||
#define SDL_HINT_JOYSTICK_ENHANCED_REPORTS "SDL_JOYSTICK_ENHANCED_REPORTS" | ||
``` | ||
## Remarks | ||
Enhanced reports allow rumble and effects on Bluetooth PlayStation | ||
controllers and gyro on Nintendo Switch controllers, but break Windows | ||
DirectInput for other applications that don't use SDL. | ||
Once enhanced reports are enabled, they can't be disabled on PlayStation | ||
controllers without power cycling the controller. | ||
The variable can be set to the following values: | ||
- "0": enhanced reports are not enabled. | ||
- "1": enhanced reports are enabled. (default) | ||
- "auto": enhanced features are advertised to the application, but SDL | ||
doesn't change the controller report mode unless the application uses | ||
them. | ||
This hint can be enabled anytime. | ||
## Version | ||
This hint is available since SDL 3.1.3. | ||
---- | ||
[CategoryAPI](CategoryAPI), [CategoryAPIMacro](CategoryAPIMacro), [CategoryHints](CategoryHints) | ||