mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2026-05-02 03:54:41 +00:00
Code Issues Packages Projects Releases Wiki Activity

hints: Renamed SDL_HINT_LOG_BACKENDS to SDL_DEBUG_LOGGING.

Browse Source 
This still logs backend choices, but we might use it for other things. For
example, what Android device is being used, or all the devices we enumerated,
etc.

Ideally this eventually logs all the stuff we often have to ask followup
questions about.
This commit is contained in:
Ryan C. Gordon
2025-07-22 13:19:30 -04:00
parent af1c05fd58
commit 07ef532681
11 changed files with 29 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
include/SDL3/SDL_hints.h
View File

@@ -4396,26 +4396,29 @@ extern "C" {
#define SDL_HINT_PEN_TOUCH_EVENTS "SDL_PEN_TOUCH_EVENTS"
/**
* A variable controlling whether SDL backend information is logged.
* A variable controlling whether SDL logs some debug information.
*
* The variable can be set to the following values:
*
* - "0": Subsystem information will not be logged. (default)
* - "1": Subsystem information will be logged.
* - "0": SDL debug information will not be logged. (default)
* - "1": SDL debug information will be logged.
*
* This is generally meant to be used as an environment variable to let
* end-users report what subsystems were chosen on their system, to aid in
* debugging. Logged information is sent through SDL_Log(), which means by
* default they appear on stdout on most platforms or maybe
* OutputDebugString() on Windows, and can be funneled by the app with
* SDL_SetLogOutputFunction(), etc.
* end-users report what subsystems were chosen on their system, perhaps what
* sort of hardware they are running on, etc, to aid in debugging. Logged
* information is sent through SDL_Log(), which means by default they appear
* on stdout on most platforms, or maybe OutputDebugString() on Windows, and
* can be funneled by the app with SDL_SetLogOutputFunction(), etc.
*
* The specific output might change between SDL versions; more information
* might be deemed useful in the future.
*
* This hint can be set anytime, but the specific logs are generated during
* subsystem init.
*
* \since This hint is available since SDL 3.4.0.
*/
#define SDL_HINT_LOG_BACKENDS "SDL_LOG_BACKENDS"
#define SDL_HINT_DEBUG_LOGGING "SDL_DEBUG_LOGGING"
/**
* An enumeration of hint priorities.