libs/pbd/pbd/debug.h

   1 /*
   2     Copyright (C) 2009 Paul Davis
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17
  18 */
  19
  20 #ifndef __libpbd_debug_h__
  21 #define __libpbd_debug_h__
  22
  23 #include <bitset>
  24 #include <stdint.h>
  25
  26 #include <sstream>
  27
  28 #include "pbd/libpbd_visibility.h"
  29 #include "pbd/timing.h"
  30
  31 namespace PBD {
  32
  33         typedef std::bitset<64> DebugBits;
  34
  35         LIBPBD_API extern DebugBits debug_bits;
  36         LIBPBD_API DebugBits new_debug_bit (const char* name);
  37         LIBPBD_API void debug_print (const char* prefix, std::string str);
  38         LIBPBD_API void set_debug_bits (DebugBits bits);
  39         LIBPBD_API int parse_debug_options (const char* str);
  40         LIBPBD_API void list_debug_options ();
  41
  42         namespace DEBUG {
  43
  44                 /* this namespace is so that we can write DEBUG::bit_name */
  45
  46                 LIBPBD_API extern DebugBits Stateful;
  47                 LIBPBD_API extern DebugBits Properties;
  48                 LIBPBD_API extern DebugBits FileManager;
  49                 LIBPBD_API extern DebugBits Pool;
  50                 LIBPBD_API extern DebugBits EventLoop;
  51                 LIBPBD_API extern DebugBits AbstractUI;
  52                 LIBPBD_API extern DebugBits Configuration;
  53                 LIBPBD_API extern DebugBits FileUtils;
  54
  55                 /* See notes in ../debug.cc on why these are defined here */
  56
  57                 LIBPBD_API extern DebugBits WavesMIDI;
  58                 LIBPBD_API extern DebugBits WavesAudio;
  59         }
  60 }
  61
  62 #ifndef NDEBUG
  63 #define DEBUG_TRACE(bits,str) if (((bits) & PBD::debug_bits).any()) { PBD::debug_print (# bits, str); }
  64 #define DEBUG_STR_DECL(id) std::stringstream __debug_str ## id;
  65 #define DEBUG_STR(id) __debug_str ## id
  66 #define DEBUG_STR_APPEND(id,s) __debug_str ## id << s;
  67 #define DEBUG_ENABLED(bits) (((bits) & PBD::debug_bits).any())
  68 #ifdef PTW32_VERSION
  69 #define DEBUG_THREAD_SELF pthread_self().p
  70 #else
  71 #define DEBUG_THREAD_SELF pthread_self()
  72 #endif
  73
  74 #define DEBUG_TIMING_START(bits,td) if (DEBUG_ENABLED (bits)) { td.start_timing (); }
  75 #define DEBUG_TIMING_ADD_ELAPSED(bits,td) if (DEBUG_ENABLED (bits)) { td.add_elapsed (); }
  76 #define DEBUG_TIMING_RESET(bits,td) if (DEBUG_ENABLED (bits)) { td.reset (); }
  77
  78 #else
  79 #define DEBUG_TRACE(bits,fmt,...) /*empty*/
  80 #define DEBUG_STR(a) /* empty */
  81 #define DEBUG_STR_APPEND(a,b) /* empty */
  82 #define DEBUG_ENABLED(b) (0)
  83 #define DEBUG_THREAD_SELF 0
  84
  85 #define DEBUG_TIMING_START(bits,td) /*empty*/
  86 #define DEBUG_TIMING_ADD_ELAPSED(bits,td) /*empty*/
  87 #define DEBUG_TIMING_RESET(bits,td) /*empty*/
  88
  89 #endif
  90 #endif /* __libpbd_debug_h__ */
  91