SDL_HintCallback(3type)

SDL_HintCallback3type

A callback used to send notifications of hint value changes.

Usage

#include "SDL3/SDL.h"

typedef void(SDLCALL *SDL_HintCallback)(void *userdata, const char *name, const char *oldValue, const char *newValue);

Header file

Defined in SDL3/SDL_hints.h

Overview

This is called an initial time during

SDL_AddHintCallback
with the hint's current value, and then again each time the hint's value changes.

Function parameters

userdata

what was passed as userdata to SDL_AddHintCallback ().

name

what was passed as name to SDL_AddHintCallback ().

oldValue

the previous hint value.

newValue

the new value hint is to be set to.

Thread safety

This callback is fired from whatever thread is setting a new hint value. SDL holds a lock on the hint subsystem when calling this callback.

Availability

This datatype is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.