register_trace_handler(3alleg4) debian man page | unix.com

register_trace_handler(3alleg4) 				  Allegro manual				   register_trace_handler(3alleg4)

NAME
       register_trace_handler - Registers a custom handler for trace output. Allegro game programming library.

SYNOPSIS
       #include <allegro.h>

       void register_trace_handler(int (*handler)(const char *msg));

DESCRIPTION
       Supplies  a  custom  handler  function  for dealing with trace output. Your callback will be passed a formatted error message in ASCII, and
       should return non-zero if it has processed the message, or zero to continue with the default actions. You could use this  to  ignore  trace
       output,	or  to	display  the  messages on a second monochrome monitor, etc. You can call this function even when Allegro has not been ini-
       tialised. Example:

	  int network_broadcaster(const char *text)
	  {
	     int f;

	     for (int f = 0; f
		send_msg_to_client(client[f], text);

	     return 0; /* Let normal tracing occur. */
	  }
	  ...
	     register_trace_handler(network_broadcaster);
	     TRACE("Networked tracing activated
");

SEE ALSO
       al_trace(3alleg4), TRACE(3alleg4), register_assert_handler(3alleg4)

Allegro 							   version 4.4.2				   register_trace_handler(3alleg4)