(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_SetHint

Set a hint with normal priority.

Header File

Syntax

bool SDL_SetHint(const char *name, const char *value);

Function Parameters

const char *	name	the hint to set.
const char *	value	the value of the hint variable.

Return Value

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

Remarks

Hints will not be set if there is an existing override hint or environment variable that takes precedence. You can use SDL_SetHintWithPriority() to set the hint with override priority instead.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.1.3.