SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE(3)

SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE3

A variable controlling whether sdl will clear the window contents when the wm_erasebkgnd message is received.

Usage

#include "SDL3/SDL.h"

#define SDL_HINT_WINDOWS_ERASE_BACKGROUND_MODE SDL_WINDOWS_ERASE_BACKGROUND_MODE"

Header file

Defined in SDL3/SDL_hints.h

Overview

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.

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