Wiki Page Content

Differences between revisions 4 and 5
Revision 4 as of 2011-11-09 23:51:04
Size: 1699
Editor: SheenaSmith
Comment: update content for consistency - callback param
Revision 5 as of 2013-08-08 20:04:08
Size: 1651
Editor: Sam Lantinga
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
||<tablewidth="100%" style="color: #FF0000;" :> DRAFT||
Line 35: Line 34:
 ||`category`||^the log category to query ???^||
 ||`priority`||the [[SDL_LogPriority]] ^to query^; see [[#priority|below]] for details||
 ||`message`||^the log output message ???^||
 ||`category`||the category of the message; see [[#category|Remarks]] for details||
 ||`priority`||the priority of the message; see [[#priority|Remarks]] for details||
 ||`message`||the message being output||

 <<Anchor(category)>>
 The `category` will be one of:
 <<Include(SDL_LOG_CATEGORY, , , from="== Values ==", to="== Code Examples ==")>>
Line 39: Line 43:
 . `priority` may be one of the following ^or NULL ???^:  The `priority` will be one of:
Line 41: Line 45:

 <<Color2(green,Should there be some reference to [[SDL_LOG_CATEGORY]] for `category`?)>>


''You can add useful comments here''

SDL_LogSetOutputFunction

Use this function to replace the default log output function with one of your own.

Syntax

void SDL_LogSetOutputFunction(SDL_LogOutputFunction callback,
                              void*                 userdata)

Function Parameters

callback

the function to call instead of the default; see Remarks for details

userdata

a pointer that is passed to callback

Code Examples

You can add your code example here

Remarks

The function prototype for callback is:

  • void* SDL_LogOutputFunction(void*           userdata,
                                int             category,
                                SDL_LogPriority priority,
                                const char*     message)
  • where its parameters are:

    userdata

    what was passed as userdata to SDL_LogSetOutputFunction()

    category

    the category of the message; see Remarks for details

    priority

    the priority of the message; see Remarks for details

    message

    the message being output

    The category will be one of:

    SDL_LOG_CATEGORY_APPLICATION

    application log

    SDL_LOG_CATEGORY_ERROR

    error log

    SDL_LOG_CATEGORY_ASSERT

    assert log

    SDL_LOG_CATEGORY_SYSTEM

    system log

    SDL_LOG_CATEGORY_AUDIO

    audio log

    SDL_LOG_CATEGORY_VIDEO

    video log

    SDL_LOG_CATEGORY_RENDER

    render log

    SDL_LOG_CATEGORY_INPUT

    input log

    SDL_LOG_CATEGORY_TEST

    test log

    SDL_LOG_CATEGORY_RESERVED#

    # = 1-10; reserved for future SDL library use

    SDL_LOG_CATEGORY_CUSTOM

    reserved for application use; see Remarks for details

    The priority will be one of:

    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

    (internal use)


CategoryAPI, CategoryLog

None: SDL_LogSetOutputFunction (last edited 2014-01-06 18:15:19 by JonathanDearborn)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit