(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)

SDL_SetHint

Set a hint with normal priority.

Header File

Syntax

SDL_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

(SDL_bool) Returns SDL_TRUE if the hint was set, SDL_FALSE otherwise.

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.

Version

This function is available since SDL 2.0.0.