Browse Source

Document that SDL_UpdateJoysticks() needs to be called to handle rumble processing

Related: https://github.com/libsdl-org/SDL/issues/4300
Sam Lantinga 1 year ago
parent
commit
4ce7ae31d4
2 changed files with 8 additions and 0 deletions
  1. 4 0
      include/SDL3/SDL_gamepad.h
  2. 4 0
      include/SDL3/SDL_joystick.h

+ 4 - 0
include/SDL3/SDL_gamepad.h

@@ -1199,6 +1199,8 @@ extern DECLSPEC int SDLCALL SDL_GetGamepadSensorData(SDL_Gamepad *gamepad, SDL_S
  * Each call to this function cancels any previous rumble effect, and calling
  * it with 0 intensity stops any rumbling.
  *
+ * This function requires you to process SDL events or call SDL_UpdateJoysticks() to update rumble state.
+ *
  * \param gamepad The gamepad to vibrate
  * \param low_frequency_rumble The intensity of the low frequency (left)
  *                             rumble motor, from 0 to 0xFFFF
@@ -1221,6 +1223,8 @@ extern DECLSPEC int SDLCALL SDL_RumbleGamepad(SDL_Gamepad *gamepad, Uint16 low_f
  * whole. This is currently only supported on Xbox One gamepads. If you want
  * the (more common) whole-gamepad rumble, use SDL_RumbleGamepad() instead.
  *
+ * This function requires you to process SDL events or call SDL_UpdateJoysticks() to update rumble state.
+ *
  * \param gamepad The gamepad to vibrate
  * \param left_rumble The intensity of the left trigger rumble motor, from 0
  *                    to 0xFFFF

+ 4 - 0
include/SDL3/SDL_joystick.h

@@ -905,6 +905,8 @@ extern DECLSPEC Uint8 SDLCALL SDL_GetJoystickButton(SDL_Joystick *joystick,
  * Each call to this function cancels any previous rumble effect, and calling
  * it with 0 intensity stops any rumbling.
  *
+ * This function requires you to process SDL events or call SDL_UpdateJoysticks() to update rumble state.
+ *
  * \param joystick The joystick to vibrate
  * \param low_frequency_rumble The intensity of the low frequency (left)
  *                             rumble motor, from 0 to 0xFFFF
@@ -928,6 +930,8 @@ extern DECLSPEC int SDLCALL SDL_RumbleJoystick(SDL_Joystick *joystick, Uint16 lo
  * want the (more common) whole-controller rumble, use SDL_RumbleJoystick()
  * instead.
  *
+ * This function requires you to process SDL events or call SDL_UpdateJoysticks() to update rumble state.
+ *
  * \param joystick The joystick to vibrate
  * \param left_rumble The intensity of the left trigger rumble motor, from 0
  *                    to 0xFFFF