NAME¶

SDL_SetGamepadLED - Update a gamepad's LED color.

SYNOPSIS¶

#include <SDL3/SDL_gamepad.h>

bool SDL_SetGamepadLED(SDL_Gamepad *gamepad, Uint8 red, Uint8 green, Uint8 blue);

DESCRIPTION¶

An example of a joystick LED is the light on the back of a PlayStation 4's DualShock 4 controller.

For gamepads with a single color LED, the maximum of the RGB values will be used as the LED brightness.

FUNCTION PARAMETERS¶

gamepad

the gamepad to update.

red

the intensity of the red LED.

green

the intensity of the green LED.

blue

the intensity of the blue LED.

RETURN VALUE¶

Returns true on success or false on failure; call SDL_GetError() for more information.

THREAD SAFETY¶

It is safe to call this function from any thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.