include/SDL_hints.h
changeset 11201 813a8510bd0c
parent 11182 27ed95cf83d6
child 11261 2d458a198021
     1.1 --- a/include/SDL_hints.h	Wed Aug 09 11:58:38 2017 -0700
     1.2 +++ b/include/SDL_hints.h	Wed Aug 09 11:59:29 2017 -0700
     1.3 @@ -359,7 +359,6 @@
     1.4   */
     1.5  #define SDL_HINT_ACCELEROMETER_AS_JOYSTICK "SDL_ACCELEROMETER_AS_JOYSTICK"
     1.6  
     1.7 -
     1.8  /**
     1.9   *  \brief  A variable that lets you disable the detection and use of Xinput gamepad devices
    1.10   *
    1.11 @@ -369,7 +368,6 @@
    1.12   */
    1.13  #define SDL_HINT_XINPUT_ENABLED "SDL_XINPUT_ENABLED"
    1.14  
    1.15 -
    1.16  /**
    1.17   *  \brief  A variable that causes SDL to use the old axis and button mapping for XInput devices.
    1.18   *
    1.19 @@ -379,9 +377,8 @@
    1.20   */
    1.21  #define SDL_HINT_XINPUT_USE_OLD_JOYSTICK_MAPPING "SDL_XINPUT_USE_OLD_JOYSTICK_MAPPING"
    1.22  
    1.23 -
    1.24  /**
    1.25 - *  \brief  A variable that lets you manually hint extra gamecontroller db entries
    1.26 + *  \brief  A variable that lets you manually hint extra gamecontroller db entries.
    1.27   *
    1.28   *  The variable should be newline delimited rows of gamecontroller config data, see SDL_gamecontroller.h
    1.29   *
    1.30 @@ -390,6 +387,31 @@
    1.31   */
    1.32  #define SDL_HINT_GAMECONTROLLERCONFIG "SDL_GAMECONTROLLERCONFIG"
    1.33  
    1.34 +/**
    1.35 + *  \brief  A variable containing a list of devices to skip when scanning for game controllers.
    1.36 + *
    1.37 + *  The format of the string is a comma separated list of USB VID/PID pairs
    1.38 + *  in hexadecimal form, e.g.
    1.39 + *
    1.40 + *      0xAAAA/0xBBBB,0xCCCC/0xDDDD
    1.41 + *
    1.42 + *  The variable can also take the form of @file, in which case the named
    1.43 + *  file will be loaded and interpreted as the value of the variable.
    1.44 + */
    1.45 +#define SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES "SDL_GAMECONTROLLER_IGNORE_DEVICES"
    1.46 +
    1.47 +/**
    1.48 + *  \brief  If set, all devices will be skipped when scanning for game controllers except for the ones listed in this variable.
    1.49 + *
    1.50 + *  The format of the string is a comma separated list of USB VID/PID pairs
    1.51 + *  in hexadecimal form, e.g.
    1.52 + *
    1.53 + *      0xAAAA/0xBBBB,0xCCCC/0xDDDD
    1.54 + *
    1.55 + *  The variable can also take the form of @file, in which case the named
    1.56 + *  file will be loaded and interpreted as the value of the variable.
    1.57 + */
    1.58 +#define SDL_HINT_GAMECONTROLLER_IGNORE_DEVICES_EXCEPT "SDL_GAMECONTROLLER_IGNORE_DEVICES_EXCEPT"
    1.59  
    1.60  /**
    1.61   *  \brief  A variable that lets you enable joystick (and gamecontroller) events even when your app is in the background.
    1.62 @@ -404,7 +426,6 @@
    1.63   */
    1.64  #define SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS "SDL_JOYSTICK_ALLOW_BACKGROUND_EVENTS"
    1.65  
    1.66 -
    1.67  /**
    1.68   *  \brief If set to "0" then never set the top most bit on a SDL Window, even if the video mode expects it.
    1.69   *      This is a debugging aid for developers and not expected to be used by end users. The default is "1"
    1.70 @@ -415,7 +436,6 @@
    1.71   */
    1.72  #define SDL_HINT_ALLOW_TOPMOST "SDL_ALLOW_TOPMOST"
    1.73  
    1.74 -
    1.75  /**
    1.76   *  \brief A variable that controls the timer resolution, in milliseconds.
    1.77   *