gst/gstinfo.h

   1 /* GStreamer
   2  * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
   3  *                    2000 Wim Taymans <wtay@chello.be>
   4  *                    2003 Benjamin Otte <in7y118@public.uni-hamburg.de>
   5  *
   6  * gstinfo.h: debugging functions
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Library General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Library General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Library General Public
  19  * License along with this library; if not, write to the
  20  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  21  * Boston, MA 02111-1307, USA.
  22  */
  23
  24 #ifndef __GSTINFO_H__
  25 #define __GSTINFO_H__
  26
  27 #include <glib.h>
  28 #include <glib-object.h>
  29 #include <gst/gstatomic.h>
  30 #include <gst/gstlog.h>
  31 #include <gst/gstconfig.h>
  32
  33 G_BEGIN_DECLS
  34
  35 /*
  36  * GStreamer's debugging subsystem is an easy way to get information about what
  37  * the application is doing.
  38  * It is not meant for programming errors. Use GLibs methods (g_warning and so
  39  * on for that.
  40  */
  41
  42 /* log levels */
  43 typedef enum {
  44   GST_LEVEL_NONE = 0,
  45   GST_LEVEL_ERROR,
  46   GST_LEVEL_WARNING,
  47   GST_LEVEL_INFO,
  48   GST_LEVEL_DEBUG,
  49   GST_LEVEL_LOG,
  50   /* add more */
  51   GST_LEVEL_COUNT
  52 } GstDebugLevel;
  53
  54 /* we can now override this to be more general in maintainer builds or cvs checkouts */
  55 #ifndef GST_LEVEL_DEFAULT
  56 #define GST_LEVEL_DEFAULT GST_LEVEL_NONE
  57 #endif
  58
  59 /* defines for format (colors etc) - don't change them around, it uses terminal layout
  60  * Terminal color strings:
  61  * 00=none 01=bold 04=underscore 05=blink 07=reverse 08=concealed
  62  * Text color codes:
  63  * 30=black 31=red 32=green 33=yellow 34=blue 35=magenta 36=cyan 37=white
  64  * Background color codes:
  65  * 40=black 41=red 42=green 43=yellow 44=blue 45=magenta 46=cyan 47=white
  66  */
  67 typedef enum {
  68   /* colors */
  69   GST_DEBUG_FG_BLACK            = 0x0000,
  70   GST_DEBUG_FG_RED              = 0x0001,
  71   GST_DEBUG_FG_GREEN            = 0x0002,
  72   GST_DEBUG_FG_YELLOW           = 0x0003,
  73   GST_DEBUG_FG_BLUE             = 0x0004,
  74   GST_DEBUG_FG_MAGENTA          = 0x0005,
  75   GST_DEBUG_FG_CYAN             = 0x0006,
  76   GST_DEBUG_FG_WHITE            = 0x0007,
  77   /* background colors */
  78   GST_DEBUG_BG_BLACK            = 0x0000,
  79   GST_DEBUG_BG_RED              = 0x0010,
  80   GST_DEBUG_BG_GREEN            = 0x0020,
  81   GST_DEBUG_BG_YELLOW           = 0x0030,
  82   GST_DEBUG_BG_BLUE             = 0x0040,
  83   GST_DEBUG_BG_MAGENTA          = 0x0050,
  84   GST_DEBUG_BG_CYAN             = 0x0060,
  85   GST_DEBUG_BG_WHITE            = 0x0070,
  86   /* other formats */
  87   GST_DEBUG_BOLD                = 0x0100,
  88   GST_DEBUG_UNDERLINE           = 0x0200
  89 } GstDebugColorFlags;
  90
  91 #define GST_DEBUG_FG_MASK       (0x000F)
  92 #define GST_DEBUG_BG_MASK       (0x00F0)
  93 #define GST_DEBUG_FORMAT_MASK   (0xFF00)
  94
  95 typedef struct _GstDebugCategory GstDebugCategory;
  96 struct _GstDebugCategory {
  97   /*< private >*/
  98   GstAtomicInt *        threshold;
  99   guint                 color;          /* see defines above */
 100
 101   const gchar *         name;
 102   const gchar *         description;
 103 };
 104
 105 /********** some convenience macros for debugging **********/
 106
 107 #define GST_TEMP_STRING(str, statement) G_STMT_START { \
 108   char * str = NULL; \
 109   statement; \
 110   g_free( str ); \
 111 } G_STMT_END
 112
 113
 114
 115 /* This is needed in printf's if a char* might be NULL. Solaris crashes then */
 116 #define GST_STR_NULL(str) ((str) ? (str) : "(NULL)")
 117
 118 /* easier debugging for pad names */
 119 #define GST_DEBUG_PAD_NAME(pad) \
 120   (GST_OBJECT_PARENT(pad) != NULL) ? \
 121   GST_STR_NULL (GST_OBJECT_NAME (GST_OBJECT_PARENT(pad))) : \
 122   "''", GST_OBJECT_NAME (pad)
 123
 124 /* You might want to define GST_FUNCTION in apps' configure script */
 125
 126 #ifndef GST_FUNCTION
 127 #ifdef G_GNUC_PRETTY_FUNCTION
 128 #define GST_FUNCTION G_GNUC_PRETTY_FUNCTION
 129 #elif HAVE_FUNC
 130 #define GST_FUNCTION __func__
 131 #elif HAVE_PRETTY_FUNCTION
 132 #define GST_FUNCTION __PRETTY_FUNCTION__
 133 #elif HAVE_FUNCTION
 134 #define GST_FUNCTION __FUNCTION__
 135 #else
 136 #define GST_FUNCTION ""
 137 #endif
 138 #endif /* ifndef GST_FUNCTION */
 139
 140 typedef void (*GstLogFunction)  (GstDebugCategory *     category,
 141                                  GstDebugLevel          level,
 142                                  const gchar *          file,
 143                                  const gchar *          function,
 144                                  gint                   line,
 145                                  GObject *              object,
 146                                  gchar *                message,
 147                                  gpointer               data);
 148
 149 /* Disable this subsystem if no varargs macro can be found.
 150    Use a trick so the core builds the functions nonetheless if it wasn't
 151    explicitly disabled. */
 152 #if !defined(G_HAVE_ISO_VARARGS) && !defined(G_HAVE_GNUC_VARARGS)
 153 #define __GST_DISABLE_GST_DEBUG
 154 #endif
 155 #ifdef GST_DISABLE_GST_DEBUG
 156 #ifndef __GST_DISABLE_GST_DEBUG
 157 #define __GST_DISABLE_GST_DEBUG
 158 #endif
 159 #endif
 160
 161 #ifndef __GST_DISABLE_GST_DEBUG
 162
 163 void            _gst_debug_init                 (void);
 164
 165 void            gst_debug_log                   (GstDebugCategory *     category,
 166                                                  GstDebugLevel          level,
 167                                                  const gchar *          file,
 168                                                  const gchar *          function,
 169                                                  gint                   line,
 170                                                  GObject *              object,
 171                                                  gchar *                format,
 172                                                  ...)  G_GNUC_PRINTF (7, 8) G_GNUC_NO_INSTRUMENT;
 173 void            gst_debug_log_callback          (GstDebugCategory *     category,
 174                                                  GstDebugLevel          level,
 175                                                  const gchar *          file,
 176                                                  const gchar *          function,
 177                                                  gint                   line,
 178                                                  GObject *              object,
 179                                                  char *                 (*callback)(gpointer callback_arg),
 180                                                  gpointer               callback_arg,
 181                                                  gchar *                format,
 182                                                  ...)  G_GNUC_PRINTF (9, 10) G_GNUC_NO_INSTRUMENT;
 183 void            gst_debug_log_valist            (GstDebugCategory *     category,
 184                                                  GstDebugLevel          level,
 185                                                  const gchar *          file,
 186                                                  const gchar *          function,
 187                                                  gint                   line,
 188                                                  GObject *              object,
 189                                                  gchar *                format,
 190                                                  va_list                args) G_GNUC_NO_INSTRUMENT;
 191
 192 void            gst_debug_log_default           (GstDebugCategory *     category,
 193                                                  GstDebugLevel          level,
 194                                                  const gchar *          file,
 195                                                  const gchar *          function,
 196                                                  gint                   line,
 197                                                  GObject *              object,
 198                                                  gchar *                message,
 199                                                  gpointer               unused) G_GNUC_NO_INSTRUMENT;
 200
 201 G_CONST_RETURN gchar *
 202                 gst_debug_level_get_name        (GstDebugLevel          level);
 203
 204 void            gst_debug_add_log_function      (GstLogFunction         func,
 205                                                  gpointer data);
 206 guint           gst_debug_remove_log_function   (GstLogFunction         func);
 207 guint           gst_debug_remove_log_function_by_data (gpointer         data);
 208
 209 void            gst_debug_set_active            (gboolean active);
 210 gboolean        gst_debug_is_active             (void);
 211
 212 void            gst_debug_set_colored           (gboolean colored);
 213 gboolean        gst_debug_is_colored            (void);
 214
 215 void            gst_debug_set_default_threshold (GstDebugLevel          level);
 216 GstDebugLevel   gst_debug_get_default_threshold (void);
 217 void            gst_debug_set_threshold_for_name (const gchar *         name,
 218                                                  GstDebugLevel          level);
 219 void            gst_debug_unset_threshold_for_name (const gchar *       name);
 220
 221 /**
 222  * GST_DEBUG_CATEGORY:
 223  * @cat: the category
 224  *
 225  * Defines a GstCategory variable.
 226  * This macro expands to nothing if debugging is disabled.
 227  */
 228 #define GST_DEBUG_CATEGORY(cat) GstDebugCategory *cat = NULL
 229 /**
 230  * GST_DEBUG_CATEGORY_EXTERN:
 231  * @cat: the category
 232  *
 233  * Defines an extern GstCategory variable. Use in header files.
 234  * This macro expands to nothing if debugging is disabled.
 235  */
 236 #define GST_DEBUG_CATEGORY_EXTERN(cat) extern GstDebugCategory *cat
 237 /**
 238  * GST_DEBUG_CATEGORY_STATIC:
 239  * @cat: the category
 240  *
 241  * Defines a static GstCategory variable.
 242  * This macro expands to nothing if debugging is disabled.
 243  */
 244 #define GST_DEBUG_CATEGORY_STATIC(cat) static GstDebugCategory *cat = NULL
 245 /* do not use this function, use the macros below */
 246 GstDebugCategory *_gst_debug_category_new       (gchar *                name,
 247                                                  guint                  color,
 248                                                  gchar *                description);
 249 /**
 250  * GST_DEBUG_CATEGORY_INIT:
 251  * @cat: the category to initialize.
 252  * @name: the name of the category.
 253  * @color: the colors to use for a color representation or 0 for no color.
 254  * @description: optional description of the category.
 255  *
 256  * Initializes a new #GstDebugCategory with the given properties and set to
 257  * the default threshold.
 258  *
 259  * <note>
 260  * <para>
 261  * This macro expands to nothing if debugging is disabled.
 262  * </para>
 263  * <para>
 264  * When naming your category, please follow the following conventions to ensure
 265  * that the pattern matching for categories works as expected. It is not
 266  * earth-shattering if you don't follow these conventions, but it would be nice
 267  * for everyone.
 268  * </para>
 269  * <para>
 270  * If you define a category for a plugin or a feature of it, name the category
 271  * like the feature. So if you wanted to write a "filesrc" element, you would
 272  * name the category "filesrc". Use lowercase letters only.
 273  * If you define more than one category for the same element, append an
 274  * underscore and an identifier to your categories, like this: "filesrc_cache"
 275  * </para>
 276  * <para>
 277  * If you create a library or an application using debugging categories, use a
 278  * common prefix followed by an underscore for all your categories. GStreamer
 279  * uses the GST prefix so GStreamer categories look like "GST_STATES". Be sure
 280  * to include uppercase letters.
 281  * </para>
 282  * </note>
 283  */
 284 #define GST_DEBUG_CATEGORY_INIT(cat,name,color,description) G_STMT_START{       \
 285   if (cat == NULL)                                                              \
 286     cat = _gst_debug_category_new (name,color,description);                     \
 287 }G_STMT_END
 288
 289 void            gst_debug_category_free         (GstDebugCategory *     category);
 290 void            gst_debug_category_set_threshold (GstDebugCategory *    category,
 291                                                  GstDebugLevel          level);
 292 void            gst_debug_category_reset_threshold (GstDebugCategory *  category);
 293 GstDebugLevel   gst_debug_category_get_threshold (GstDebugCategory *    category);
 294 G_CONST_RETURN gchar *
 295                 gst_debug_category_get_name     (GstDebugCategory *     category);
 296 guint           gst_debug_category_get_color    (GstDebugCategory *     category);
 297 G_CONST_RETURN gchar *
 298                 gst_debug_category_get_description (GstDebugCategory *  category);
 299 GSList *        gst_debug_get_all_categories    (void);
 300
 301 gchar *         gst_debug_construct_term_color  (guint colorinfo);
 302
 303
 304 extern GstDebugCategory *       GST_CAT_DEFAULT;
 305 /* this symbol may not be used */
 306 extern gboolean                 __gst_debug_enabled;
 307 #ifdef G_HAVE_ISO_VARARGS
 308 #define GST_CAT_LEVEL_LOG(cat,level,object,...) G_STMT_START{                   \
 309   if (__gst_debug_enabled) {                            \
 310     gst_debug_log ((cat), (level), __FILE__, GST_FUNCTION, __LINE__, (GObject *) (object), __VA_ARGS__); \
 311   }                                                                             \
 312 }G_STMT_END
 313 #else /* G_HAVE_GNUC_VARARGS */
 314 #define GST_CAT_LEVEL_LOG(cat,level,object,args...) G_STMT_START{                       \
 315   if (__gst_debug_enabled) {                            \
 316     gst_debug_log ((cat), (level), __FILE__, GST_FUNCTION, __LINE__, (GObject *) (object), ##args ); \
 317   }                                                                             \
 318 }G_STMT_END
 319 #endif /* G_HAVE_ISO_VARARGS */
 320
 321 #ifndef GST_DEBUG_ENABLE_DEPRECATED
 322
 323 #ifdef G_HAVE_ISO_VARARGS
 324
 325 #define GST_CAT_ERROR_OBJECT(cat,obj,...)       GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   obj,  __VA_ARGS__)
 326 #define GST_CAT_WARNING_OBJECT(cat,obj,...)     GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, obj,  __VA_ARGS__)
 327 #define GST_CAT_INFO_OBJECT(cat,obj,...)        GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    obj,  __VA_ARGS__)
 328 #define GST_CAT_DEBUG_OBJECT(cat,obj,...)       GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   obj,  __VA_ARGS__)
 329 #define GST_CAT_LOG_OBJECT(cat,obj,...)         GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     obj,  __VA_ARGS__)
 330
 331 #define GST_CAT_ERROR(cat,...)                  GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   NULL, __VA_ARGS__)
 332 #define GST_CAT_WARNING(cat,...)                GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, NULL, __VA_ARGS__)
 333 #define GST_CAT_INFO(cat,...)                   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
 334 #define GST_CAT_DEBUG(cat,...)                  GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
 335 #define GST_CAT_LOG(cat,...)                    GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     NULL, __VA_ARGS__)
 336
 337 #define GST_ERROR_OBJECT(obj,...)       GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   obj,  __VA_ARGS__)
 338 #define GST_WARNING_OBJECT(obj,...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj,  __VA_ARGS__)
 339 #define GST_INFO_OBJECT(obj,...)        GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj,  __VA_ARGS__)
 340 #define GST_DEBUG_OBJECT(obj,...)       GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj,  __VA_ARGS__)
 341 #define GST_LOG_OBJECT(obj,...)         GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     obj,  __VA_ARGS__)
 342
 343 #define GST_ERROR(...)                  GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   NULL, __VA_ARGS__)
 344 #define GST_WARNING(...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, __VA_ARGS__)
 345 #define GST_INFO(...)                   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
 346 #define GST_DEBUG(...)                  GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
 347 #define GST_LOG(...)                    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     NULL, __VA_ARGS__)
 348
 349 #else /* G_HAVE_GNUC_VARARGS */
 350
 351 #define GST_CAT_ERROR_OBJECT(cat,obj,args...)   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   obj,  ##args )
 352 #define GST_CAT_WARNING_OBJECT(cat,obj,args...) GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, obj,  ##args )
 353 #define GST_CAT_INFO_OBJECT(cat,obj,args...)    GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    obj,  ##args )
 354 #define GST_CAT_DEBUG_OBJECT(cat,obj,args...)   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   obj,  ##args )
 355 #define GST_CAT_LOG_OBJECT(cat,obj,args...)     GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     obj,  ##args )
 356
 357 #define GST_CAT_ERROR(cat,args...)              GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   NULL, ##args )
 358 #define GST_CAT_WARNING(cat,args...)            GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, NULL, ##args )
 359 #define GST_CAT_INFO(cat,args...)               GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    NULL, ##args )
 360 #define GST_CAT_DEBUG(cat,args...)              GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   NULL, ##args )
 361 #define GST_CAT_LOG(cat,args...)                GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     NULL, ##args )
 362
 363 #define GST_ERROR_OBJECT(obj,args...)   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   obj,  ##args )
 364 #define GST_WARNING_OBJECT(obj,args...) GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj,  ##args )
 365 #define GST_INFO_OBJECT(obj,args...)    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj,  ##args )
 366 #define GST_DEBUG_OBJECT(obj,args...)   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj,  ##args )
 367 #define GST_LOG_OBJECT(obj,args...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     obj,  ##args )
 368
 369 #define GST_ERROR(args...)              GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   NULL, ##args )
 370 #define GST_WARNING(args...)            GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, ##args )
 371 #define GST_INFO(args...)               GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, ##args )
 372 #define GST_DEBUG(args...)              GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, ##args )
 373 #define GST_LOG(args...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     NULL, ##args )
 374
 375 #endif /* G_HAVE_ISO_VARARGS */
 376
 377 #else /* GST_DEBUG_ENABLE_DEPRECATED */
 378 /* This is a workaround so the old debugging stuff of GStreamer 0.6 works.
 379    This is undocumented and will go when 0.8 comes out. */
 380
 381 #ifdef G_HAVE_ISO_VARARGS
 382 #  define GST_INFO(cat,...)                     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
 383 #  define GST_DEBUG(cat,...)                    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
 384 #  define GST_INFO_ELEMENT(cat,obj,...)         GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj, __VA_ARGS__)
 385 #  define GST_DEBUG_ELEMENT(cat,obj,...)        GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj, __VA_ARGS__)
 386 #  define GST_DEBUG_ENTER(...)                  GST_DEBUG ("entering: " __VA_ARGS__ )
 387 #  define GST_DEBUG_LEAVE(...)                  GST_DEBUG ("leaving: "  __VA_ARGS__ )
 388 #  define GST_INFO_ENTER(...)                   GST_INFO ("entering: " __VA_ARGS__ )
 389 #  define GST_INFO_LEAVE(...)                   GST_INFO ("leaving: "  __VA_ARGS__ )
 390 #else /* G_HAVE_GNUC_VARARGS */
 391 #  define GST_INFO(cat,args...)                 GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, ##args )
 392 #  define GST_DEBUG(cat,args...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, ##args )
 393 #  define GST_INFO_ELEMENT(cat,obj,args...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj, ##args )
 394 #  define GST_DEBUG_ELEMENT(cat,obj,args...)    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj, ##args )
 395 #  define GST_DEBUG_ENTER(args...)              GST_DEBUG ("entering: " ##args )
 396 #  define GST_DEBUG_LEAVE(args...)              GST_DEBUG ("leaving: "  ##args )
 397 #  define GST_INFO_ENTER(args...)               GST_INFO ("entering: " ##args )
 398 #  define GST_INFO_LEAVE(args...)               GST_INFO ("leaving: "  ##args )
 399 #endif /* G_HAVE_ISO_VARARGS */
 400
 401 #endif /* !GST_DEBUG_ENABLE_DEPRECATED */
 402
 403
 404 /********** function pointer stuff **********/
 405 void*           _gst_debug_register_funcptr     (void *                 ptr,
 406                                                  gchar *                ptrname);
 407 G_CONST_RETURN gchar*
 408                 _gst_debug_nameof_funcptr       (void *                 ptr);
 409
 410 #define GST_DEBUG_FUNCPTR(ptr) (_gst_debug_register_funcptr((void *)(ptr), #ptr) , ptr)
 411 #define GST_DEBUG_FUNCPTR_NAME(ptr) _gst_debug_nameof_funcptr((void *)ptr)
 412
 413 #else /* GST_DISABLE_GST_DEBUG */
 414
 415 #ifdef __GNUC__
 416 #  pragma GCC poison gst_debug_log
 417 #  pragma GCC poison gst_debug_log_valist
 418 #  pragma GCC poison gst_debug_log_default
 419 #  pragma GCC poison _gst_debug_category_new
 420 #endif
 421
 422 #define _gst_debug_init()                               /* NOP */
 423
 424 #define gst_debug_set_log_function(func,data)           /* NOP */
 425 #define gst_debug_reset_log_function(void)              /* NOP */
 426 #define gst_debug_set_default_threshold(level)          /* NOP */
 427 #define gst_debug_get_default_threshold()               (GST_LEVEL_NONE)
 428 #define gst_debug_category_set_threshold_for_name(name, level) /* NOP */
 429 #define gst_debug_category_unset_threshold_for_name(name) /* NOP */
 430
 431 #define gst_debug_level_get_name(level)                 ("NONE")
 432 #define gst_debug_add_log_function(func,data)           (FALSE)
 433 #define gst_debug_remove_log_function(func)             (0)
 434 #define gst_debug_remove_log_function_by_data(data)     (0)
 435 #define gst_debug_set_active(active)                    /* NOP */
 436 #define gst_debug_is_active()                           (FALSE)
 437 #define gst_debug_set_colored(colored)                  /* NOP */
 438 #define gst_debug_is_colored()                          (FALSE)
 439 #define gst_debug_set_default_threshold(level)          /* NOP */
 440 #define gst_debug_get_default_threshold()               (GST_LEVEL_NONE)
 441 #define gst_debug_set_threshold_for_name(name,level)    /* NOP */
 442 #define gst_debug_unset_threshold_for_name(name)        /* NOP */
 443
 444 #define GST_DEBUG_CATEGORY(var)                         /* NOP */
 445 #define GST_DEBUG_CATEGORY_EXTERN(var)                  /* NOP */
 446 #define GST_DEBUG_CATEGORY_STATIC(var)                  /* NOP */
 447 #define GST_DEBUG_CATEGORY_INIT(var,name,color,desc)    /* NOP */
 448 #define gst_debug_category_free(category)               /* NOP */
 449 #define gst_debug_category_set_threshold(category,level) /* NOP */
 450 #define gst_debug_category_reset_threshold(category)    /* NOP */
 451 #define gst_debug_category_get_threshold(category)      (GST_LEVEL_NONE)
 452 #define gst_debug_category_get_name(cat)                ("")
 453 #define gst_debug_category_get_color(cat)               (0)
 454 #define gst_debug_category_get_description(cat)         ("")
 455 #define gst_debug_get_all_categories()                  (NULL)
 456 #define gst_debug_construct_term_color(colorinfo)       (g_strdup ("00"))
 457
 458 #ifdef G_HAVE_ISO_VARARGS
 459
 460 #define GST_CAT_LEVEL_LOG(cat,level,...)                /* NOP */
 461
 462 #define GST_CAT_ERROR_OBJECT(...)                       /* NOP */
 463 #define GST_CAT_WARNING_OBJECT(...)                     /* NOP */
 464 #define GST_CAT_INFO_OBJECT(...)                        /* NOP */
 465 #define GST_CAT_DEBUG_OBJECT(...)                       /* NOP */
 466 #define GST_CAT_LOG_OBJECT(...)                         /* NOP */
 467
 468 #define GST_CAT_ERROR(...)                              /* NOP */
 469 #define GST_CAT_WARNING(...)                            /* NOP */
 470 #define GST_CAT_INFO(...)                               /* NOP */
 471 #define GST_CAT_DEBUG(...)                              /* NOP */
 472 #define GST_CAT_LOG(...)                                /* NOP */
 473
 474 #define GST_ERROR_OBJECT(...)                           /* NOP */
 475 #define GST_WARNING_OBJECT(...)                         /* NOP */
 476 #define GST_INFO_OBJECT(...)                            /* NOP */
 477 #define GST_DEBUG_OBJECT(...)                           /* NOP */
 478 #define GST_LOG_OBJECT(...)                             /* NOP */
 479
 480 #define GST_ERROR(...)                                  /* NOP */
 481 #define GST_WARNING(...)                                /* NOP */
 482 #define GST_INFO(...)                                   /* NOP */
 483 #define GST_DEBUG(...)                                  /* NOP */
 484 #define GST_LOG(...)                                    /* NOP */
 485
 486 #ifdef GST_DEBUG_ENABLE_DEPRECATED
 487 #define GST_INFO_ELEMENT(cat,obj,...) /* NOP */
 488 #define GST_DEBUG_ELEMENT(cat,obj,...) /* NOP */
 489 #define GST_DEBUG_ENTER(...) /* NOP */
 490 #define GST_DEBUG_LEAVE(...) /* NOP */
 491 #define GST_INFO_ENTER(...) /* NOP */
 492 #define GST_INFO_LEAVE(...) /* NOP */
 493 #endif /* GST_DEBUG_ENABLE_DEPRECATED */
 494
 495 #else /* !G_HAVE_ISO_VARARGS */
 496
 497 #define GST_CAT_LEVEL_LOG(cat,level,args...)            /* NOP */
 498
 499 #define GST_CAT_ERROR_OBJECT(args...)                   /* NOP */
 500 #define GST_CAT_WARNING_OBJECT(args...)                 /* NOP */
 501 #define GST_CAT_INFO_OBJECT(args...)                    /* NOP */
 502 #define GST_CAT_DEBUG_OBJECT(args...)                   /* NOP */
 503 #define GST_CAT_LOG_OBJECT(args...)                     /* NOP */
 504
 505 #define GST_CAT_ERROR(args...)                          /* NOP */
 506 #define GST_CAT_WARNING(args...)                        /* NOP */
 507 #define GST_CAT_INFO(args...)                           /* NOP */
 508 #define GST_CAT_DEBUG(args...)                          /* NOP */
 509 #define GST_CAT_LOG(args...)                            /* NOP */
 510
 511 #define GST_ERROR_OBJECT(args...)                       /* NOP */
 512 #define GST_WARNING_OBJECT(args...)                     /* NOP */
 513 #define GST_INFO_OBJECT(args...)                        /* NOP */
 514 #define GST_DEBUG_OBJECT(args...)                       /* NOP */
 515 #define GST_LOG_OBJECT(args...)                         /* NOP */
 516
 517 #define GST_ERROR(args...)                              /* NOP */
 518 #define GST_WARNING(args...)                            /* NOP */
 519 #define GST_INFO(args...)                               /* NOP */
 520 #define GST_DEBUG(args...)                              /* NOP */
 521 #define GST_LOG(args...)                                /* NOP */
 522
 523 #ifdef GST_DEBUG_ENABLE_DEPRECATED
 524 #define GST_INFO_ELEMENT(cat,obj,args...) /* NOP */
 525 #define GST_DEBUG_ELEMENT(cat,obj,args...) /* NOP */
 526 #define GST_DEBUG_ENTER(args...) /* NOP */
 527 #define GST_DEBUG_LEAVE(args...) /* NOP */
 528 #define GST_INFO_ENTER(args...) /* NOP */
 529 #define GST_INFO_LEAVE(args...) /* NOP */
 530 #endif /* GST_DEBUG_ENABLE_DEPRECATED */
 531
 532 #endif /* G_HAVE_ISO_VARARGS */
 533
 534 #define GST_DEBUG_FUNCPTR(ptr) (ptr)
 535 #define GST_DEBUG_FUNCPTR_NAME(ptr) (g_strdup_printf ("%p", ptr))
 536
 537 #endif /* GST_DISABLE_GST_DEBUG */
 538
 539 void gst_debug_print_stack_trace (void);
 540
 541 G_END_DECLS
 542
 543 #endif /* __GSTINFO_H__ */