Go to the source code of this file.
|
enum | SDL_LogCategory {
SDL_LOG_CATEGORY_APPLICATION
,
SDL_LOG_CATEGORY_ERROR
,
SDL_LOG_CATEGORY_ASSERT
,
SDL_LOG_CATEGORY_SYSTEM
,
SDL_LOG_CATEGORY_AUDIO
,
SDL_LOG_CATEGORY_VIDEO
,
SDL_LOG_CATEGORY_RENDER
,
SDL_LOG_CATEGORY_INPUT
,
SDL_LOG_CATEGORY_TEST
,
SDL_LOG_CATEGORY_RESERVED1
,
SDL_LOG_CATEGORY_RESERVED2
,
SDL_LOG_CATEGORY_RESERVED3
,
SDL_LOG_CATEGORY_RESERVED4
,
SDL_LOG_CATEGORY_RESERVED5
,
SDL_LOG_CATEGORY_RESERVED6
,
SDL_LOG_CATEGORY_RESERVED7
,
SDL_LOG_CATEGORY_RESERVED8
,
SDL_LOG_CATEGORY_RESERVED9
,
SDL_LOG_CATEGORY_RESERVED10
,
SDL_LOG_CATEGORY_CUSTOM
} |
|
enum | SDL_LogPriority {
SDL_LOG_PRIORITY_VERBOSE = 1
,
SDL_LOG_PRIORITY_DEBUG
,
SDL_LOG_PRIORITY_INFO
,
SDL_LOG_PRIORITY_WARN
,
SDL_LOG_PRIORITY_ERROR
,
SDL_LOG_PRIORITY_CRITICAL
,
SDL_NUM_LOG_PRIORITIES
} |
|
|
void | SDL_SetLogPriorities (SDL_LogPriority priority) |
|
void | SDL_SetLogPriority (int category, SDL_LogPriority priority) |
|
SDL_LogPriority | SDL_GetLogPriority (int category) |
|
void | SDL_ResetLogPriorities (void) |
|
void | SDL_Log (SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(1) |
|
void | SDL_LogVerbose (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
|
void | SDL_LogDebug (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
|
void | SDL_LogInfo (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
|
void | SDL_LogWarn (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
|
void | SDL_LogError (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
|
void | SDL_LogCritical (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
|
void | SDL_LogMessage (int category, SDL_LogPriority priority, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(3) |
|
void | SDL_LogMessageV (int category, SDL_LogPriority priority, SDL_PRINTF_FORMAT_STRING const char *fmt, va_list ap) SDL_PRINTF_VARARG_FUNCV(3) |
|
void | SDL_GetLogOutputFunction (SDL_LogOutputFunction *callback, void **userdata) |
|
void | SDL_SetLogOutputFunction (SDL_LogOutputFunction callback, void *userdata) |
|
◆ SDL_LogOutputFunction
typedef void(* SDL_LogOutputFunction) (void *userdata, int category, SDL_LogPriority priority, const char *message) |
The prototype for the log output callback function.
This function is called by SDL when there is new text to be logged.
- Parameters
-
userdata | what was passed as userdata to SDL_SetLogOutputFunction(). |
category | the category of the message. |
priority | the priority of the message. |
message | the message being output. |
- Since
- This datatype is available since SDL 3.0.0.
Definition at line 372 of file SDL_log.h.
◆ SDL_LogCategory
CategoryLog
Simple log messages with priorities and categories. A message’s SDL_LogPriority signifies how important the message is. A message's SDL_LogCategory signifies from what domain it belongs to. Every category has a minimum priority specified: when a message belongs to that category, it will only be sent out if it has that minimum priority or higher.
SDL's own logs are sent below the default priority threshold, so they are quiet by default. If you're debugging SDL you might want:
SDL_SetLogPriorities(SDL_LOG_PRIORITY_WARN);
Here's where the messages go on different platforms:
- Windows: debug output stream
- Android: log output
- Others: standard error output (stderr) The predefined log categories
By default the application category is enabled at the INFO level, the assert category is enabled at the WARN level, test is enabled at the VERBOSE level and all other categories are enabled at the ERROR level.
- Since
- This enum is available since SDL 3.0.0.
Enumerator |
---|
SDL_LOG_CATEGORY_APPLICATION | |
SDL_LOG_CATEGORY_ERROR | |
SDL_LOG_CATEGORY_ASSERT | |
SDL_LOG_CATEGORY_SYSTEM | |
SDL_LOG_CATEGORY_AUDIO | |
SDL_LOG_CATEGORY_VIDEO | |
SDL_LOG_CATEGORY_RENDER | |
SDL_LOG_CATEGORY_INPUT | |
SDL_LOG_CATEGORY_TEST | |
SDL_LOG_CATEGORY_RESERVED1 | |
SDL_LOG_CATEGORY_RESERVED2 | |
SDL_LOG_CATEGORY_RESERVED3 | |
SDL_LOG_CATEGORY_RESERVED4 | |
SDL_LOG_CATEGORY_RESERVED5 | |
SDL_LOG_CATEGORY_RESERVED6 | |
SDL_LOG_CATEGORY_RESERVED7 | |
SDL_LOG_CATEGORY_RESERVED8 | |
SDL_LOG_CATEGORY_RESERVED9 | |
SDL_LOG_CATEGORY_RESERVED10 | |
SDL_LOG_CATEGORY_CUSTOM | |
Definition at line 63 of file SDL_log.h.
64{
74
75
86
87
88
89
90
91
92
93
94
@ SDL_LOG_CATEGORY_CUSTOM
@ SDL_LOG_CATEGORY_RESERVED1
@ SDL_LOG_CATEGORY_RESERVED8
@ SDL_LOG_CATEGORY_RESERVED6
@ SDL_LOG_CATEGORY_RENDER
@ SDL_LOG_CATEGORY_RESERVED5
@ SDL_LOG_CATEGORY_RESERVED3
@ SDL_LOG_CATEGORY_RESERVED9
@ SDL_LOG_CATEGORY_SYSTEM
@ SDL_LOG_CATEGORY_RESERVED10
@ SDL_LOG_CATEGORY_RESERVED4
@ SDL_LOG_CATEGORY_APPLICATION
@ SDL_LOG_CATEGORY_RESERVED7
@ SDL_LOG_CATEGORY_ASSERT
@ SDL_LOG_CATEGORY_RESERVED2
◆ SDL_LogPriority
The predefined log priorities
- Since
- This enum is available since SDL 3.0.0.
Enumerator |
---|
SDL_LOG_PRIORITY_VERBOSE | |
SDL_LOG_PRIORITY_DEBUG | |
SDL_LOG_PRIORITY_INFO | |
SDL_LOG_PRIORITY_WARN | |
SDL_LOG_PRIORITY_ERROR | |
SDL_LOG_PRIORITY_CRITICAL | |
SDL_NUM_LOG_PRIORITIES | |
Definition at line 103 of file SDL_log.h.
104{
@ SDL_LOG_PRIORITY_CRITICAL
@ SDL_LOG_PRIORITY_VERBOSE
◆ SDL_GetLogOutputFunction()
Get the current log output function.
- Parameters
-
callback | an SDL_LogOutputFunction filled in with the current log callback. |
userdata | a pointer filled in with the pointer that is passed to callback . |
- Since
- This function is available since SDL 3.0.0.
- See also
- SDL_SetLogOutputFunction
◆ SDL_GetLogPriority()
Get the priority of a particular log category.
- Parameters
-
category | the category to query. |
- Returns
- the SDL_LogPriority for the requested category.
- Since
- This function is available since SDL 3.0.0.
- See also
- SDL_SetLogPriority
◆ SDL_Log()
◆ SDL_LogCritical()
◆ SDL_LogDebug()
◆ SDL_LogError()
◆ SDL_LogInfo()
◆ SDL_LogMessage()
◆ SDL_LogMessageV()
◆ SDL_LogVerbose()
◆ SDL_LogWarn()
◆ SDL_ResetLogPriorities()
void SDL_ResetLogPriorities |
( |
void |
| ) |
|
|
extern |
◆ SDL_SetLogOutputFunction()
Replace the default log output function with one of your own.
- Parameters
-
callback | an SDL_LogOutputFunction to call instead of the default. |
userdata | a pointer that is passed to callback . |
- Since
- This function is available since SDL 3.0.0.
- See also
- SDL_GetLogOutputFunction
◆ SDL_SetLogPriorities()
◆ SDL_SetLogPriority()