TRACE (3alleg4)

#include <allegro.h>

void TRACE(char *msg, ...);

Debugging helper macro. Normally compiles away to nothing, but if you defined the preprocessor symbol DEBUGMODE before including Allegro headers, it passes the supplied message given in ASCII format to al_trace(). Example:

   #define DEBUGMODE
   #include
   ...
   void my_blitter(BITMAP *source, int flags)
   {
      static int count_call = 0;
      TRACE("my_blitter() called %d times.\n", count_call++);
      ...
   }

al_trace(3alleg4), ASSERT(3alleg4), register_trace_handler(3alleg4)