My Project
|
Go to the source code of this file.
Macros | |
#define | SDL_MAX_LOG_MESSAGE 4096 |
The maximum size of a log message prior to SDL 2.0.24. | |
Typedefs | |
typedef void(SDLCALL * | SDL_LogOutputFunction) (void *userdata, int category, SDL_LogPriority priority, const char *message) |
Enumerations | |
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 } |
The predefined log categories. More... | |
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 } |
The predefined log priorities. | |
Functions | |
DECLSPEC void SDLCALL | SDL_LogSetAllPriority (SDL_LogPriority priority) |
DECLSPEC void SDLCALL | SDL_LogSetPriority (int category, SDL_LogPriority priority) |
DECLSPEC SDL_LogPriority SDLCALL | SDL_LogGetPriority (int category) |
DECLSPEC void SDLCALL | SDL_LogResetPriorities (void) |
DECLSPEC void SDLCALL | SDL_Log (SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(1) |
DECLSPEC void SDLCALL | SDL_LogVerbose (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
DECLSPEC void SDLCALL | SDL_LogDebug (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
DECLSPEC void SDLCALL | SDL_LogInfo (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
DECLSPEC void SDLCALL | SDL_LogWarn (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
DECLSPEC void SDLCALL | SDL_LogError (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
DECLSPEC void SDLCALL | SDL_LogCritical (int category, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(2) |
DECLSPEC void SDLCALL | SDL_LogMessage (int category, SDL_LogPriority priority, SDL_PRINTF_FORMAT_STRING const char *fmt,...) SDL_PRINTF_VARARG_FUNC(3) |
DECLSPEC void SDLCALL | SDL_LogMessageV (int category, SDL_LogPriority priority, const char *fmt, va_list ap) |
DECLSPEC void SDLCALL | SDL_LogGetOutputFunction (SDL_LogOutputFunction *callback, void **userdata) |
DECLSPEC void SDLCALL | SDL_LogSetOutputFunction (SDL_LogOutputFunction callback, void *userdata) |
Simple log messages with categories and priorities.
By default logs are quiet, but if you're debugging SDL you might want:
SDL_LogSetAllPriority(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)
#define SDL_MAX_LOG_MESSAGE 4096 |
The maximum size of a log message prior to SDL 2.0.24.
As of 2.0.24 there is no limit to the length of SDL log messages.
typedef void(SDLCALL * 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.
userdata | what was passed as userdata to SDL_LogSetOutputFunction() |
category | the category of the message |
priority | the priority of the message |
message | the message being output |
enum SDL_LogCategory |
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 CRITICAL level.
DECLSPEC void SDLCALL SDL_Log | ( | SDL_PRINTF_FORMAT_STRING const char * | fmt, |
... | |||
) |
Log a message with SDL_LOG_CATEGORY_APPLICATION and SDL_LOG_PRIORITY_INFO.
= *
fmt | a printf() style message format string |
... | additional parameters matching % tokens in the fmt string, if any |
DECLSPEC void SDLCALL SDL_LogCritical | ( | int | category, |
SDL_PRINTF_FORMAT_STRING const char * | fmt, | ||
... | |||
) |
Log a message with SDL_LOG_PRIORITY_CRITICAL.
category | the category of the message |
fmt | a printf() style message format string |
... | additional parameters matching % tokens in the fmt string, if any |
DECLSPEC void SDLCALL SDL_LogDebug | ( | int | category, |
SDL_PRINTF_FORMAT_STRING const char * | fmt, | ||
... | |||
) |
Log a message with SDL_LOG_PRIORITY_DEBUG.
category | the category of the message |
fmt | a printf() style message format string |
... | additional parameters matching % tokens in the fmt string, if any |
DECLSPEC void SDLCALL SDL_LogError | ( | int | category, |
SDL_PRINTF_FORMAT_STRING const char * | fmt, | ||
... | |||
) |
Log a message with SDL_LOG_PRIORITY_ERROR.
category | the category of the message |
fmt | a printf() style message format string |
... | additional parameters matching % tokens in the fmt string, if any |
DECLSPEC void SDLCALL SDL_LogGetOutputFunction | ( | SDL_LogOutputFunction * | callback, |
void ** | userdata | ||
) |
Get the current log output function.
callback | an SDL_LogOutputFunction filled in with the current log callback |
userdata | a pointer filled in with the pointer that is passed to callback |
DECLSPEC SDL_LogPriority SDLCALL SDL_LogGetPriority | ( | int | category | ) |
Get the priority of a particular log category.
category | the category to query |
DECLSPEC void SDLCALL SDL_LogInfo | ( | int | category, |
SDL_PRINTF_FORMAT_STRING const char * | fmt, | ||
... | |||
) |
Log a message with SDL_LOG_PRIORITY_INFO.
category | the category of the message |
fmt | a printf() style message format string |
... | additional parameters matching % tokens in the fmt string, if any |
DECLSPEC void SDLCALL SDL_LogMessage | ( | int | category, |
SDL_LogPriority | priority, | ||
SDL_PRINTF_FORMAT_STRING const char * | fmt, | ||
... | |||
) |
Log a message with the specified category and priority.
category | the category of the message |
priority | the priority of the message |
fmt | a printf() style message format string |
... | additional parameters matching % tokens in the fmt string, if any |
DECLSPEC void SDLCALL SDL_LogMessageV | ( | int | category, |
SDL_LogPriority | priority, | ||
const char * | fmt, | ||
va_list | ap | ||
) |
Log a message with the specified category and priority.
category | the category of the message |
priority | the priority of the message |
fmt | a printf() style message format string |
ap | a variable argument list |
DECLSPEC void SDLCALL SDL_LogResetPriorities | ( | void | ) |
Reset all priorities to default.
This is called by SDL_Quit().
DECLSPEC void SDLCALL SDL_LogSetAllPriority | ( | SDL_LogPriority | priority | ) |
Set the priority of all log categories.
priority | the SDL_LogPriority to assign |
DECLSPEC void SDLCALL SDL_LogSetOutputFunction | ( | SDL_LogOutputFunction | callback, |
void * | userdata | ||
) |
Replace the default log output function with one of your own.
callback | an SDL_LogOutputFunction to call instead of the default |
userdata | a pointer that is passed to callback |
DECLSPEC void SDLCALL SDL_LogSetPriority | ( | int | category, |
SDL_LogPriority | priority | ||
) |
Set the priority of a particular log category.
category | the category to assign a priority to |
priority | the SDL_LogPriority to assign |
DECLSPEC void SDLCALL SDL_LogVerbose | ( | int | category, |
SDL_PRINTF_FORMAT_STRING const char * | fmt, | ||
... | |||
) |
Log a message with SDL_LOG_PRIORITY_VERBOSE.
category | the category of the message |
fmt | a printf() style message format string |
... | additional parameters matching % tokens in the fmt string, if any |
DECLSPEC void SDLCALL SDL_LogWarn | ( | int | category, |
SDL_PRINTF_FORMAT_STRING const char * | fmt, | ||
... | |||
) |
Log a message with SDL_LOG_PRIORITY_WARN.
category | the category of the message |
fmt | a printf() style message format string |
... | additional parameters matching % tokens in the fmt string, if any |