SDL_RumbleGamepadTriggers(3)

💅 SDL_RumbleGamepadTriggers ✨

okay bestie so this is a page from the SDL3 FUNCTIONS manual, and it's literally called SDL_RumbleGamepadTriggers — say that five times fast, I dare you 🫶

---

🌸 NAME 🌸

SDL_RumbleGamepadTriggers — start a rumble effect in the gamepad's triggers. yes. the triggers. the lil shoulder buttons. they buzz now. iconic.

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_gamepad.h>

bool SDL_RumbleGamepadTriggers(SDL_Gamepad *gamepad, Uint16 left_rumble, Uint16 right_rumble, Uint32 duration_ms);

---

🎀 DESCRIPTION 🎀

okay so every single time you call this function, it cancels any previous trigger rumble effect. every call. no stacking, no layering, no "let me just add a little more". it's a fresh start every time, main character energy only 👑

and if you call it with 0 intensity? that stops any rumbling. like, completely. silence. the vibes are still. 💀

not me needing to say this but: this is rumbling of the _triggers_ and NOT the gamepad as a whole. this is currently only supported on Xbox One gamepads. that's it. that's the list. 🙈

if you want the (more common) whole-gamepad rumble — you know, the classic, the standard, the one everyone knows — use SDL_RumbleGamepad() instead. this one is the niche one. the specialist. the one with a very specific job and she does it well 💅

ALSO. important. this function requires you to process SDL events or call SDL_UpdateJoysticks() to update rumble state. so if you're sitting there like "why is nothing buzzing 😭" — that's why. the rumble state doesn't update itself, bestie. you gotta feed it. 🍓

---

💖 FUNCTION PARAMETERS 💖

• gamepad — the gamepad to vibrate. yes, that one. the one you're holding. 🎮
• left_rumble — the intensity of the left trigger rumble motor, from 0 to 0xFFFF. that's the full range, no cap (well, 0xFFFF cap, technically). 🔥
• right_rumble — the intensity of the right trigger rumble motor, from 0 to 0xFFFF. same energy, other side. ⭐
• duration_ms — the duration of the rumble effect, in milliseconds. how long the buzz lasts. the moment is fleeting, make it count 🦋

---

🌈 RETURN VALUE 🌈

returns true on success or false on failure. and if it fails? call SDL_GetError() for more information, because she will tell you what went wrong, and you WILL listen 😤

---

🧚 THREAD SAFETY 🧚

it is safe to call this function from any thread. ANY thread. go wild. multi-threaded rumble. slay. ✨

---

👑 AVAILABILITY 👑

this function is available since SDL 3.2.0. so if you're on something older... girl. upgrade. 💜

---

🔥 SEE ALSO 🔥

• SDL_RumbleGamepad(3) — the whole-gamepad one, for when trigger-only isn't enough for you

---

Simple Directmedia Layer • SDL 3.4.18 • SDL_RumbleGamepadTriggers(3)

and that's the whole page bestie, tysm for reading, go make something buzz 💖✨🎀🦋🌸🫶