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 /* This is needed in printf's if a char* might be NULL. Solaris crashes then */
 108 #define GST_STR_NULL(str) ((str) ? (str) : "(NULL)")
 109
 110 /* easier debugging for pad names */
 111 #define GST_DEBUG_PAD_NAME(pad) \
 112   (GST_OBJECT_PARENT(pad) != NULL) ? \
 113   GST_STR_NULL (GST_OBJECT_NAME (GST_OBJECT_PARENT(pad))) : \
 114   "''", GST_OBJECT_NAME (pad)
 115
 116 /* You might want to define GST_FUNCTION in apps' configure script */
 117
 118 #ifndef GST_FUNCTION
 119 #if defined (__GNUC__)
 120 #  define GST_FUNCTION     ((const char*) (__PRETTY_FUNCTION__))
 121 #elif defined (G_HAVE_ISO_VARARGS)
 122 #  define GST_FUNCTION     ((const char*) (__func__))
 123 #else
 124 #  define GST_FUNCTION     ((const char*) ("???"))
 125 #endif
 126 #endif /* ifndef GST_FUNCTION */
 127
 128
 129 typedef struct _GstDebugMessage GstDebugMessage;
 130 typedef void (*GstLogFunction)  (GstDebugCategory *     category,
 131                                  GstDebugLevel          level,
 132                                  const gchar *          file,
 133                                  const gchar *          function,
 134                                  gint                   line,
 135                                  GObject *              object,
 136                                  GstDebugMessage *      message,
 137                                  gpointer               data);
 138
 139 #ifndef GST_DISABLE_GST_DEBUG
 140
 141 void            _gst_debug_init                 (void);
 142
 143 /* note we can't use G_GNUC_PRINTF (7, 8) because gcc chokes on %P, which
 144  * we use for GST_PTR_FORMAT. */
 145 void            gst_debug_log                   (GstDebugCategory *     category,
 146                                                  GstDebugLevel          level,
 147                                                  const gchar *          file,
 148                                                  const gchar *          function,
 149                                                  gint                   line,
 150                                                  GObject *              object,
 151                                                  const gchar *          format,
 152                                                  ...) G_GNUC_NO_INSTRUMENT;
 153 void            gst_debug_log_valist            (GstDebugCategory *     category,
 154                                                  GstDebugLevel          level,
 155                                                  const gchar *          file,
 156                                                  const gchar *          function,
 157                                                  gint                   line,
 158                                                  GObject *              object,
 159                                                  const gchar *          format,
 160                                                  va_list                args) G_GNUC_NO_INSTRUMENT;
 161
 162 const gchar *   gst_debug_message_get           (GstDebugMessage *      message);
 163
 164 void            gst_debug_log_default           (GstDebugCategory *     category,
 165                                                  GstDebugLevel          level,
 166                                                  const gchar *          file,
 167                                                  const gchar *          function,
 168                                                  gint                   line,
 169                                                  GObject *              object,
 170                                                  GstDebugMessage *      message,
 171                                                  gpointer               unused) G_GNUC_NO_INSTRUMENT;
 172
 173 G_CONST_RETURN gchar *
 174                 gst_debug_level_get_name        (GstDebugLevel          level);
 175
 176 void            gst_debug_add_log_function      (GstLogFunction         func,
 177                                                  gpointer data);
 178 guint           gst_debug_remove_log_function   (GstLogFunction         func);
 179 guint           gst_debug_remove_log_function_by_data (gpointer         data);
 180
 181 void            gst_debug_set_active            (gboolean active);
 182 gboolean        gst_debug_is_active             (void);
 183
 184 void            gst_debug_set_colored           (gboolean colored);
 185 gboolean        gst_debug_is_colored            (void);
 186
 187 void            gst_debug_set_default_threshold (GstDebugLevel          level);
 188 GstDebugLevel   gst_debug_get_default_threshold (void);
 189 void            gst_debug_set_threshold_for_name (const gchar *         name,
 190                                                  GstDebugLevel          level);
 191 void            gst_debug_unset_threshold_for_name (const gchar *       name);
 192
 193 /**
 194  * GST_DEBUG_CATEGORY:
 195  * @cat: the category
 196  *
 197  * Defines a GstDebugCategory variable.
 198  * This macro expands to nothing if debugging is disabled.
 199  */
 200 #define GST_DEBUG_CATEGORY(cat) GstDebugCategory *cat = NULL
 201 /**
 202  * GST_DEBUG_CATEGORY_EXTERN:
 203  * @cat: the category
 204  *
 205  * Declares a GstDebugCategory variable as extern. Use in header files.
 206  * This macro expands to nothing if debugging is disabled.
 207  */
 208 #define GST_DEBUG_CATEGORY_EXTERN(cat) extern GstDebugCategory *cat
 209 /**
 210  * GST_DEBUG_CATEGORY_STATIC:
 211  * @cat: the category
 212  *
 213  * Defines a static GstDebugCategory variable.
 214  * This macro expands to nothing if debugging is disabled.
 215  */
 216 #define GST_DEBUG_CATEGORY_STATIC(cat) static GstDebugCategory *cat = NULL
 217 /* do not use this function, use the macros below */
 218 GstDebugCategory *_gst_debug_category_new       (gchar *                name,
 219                                                  guint                  color,
 220                                                  gchar *                description);
 221 /**
 222  * GST_DEBUG_CATEGORY_INIT:
 223  * @cat: the category to initialize.
 224  * @name: the name of the category.
 225  * @color: the colors to use for a color representation or 0 for no color.
 226  * @description: optional description of the category.
 227  *
 228  * Initializes a new #GstDebugCategory with the given properties and set to
 229  * the default threshold.
 230  *
 231  * <note>
 232  * <para>
 233  * This macro expands to nothing if debugging is disabled.
 234  * </para>
 235  * <para>
 236  * When naming your category, please follow the following conventions to ensure
 237  * that the pattern matching for categories works as expected. It is not
 238  * earth-shattering if you don't follow these conventions, but it would be nice
 239  * for everyone.
 240  * </para>
 241  * <para>
 242  * If you define a category for a plugin or a feature of it, name the category
 243  * like the feature. So if you wanted to write a "filesrc" element, you would
 244  * name the category "filesrc". Use lowercase letters only.
 245  * If you define more than one category for the same element, append an
 246  * underscore and an identifier to your categories, like this: "filesrc_cache"
 247  * </para>
 248  * <para>
 249  * If you create a library or an application using debugging categories, use a
 250  * common prefix followed by an underscore for all your categories. GStreamer
 251  * uses the GST prefix so GStreamer categories look like "GST_STATES". Be sure
 252  * to include uppercase letters.
 253  * </para>
 254  * </note>
 255  */
 256 #define GST_DEBUG_CATEGORY_INIT(cat,name,color,description) G_STMT_START{       \
 257   if (cat == NULL)                                                              \
 258     cat = _gst_debug_category_new (name,color,description);                     \
 259 }G_STMT_END
 260
 261 void            gst_debug_category_free         (GstDebugCategory *     category);
 262 void            gst_debug_category_set_threshold (GstDebugCategory *    category,
 263                                                  GstDebugLevel          level);
 264 void            gst_debug_category_reset_threshold (GstDebugCategory *  category);
 265 GstDebugLevel   gst_debug_category_get_threshold (GstDebugCategory *    category);
 266 G_CONST_RETURN gchar *
 267                 gst_debug_category_get_name     (GstDebugCategory *     category);
 268 guint           gst_debug_category_get_color    (GstDebugCategory *     category);
 269 G_CONST_RETURN gchar *
 270                 gst_debug_category_get_description (GstDebugCategory *  category);
 271 GSList *        gst_debug_get_all_categories    (void);
 272
 273 gchar *         gst_debug_construct_term_color  (guint colorinfo);
 274
 275
 276 extern GstDebugCategory *       GST_CAT_DEFAULT;
 277 /* this symbol may not be used */
 278 extern gboolean                 __gst_debug_enabled;
 279
 280 #ifdef G_HAVE_ISO_VARARGS
 281 #define GST_CAT_LEVEL_LOG(cat,level,object,...) G_STMT_START{                   \
 282   if (__gst_debug_enabled) {                            \
 283     gst_debug_log ((cat), (level), __FILE__, GST_FUNCTION, __LINE__, (GObject *) (object), __VA_ARGS__); \
 284   }                                                                             \
 285 }G_STMT_END
 286 #else /* G_HAVE_GNUC_VARARGS */
 287 #ifdef G_HAVE_GNUC_VARARGS
 288 #define GST_CAT_LEVEL_LOG(cat,level,object,args...) G_STMT_START{                       \
 289   if (__gst_debug_enabled) {                            \
 290     gst_debug_log ((cat), (level), __FILE__, GST_FUNCTION, __LINE__, (GObject *) (object), ##args ); \
 291   }                                                                             \
 292 }G_STMT_END
 293 #else /* no variadic macros, use inline */
 294 static inline void
 295 GST_CAT_LEVEL_LOG_valist (GstDebugCategory * cat,
 296     GstDebugLevel level, gpointer object, const char *format, va_list varargs)
 297 {
 298   gst_debug_log_valist (cat, level, "", "", 0, (GObject *) object, format,
 299       varargs);
 300 }
 301
 302 static inline void
 303 GST_CAT_LEVEL_LOG (GstDebugCategory * cat, GstDebugLevel level,
 304     gpointer object, const char *format, ...)
 305 {
 306   if (__gst_debug_enabled) {
 307     va_list varargs;
 308
 309     va_start (varargs, format);
 310     GST_CAT_LEVEL_LOG_valist (cat, level, object, format, varargs);
 311     va_end (varargs);
 312   }
 313 }
 314 #endif
 315 #endif /* G_HAVE_ISO_VARARGS */
 316
 317 #ifdef G_HAVE_ISO_VARARGS
 318
 319 #define GST_CAT_ERROR_OBJECT(cat,obj,...)       GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   obj,  __VA_ARGS__)
 320 #define GST_CAT_WARNING_OBJECT(cat,obj,...)     GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, obj,  __VA_ARGS__)
 321 #define GST_CAT_INFO_OBJECT(cat,obj,...)        GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    obj,  __VA_ARGS__)
 322 #define GST_CAT_DEBUG_OBJECT(cat,obj,...)       GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   obj,  __VA_ARGS__)
 323 #define GST_CAT_LOG_OBJECT(cat,obj,...)         GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     obj,  __VA_ARGS__)
 324
 325 #define GST_CAT_ERROR(cat,...)                  GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   NULL, __VA_ARGS__)
 326 #define GST_CAT_WARNING(cat,...)                GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, NULL, __VA_ARGS__)
 327 #define GST_CAT_INFO(cat,...)                   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
 328 #define GST_CAT_DEBUG(cat,...)                  GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
 329 #define GST_CAT_LOG(cat,...)                    GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     NULL, __VA_ARGS__)
 330
 331 #define GST_ERROR_OBJECT(obj,...)       GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   obj,  __VA_ARGS__)
 332 #define GST_WARNING_OBJECT(obj,...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj,  __VA_ARGS__)
 333 #define GST_INFO_OBJECT(obj,...)        GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj,  __VA_ARGS__)
 334 #define GST_DEBUG_OBJECT(obj,...)       GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj,  __VA_ARGS__)
 335 #define GST_LOG_OBJECT(obj,...)         GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     obj,  __VA_ARGS__)
 336
 337 #define GST_ERROR(...)                  GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   NULL, __VA_ARGS__)
 338 #define GST_WARNING(...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, __VA_ARGS__)
 339 #define GST_INFO(...)                   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
 340 #define GST_DEBUG(...)                  GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
 341 #define GST_LOG(...)                    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     NULL, __VA_ARGS__)
 342
 343 #else
 344 #ifdef G_HAVE_GNUC_VARARGS
 345
 346 #define GST_CAT_ERROR_OBJECT(cat,obj,args...)   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   obj,  ##args )
 347 #define GST_CAT_WARNING_OBJECT(cat,obj,args...) GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, obj,  ##args )
 348 #define GST_CAT_INFO_OBJECT(cat,obj,args...)    GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    obj,  ##args )
 349 #define GST_CAT_DEBUG_OBJECT(cat,obj,args...)   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   obj,  ##args )
 350 #define GST_CAT_LOG_OBJECT(cat,obj,args...)     GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     obj,  ##args )
 351
 352 #define GST_CAT_ERROR(cat,args...)              GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   NULL, ##args )
 353 #define GST_CAT_WARNING(cat,args...)            GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, NULL, ##args )
 354 #define GST_CAT_INFO(cat,args...)               GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    NULL, ##args )
 355 #define GST_CAT_DEBUG(cat,args...)              GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   NULL, ##args )
 356 #define GST_CAT_LOG(cat,args...)                GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     NULL, ##args )
 357
 358 #define GST_ERROR_OBJECT(obj,args...)   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   obj,  ##args )
 359 #define GST_WARNING_OBJECT(obj,args...) GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj,  ##args )
 360 #define GST_INFO_OBJECT(obj,args...)    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj,  ##args )
 361 #define GST_DEBUG_OBJECT(obj,args...)   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj,  ##args )
 362 #define GST_LOG_OBJECT(obj,args...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     obj,  ##args )
 363
 364 #define GST_ERROR(args...)              GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   NULL, ##args )
 365 #define GST_WARNING(args...)            GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, ##args )
 366 #define GST_INFO(args...)               GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, ##args )
 367 #define GST_DEBUG(args...)              GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, ##args )
 368 #define GST_LOG(args...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     NULL, ##args )
 369
 370 #else
 371 /* no variadic macros, use inline */
 372 static inline void
 373 GST_CAT_ERROR_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
 374     ...)
 375 {
 376   va_list varargs;
 377
 378   va_start (varargs, format);
 379   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_ERROR, obj, format, varargs);
 380   va_end (varargs);
 381 }
 382
 383 static inline void
 384 GST_CAT_WARNING_OBJECT (GstDebugCategory * cat, gpointer obj,
 385     const char *format, ...)
 386 {
 387   va_list varargs;
 388
 389   va_start (varargs, format);
 390   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_WARNING, obj, format, varargs);
 391   va_end (varargs);
 392 }
 393
 394 static inline void
 395 GST_CAT_INFO_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
 396     ...)
 397 {
 398   va_list varargs;
 399
 400   va_start (varargs, format);
 401   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_INFO, obj, format, varargs);
 402   va_end (varargs);
 403 }
 404
 405 static inline void
 406 GST_CAT_DEBUG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
 407     ...)
 408 {
 409   va_list varargs;
 410
 411   va_start (varargs, format);
 412   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_DEBUG, obj, format, varargs);
 413   va_end (varargs);
 414 }
 415
 416 static inline void
 417 GST_CAT_LOG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
 418     ...)
 419 {
 420   va_list varargs;
 421
 422   va_start (varargs, format);
 423   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_LOG, obj, format, varargs);
 424   va_end (varargs);
 425 }
 426
 427 static inline void
 428 GST_CAT_ERROR (GstDebugCategory * cat, const char *format, ...)
 429 {
 430   va_list varargs;
 431
 432   va_start (varargs, format);
 433   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_ERROR, NULL, format, varargs);
 434   va_end (varargs);
 435 }
 436
 437 static inline void
 438 GST_CAT_WARNING (GstDebugCategory * cat, const char *format, ...)
 439 {
 440   va_list varargs;
 441
 442   va_start (varargs, format);
 443   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_WARNING, NULL, format, varargs);
 444   va_end (varargs);
 445 }
 446
 447 static inline void
 448 GST_CAT_INFO (GstDebugCategory * cat, const char *format, ...)
 449 {
 450   va_list varargs;
 451
 452   va_start (varargs, format);
 453   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_INFO, NULL, format, varargs);
 454   va_end (varargs);
 455 }
 456
 457 static inline void
 458 GST_CAT_DEBUG (GstDebugCategory * cat, const char *format, ...)
 459 {
 460   va_list varargs;
 461
 462   va_start (varargs, format);
 463   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_DEBUG, NULL, format, varargs);
 464   va_end (varargs);
 465 }
 466
 467 static inline void
 468 GST_CAT_LOG (GstDebugCategory * cat, const char *format, ...)
 469 {
 470   va_list varargs;
 471
 472   va_start (varargs, format);
 473   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_LOG, NULL, format, varargs);
 474   va_end (varargs);
 475 }
 476
 477 static inline void
 478 GST_ERROR_OBJECT (gpointer obj, const char *format, ...)
 479 {
 480   va_list varargs;
 481
 482   va_start (varargs, format);
 483   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_ERROR, obj, format,
 484       varargs);
 485   va_end (varargs);
 486 }
 487
 488 static inline void
 489 GST_WARNING_OBJECT (gpointer obj, const char *format, ...)
 490 {
 491   va_list varargs;
 492
 493   va_start (varargs, format);
 494   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj, format,
 495       varargs);
 496   va_end (varargs);
 497 }
 498
 499 static inline void
 500 GST_INFO_OBJECT (gpointer obj, const char *format, ...)
 501 {
 502   va_list varargs;
 503
 504   va_start (varargs, format);
 505   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_INFO, obj, format,
 506       varargs);
 507   va_end (varargs);
 508 }
 509
 510 static inline void
 511 GST_DEBUG_OBJECT (gpointer obj, const char *format, ...)
 512 {
 513   va_list varargs;
 514
 515   va_start (varargs, format);
 516   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_DEBUG, obj, format,
 517       varargs);
 518   va_end (varargs);
 519 }
 520
 521 static inline void
 522 GST_LOG_OBJECT (gpointer obj, const char *format, ...)
 523 {
 524   va_list varargs;
 525
 526   va_start (varargs, format);
 527   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_LOG, obj, format,
 528       varargs);
 529   va_end (varargs);
 530 }
 531
 532 static inline void
 533 GST_ERROR (const char *format, ...)
 534 {
 535   va_list varargs;
 536
 537   va_start (varargs, format);
 538   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_ERROR, NULL, format,
 539       varargs);
 540   va_end (varargs);
 541 }
 542
 543 static inline void
 544 GST_WARNING (const char *format, ...)
 545 {
 546   va_list varargs;
 547
 548   va_start (varargs, format);
 549   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, format,
 550       varargs);
 551   va_end (varargs);
 552 }
 553
 554 static inline void
 555 GST_INFO (const char *format, ...)
 556 {
 557   va_list varargs;
 558
 559   va_start (varargs, format);
 560   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_INFO, NULL, format,
 561       varargs);
 562   va_end (varargs);
 563 }
 564
 565 static inline void
 566 GST_DEBUG (const char *format, ...)
 567 {
 568   va_list varargs;
 569
 570   va_start (varargs, format);
 571   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_DEBUG, NULL, format,
 572       varargs);
 573   va_end (varargs);
 574 }
 575
 576 static inline void
 577 GST_LOG (const char *format, ...)
 578 {
 579   va_list varargs;
 580
 581   va_start (varargs, format);
 582   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_LOG, NULL,
 583       format, varargs);
 584   va_end (varargs);
 585 }
 586 #endif
 587 #endif
 588
 589
 590 /********** function pointer stuff **********/
 591 void*           _gst_debug_register_funcptr     (void *                 ptr,
 592                                                  gchar *                ptrname);
 593 G_CONST_RETURN gchar*
 594                 _gst_debug_nameof_funcptr       (void *                 ptr);
 595
 596 #define GST_DEBUG_FUNCPTR(ptr) (_gst_debug_register_funcptr((void *)(ptr), #ptr) , ptr)
 597 #define GST_DEBUG_FUNCPTR_NAME(ptr) _gst_debug_nameof_funcptr((void *)ptr)
 598
 599 #else /* GST_DISABLE_GST_DEBUG */
 600
 601 #ifdef __GNUC__
 602 #  pragma GCC poison gst_debug_log
 603 #  pragma GCC poison gst_debug_log_valist
 604 #  pragma GCC poison _gst_debug_category_new
 605 #endif
 606
 607 #define _gst_debug_init()                               /* NOP */
 608
 609 #define gst_debug_set_log_function(func,data)           /* NOP */
 610 #define gst_debug_reset_log_function(void)              /* NOP */
 611 #define gst_debug_set_default_threshold(level)          /* NOP */
 612 #define gst_debug_get_default_threshold()               (GST_LEVEL_NONE)
 613 #define gst_debug_category_set_threshold_for_name(name, level) /* NOP */
 614 #define gst_debug_category_unset_threshold_for_name(name) /* NOP */
 615
 616 #define gst_debug_level_get_name(level)                 ("NONE")
 617 #define gst_debug_add_log_function(func,data)           (FALSE)
 618 #define gst_debug_remove_log_function(func)             (0)
 619 #define gst_debug_remove_log_function_by_data(data)     (0)
 620 #define gst_debug_set_active(active)                    /* NOP */
 621 #define gst_debug_is_active()                           (FALSE)
 622 #define gst_debug_set_colored(colored)                  /* NOP */
 623 #define gst_debug_is_colored()                          (FALSE)
 624 #define gst_debug_set_default_threshold(level)          /* NOP */
 625 #define gst_debug_get_default_threshold()               (GST_LEVEL_NONE)
 626 #define gst_debug_set_threshold_for_name(name,level)    /* NOP */
 627 #define gst_debug_unset_threshold_for_name(name)        /* NOP */
 628
 629 #define GST_DEBUG_CATEGORY(var)                         /* NOP */
 630 #define GST_DEBUG_CATEGORY_EXTERN(var)                  /* NOP */
 631 #define GST_DEBUG_CATEGORY_STATIC(var)                  /* NOP */
 632 #define GST_DEBUG_CATEGORY_INIT(var,name,color,desc)    /* NOP */
 633 #define gst_debug_category_free(category)               /* NOP */
 634 #define gst_debug_category_set_threshold(category,level) /* NOP */
 635 #define gst_debug_category_reset_threshold(category)    /* NOP */
 636 #define gst_debug_category_get_threshold(category)      (GST_LEVEL_NONE)
 637 #define gst_debug_category_get_name(cat)                ("")
 638 #define gst_debug_category_get_color(cat)               (0)
 639 #define gst_debug_category_get_description(cat)         ("")
 640 #define gst_debug_get_all_categories()                  (NULL)
 641 #define gst_debug_construct_term_color(colorinfo)       (g_strdup ("00"))
 642
 643 #ifdef G_HAVE_ISO_VARARGS
 644
 645 #define GST_CAT_LEVEL_LOG(cat,level,...)                /* NOP */
 646
 647 #define GST_CAT_ERROR_OBJECT(...)                       /* NOP */
 648 #define GST_CAT_WARNING_OBJECT(...)                     /* NOP */
 649 #define GST_CAT_INFO_OBJECT(...)                        /* NOP */
 650 #define GST_CAT_DEBUG_OBJECT(...)                       /* NOP */
 651 #define GST_CAT_LOG_OBJECT(...)                         /* NOP */
 652
 653 #define GST_CAT_ERROR(...)                              /* NOP */
 654 #define GST_CAT_WARNING(...)                            /* NOP */
 655 #define GST_CAT_INFO(...)                               /* NOP */
 656 #define GST_CAT_DEBUG(...)                              /* NOP */
 657 #define GST_CAT_LOG(...)                                /* NOP */
 658
 659 #define GST_ERROR_OBJECT(...)                           /* NOP */
 660 #define GST_WARNING_OBJECT(...)                         /* NOP */
 661 #define GST_INFO_OBJECT(...)                            /* NOP */
 662 #define GST_DEBUG_OBJECT(...)                           /* NOP */
 663 #define GST_LOG_OBJECT(...)                             /* NOP */
 664
 665 #define GST_ERROR(...)                                  /* NOP */
 666 #define GST_WARNING(...)                                /* NOP */
 667 #define GST_INFO(...)                                   /* NOP */
 668 #define GST_DEBUG(...)                                  /* NOP */
 669 #define GST_LOG(...)                                    /* NOP */
 670
 671 #else
 672 #ifdef G_HAVE_GNUC_VARARGS
 673
 674 #define GST_CAT_LEVEL_LOG(cat,level,args...)            /* NOP */
 675
 676 #define GST_CAT_ERROR_OBJECT(args...)                   /* NOP */
 677 #define GST_CAT_WARNING_OBJECT(args...)                 /* NOP */
 678 #define GST_CAT_INFO_OBJECT(args...)                    /* NOP */
 679 #define GST_CAT_DEBUG_OBJECT(args...)                   /* NOP */
 680 #define GST_CAT_LOG_OBJECT(args...)                     /* NOP */
 681
 682 #define GST_CAT_ERROR(args...)                          /* NOP */
 683 #define GST_CAT_WARNING(args...)                        /* NOP */
 684 #define GST_CAT_INFO(args...)                           /* NOP */
 685 #define GST_CAT_DEBUG(args...)                          /* NOP */
 686 #define GST_CAT_LOG(args...)                            /* NOP */
 687
 688 #define GST_ERROR_OBJECT(args...)                       /* NOP */
 689 #define GST_WARNING_OBJECT(args...)                     /* NOP */
 690 #define GST_INFO_OBJECT(args...)                        /* NOP */
 691 #define GST_DEBUG_OBJECT(args...)                       /* NOP */
 692 #define GST_LOG_OBJECT(args...)                         /* NOP */
 693
 694 #define GST_ERROR(args...)                              /* NOP */
 695 #define GST_WARNING(args...)                            /* NOP */
 696 #define GST_INFO(args...)                               /* NOP */
 697 #define GST_DEBUG(args...)                              /* NOP */
 698 #define GST_LOG(args...)                                /* NOP */
 699
 700 #else
 701 static inline void
 702 GST_CAT_ERROR_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
 703     ...)
 704 {
 705 }
 706
 707 static inline void
 708 GST_CAT_WARNING_OBJECT (GstDebugCategory * cat, gpointer obj,
 709     const char *format, ...)
 710 {
 711 }
 712
 713 static inline void
 714 GST_CAT_INFO_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
 715     ...)
 716 {
 717 }
 718
 719 static inline void
 720 GST_CAT_DEBUG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
 721     ...)
 722 {
 723 }
 724
 725 static inline void
 726 GST_CAT_LOG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
 727     ...)
 728 {
 729 }
 730
 731 static inline void
 732 GST_CAT_ERROR (GstDebugCategory * cat, const char *format, ...)
 733 {
 734 }
 735
 736 static inline void
 737 GST_CAT_WARNING (GstDebugCategory * cat, const char *format, ...)
 738 {
 739 }
 740
 741 static inline void
 742 GST_CAT_INFO (GstDebugCategory * cat, const char *format, ...)
 743 {
 744 }
 745
 746 static inline void
 747 GST_CAT_DEBUG (GstDebugCategory * cat, const char *format, ...)
 748 {
 749 }
 750
 751 static inline void
 752 GST_CAT_LOG (GstDebugCategory * cat, const char *format, ...)
 753 {
 754 }
 755
 756 static inline void
 757 GST_ERROR_OBJECT (gpointer obj, const char *format, ...)
 758 {
 759 }
 760
 761 static inline void
 762 GST_WARNING_OBJECT (gpointer obj, const char *format, ...)
 763 {
 764 }
 765
 766 static inline void
 767 GST_INFO_OBJECT (gpointer obj, const char *format, ...)
 768 {
 769 }
 770
 771 static inline void
 772 GST_DEBUG_OBJECT (gpointer obj, const char *format, ...)
 773 {
 774 }
 775
 776 static inline void
 777 GST_LOG_OBJECT (gpointer obj, const char *format, ...)
 778 {
 779 }
 780
 781 static inline void
 782 GST_ERROR (const char *format, ...)
 783 {
 784 }
 785
 786 static inline void
 787 GST_WARNING (const char *format, ...)
 788 {
 789 }
 790
 791 static inline void
 792 GST_INFO (const char *format, ...)
 793 {
 794 }
 795
 796 static inline void
 797 GST_DEBUG (const char *format, ...)
 798 {
 799 }
 800
 801 static inline void
 802 GST_LOG (const char *format, ...)
 803 {
 804 }
 805 #endif
 806 #endif
 807
 808 #define GST_DEBUG_FUNCPTR(ptr) (ptr)
 809 #define GST_DEBUG_FUNCPTR_NAME(ptr) (g_strdup_printf ("%p", ptr))
 810
 811 #endif /* GST_DISABLE_GST_DEBUG */
 812
 813 void gst_debug_print_stack_trace (void);
 814
 815 /* timestamp debugging macros */
 816 #define GST_TIME_FORMAT "u:%02u:%02u:%09u"
 817 #define GST_TIME_ARGS(t) \
 818         (guint) (t / (GST_SECOND * 60 * 60)), \
 819         (guint) ((t / (GST_SECOND * 60)) % 60), \
 820         (guint) ((t / GST_SECOND) % 60), \
 821         (guint) (t % GST_SECOND)
 822
 823 G_END_DECLS
 824
 825 #endif /* __GSTINFO_H__ */