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

SDL_AddHintCallback

Add a function to watch a particular hint.

Header File

Defined in <SDL3/SDL_hints.h>

Syntax

bool SDL_AddHintCallback(const char *name, SDL_HintCallback callback, void *userdata);

Function Parameters

const char *	name	the hint to watch.
SDL_HintCallback	callback	An SDL_HintCallback function that will be called when the hint value changes.
void *	userdata	a pointer to pass to the callback function.

Return Value

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

Remarks

The callback function is called during this function, to provide it an initial value, and again each time the hint's value changes.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.1.3.

See Also

• SDL_RemoveHintCallback

---

CategoryAPI, CategoryAPIFunction, CategoryHints

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.