SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE - Man Page

A variable controlling whether SDL will clear the window contents when the WM_ERASEBKGND message is received.

Synopsis

#include <SDL3/SDL_hints.h>

#define SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE "SDL_WINDOWS_ERASE_BACKGROUND_MODE"

Description

The variable can be set to the following values:

· "0"/"never": Never clear the window.

· "1"/"initial": Clear the window when the first WM_ERASEBKGND event fires. (default)

· "2"/"always": Clear the window on every WM_ERASEBKGND event.

This hint should be set before creating a window.

Availability

This hint is available since SDL 3.2.0.

Info

SDL 3.2.16 Simple Directmedia Layer SDL3 FUNCTIONS