adding Ronald's timestamp debug defines
[platform/upstream/gstreamer.git] / 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 /* Disable this subsystem if no varargs macro can be found. 
140    Use a trick so the core builds the functions nonetheless if it wasn't
141    explicitly disabled. */
142 #if !defined(G_HAVE_ISO_VARARGS) && !defined(G_HAVE_GNUC_VARARGS)
143 #define __GST_DISABLE_GST_DEBUG
144 #endif
145 #ifdef GST_DISABLE_GST_DEBUG
146 #ifndef __GST_DISABLE_GST_DEBUG
147 #define __GST_DISABLE_GST_DEBUG
148 #endif
149 #endif
150
151 #ifndef __GST_DISABLE_GST_DEBUG
152
153 void            _gst_debug_init                 (void);
154
155 /* note we can't use G_GNUC_PRINTF (7, 8) because gcc chokes on %P, which
156  * we use for GST_PTR_FORMAT. */
157 void            gst_debug_log                   (GstDebugCategory *     category,
158                                                  GstDebugLevel          level,
159                                                  const gchar *          file,
160                                                  const gchar *          function,
161                                                  gint                   line,
162                                                  GObject *              object,
163                                                  const gchar *          format,
164                                                  ...) G_GNUC_NO_INSTRUMENT;
165 void            gst_debug_log_valist            (GstDebugCategory *     category,
166                                                  GstDebugLevel          level,
167                                                  const gchar *          file,
168                                                  const gchar *          function,
169                                                  gint                   line,
170                                                  GObject *              object,
171                                                  const gchar *          format,
172                                                  va_list                args) G_GNUC_NO_INSTRUMENT;
173
174 const gchar *   gst_debug_message_get           (GstDebugMessage *      message);
175
176 void            gst_debug_log_default           (GstDebugCategory *     category,
177                                                  GstDebugLevel          level,
178                                                  const gchar *          file,
179                                                  const gchar *          function,
180                                                  gint                   line,
181                                                  GObject *              object,
182                                                  GstDebugMessage *      message,
183                                                  gpointer               unused) G_GNUC_NO_INSTRUMENT;
184
185 G_CONST_RETURN gchar *
186                 gst_debug_level_get_name        (GstDebugLevel          level);
187
188 void            gst_debug_add_log_function      (GstLogFunction         func,
189                                                  gpointer data);
190 guint           gst_debug_remove_log_function   (GstLogFunction         func);
191 guint           gst_debug_remove_log_function_by_data (gpointer         data);
192
193 void            gst_debug_set_active            (gboolean active);
194 gboolean        gst_debug_is_active             (void);
195
196 void            gst_debug_set_colored           (gboolean colored);
197 gboolean        gst_debug_is_colored            (void);
198
199 void            gst_debug_set_default_threshold (GstDebugLevel          level);
200 GstDebugLevel   gst_debug_get_default_threshold (void);
201 void            gst_debug_set_threshold_for_name (const gchar *         name,
202                                                  GstDebugLevel          level);
203 void            gst_debug_unset_threshold_for_name (const gchar *       name);
204
205 /**
206  * GST_DEBUG_CATEGORY:
207  * @cat: the category
208  *
209  * Defines a GstDebugCategory variable.
210  * This macro expands to nothing if debugging is disabled.
211  */
212 #define GST_DEBUG_CATEGORY(cat) GstDebugCategory *cat = NULL
213 /**
214  * GST_DEBUG_CATEGORY_EXTERN:
215  * @cat: the category
216  *
217  * Declares a GstDebugCategory variable as extern. Use in header files.
218  * This macro expands to nothing if debugging is disabled.
219  */
220 #define GST_DEBUG_CATEGORY_EXTERN(cat) extern GstDebugCategory *cat
221 /**
222  * GST_DEBUG_CATEGORY_STATIC:
223  * @cat: the category
224  *
225  * Defines a static GstDebugCategory variable.
226  * This macro expands to nothing if debugging is disabled.
227  */
228 #define GST_DEBUG_CATEGORY_STATIC(cat) static GstDebugCategory *cat = NULL
229 /* do not use this function, use the macros below */
230 GstDebugCategory *_gst_debug_category_new       (gchar *                name,
231                                                  guint                  color,
232                                                  gchar *                description);
233 /**
234  * GST_DEBUG_CATEGORY_INIT:
235  * @cat: the category to initialize.
236  * @name: the name of the category.
237  * @color: the colors to use for a color representation or 0 for no color.
238  * @description: optional description of the category.
239  *
240  * Initializes a new #GstDebugCategory with the given properties and set to
241  * the default threshold.
242  *
243  * <note>
244  * <para>
245  * This macro expands to nothing if debugging is disabled.
246  * </para>
247  * <para>
248  * When naming your category, please follow the following conventions to ensure
249  * that the pattern matching for categories works as expected. It is not
250  * earth-shattering if you don't follow these conventions, but it would be nice
251  * for everyone.
252  * </para>
253  * <para>
254  * If you define a category for a plugin or a feature of it, name the category
255  * like the feature. So if you wanted to write a "filesrc" element, you would
256  * name the category "filesrc". Use lowercase letters only.
257  * If you define more than one category for the same element, append an
258  * underscore and an identifier to your categories, like this: "filesrc_cache"
259  * </para>
260  * <para>
261  * If you create a library or an application using debugging categories, use a
262  * common prefix followed by an underscore for all your categories. GStreamer
263  * uses the GST prefix so GStreamer categories look like "GST_STATES". Be sure
264  * to include uppercase letters.
265  * </para>
266  * </note>
267  */
268 #define GST_DEBUG_CATEGORY_INIT(cat,name,color,description) G_STMT_START{       \
269   if (cat == NULL)                                                              \
270     cat = _gst_debug_category_new (name,color,description);                     \
271 }G_STMT_END
272
273 void            gst_debug_category_free         (GstDebugCategory *     category);
274 void            gst_debug_category_set_threshold (GstDebugCategory *    category,
275                                                  GstDebugLevel          level);
276 void            gst_debug_category_reset_threshold (GstDebugCategory *  category);
277 GstDebugLevel   gst_debug_category_get_threshold (GstDebugCategory *    category);
278 G_CONST_RETURN gchar *
279                 gst_debug_category_get_name     (GstDebugCategory *     category);
280 guint           gst_debug_category_get_color    (GstDebugCategory *     category);
281 G_CONST_RETURN gchar *
282                 gst_debug_category_get_description (GstDebugCategory *  category);
283 GSList *        gst_debug_get_all_categories    (void);
284
285 gchar *         gst_debug_construct_term_color  (guint colorinfo);
286
287
288 extern GstDebugCategory *       GST_CAT_DEFAULT;
289 /* this symbol may not be used */
290 extern gboolean                 __gst_debug_enabled;
291 #ifdef G_HAVE_ISO_VARARGS
292 #define GST_CAT_LEVEL_LOG(cat,level,object,...) G_STMT_START{                   \
293   if (__gst_debug_enabled) {                            \
294     gst_debug_log ((cat), (level), __FILE__, GST_FUNCTION, __LINE__, (GObject *) (object), __VA_ARGS__); \
295   }                                                                             \
296 }G_STMT_END
297 #else /* G_HAVE_GNUC_VARARGS */
298 #define GST_CAT_LEVEL_LOG(cat,level,object,args...) G_STMT_START{                       \
299   if (__gst_debug_enabled) {                            \
300     gst_debug_log ((cat), (level), __FILE__, GST_FUNCTION, __LINE__, (GObject *) (object), ##args ); \
301   }                                                                             \
302 }G_STMT_END
303 #endif /* G_HAVE_ISO_VARARGS */
304
305 #ifndef GST_DEBUG_ENABLE_DEPRECATED
306
307 #ifdef G_HAVE_ISO_VARARGS
308
309 #define GST_CAT_ERROR_OBJECT(cat,obj,...)       GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   obj,  __VA_ARGS__)
310 #define GST_CAT_WARNING_OBJECT(cat,obj,...)     GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, obj,  __VA_ARGS__)
311 #define GST_CAT_INFO_OBJECT(cat,obj,...)        GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    obj,  __VA_ARGS__)
312 #define GST_CAT_DEBUG_OBJECT(cat,obj,...)       GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   obj,  __VA_ARGS__)
313 #define GST_CAT_LOG_OBJECT(cat,obj,...)         GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     obj,  __VA_ARGS__)
314
315 #define GST_CAT_ERROR(cat,...)                  GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   NULL, __VA_ARGS__)
316 #define GST_CAT_WARNING(cat,...)                GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, NULL, __VA_ARGS__)
317 #define GST_CAT_INFO(cat,...)                   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
318 #define GST_CAT_DEBUG(cat,...)                  GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
319 #define GST_CAT_LOG(cat,...)                    GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     NULL, __VA_ARGS__)
320
321 #define GST_ERROR_OBJECT(obj,...)       GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   obj,  __VA_ARGS__)
322 #define GST_WARNING_OBJECT(obj,...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj,  __VA_ARGS__)
323 #define GST_INFO_OBJECT(obj,...)        GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj,  __VA_ARGS__)
324 #define GST_DEBUG_OBJECT(obj,...)       GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj,  __VA_ARGS__)
325 #define GST_LOG_OBJECT(obj,...)         GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     obj,  __VA_ARGS__)
326
327 #define GST_ERROR(...)                  GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   NULL, __VA_ARGS__)
328 #define GST_WARNING(...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, __VA_ARGS__)
329 #define GST_INFO(...)                   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
330 #define GST_DEBUG(...)                  GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
331 #define GST_LOG(...)                    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     NULL, __VA_ARGS__)
332
333 #else /* G_HAVE_GNUC_VARARGS */
334
335 #define GST_CAT_ERROR_OBJECT(cat,obj,args...)   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   obj,  ##args )
336 #define GST_CAT_WARNING_OBJECT(cat,obj,args...) GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, obj,  ##args )
337 #define GST_CAT_INFO_OBJECT(cat,obj,args...)    GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    obj,  ##args )
338 #define GST_CAT_DEBUG_OBJECT(cat,obj,args...)   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   obj,  ##args )
339 #define GST_CAT_LOG_OBJECT(cat,obj,args...)     GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     obj,  ##args )
340
341 #define GST_CAT_ERROR(cat,args...)              GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   NULL, ##args )
342 #define GST_CAT_WARNING(cat,args...)            GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, NULL, ##args )
343 #define GST_CAT_INFO(cat,args...)               GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    NULL, ##args )
344 #define GST_CAT_DEBUG(cat,args...)              GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   NULL, ##args )
345 #define GST_CAT_LOG(cat,args...)                GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     NULL, ##args )
346
347 #define GST_ERROR_OBJECT(obj,args...)   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   obj,  ##args )
348 #define GST_WARNING_OBJECT(obj,args...) GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj,  ##args )
349 #define GST_INFO_OBJECT(obj,args...)    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj,  ##args )
350 #define GST_DEBUG_OBJECT(obj,args...)   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj,  ##args )
351 #define GST_LOG_OBJECT(obj,args...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     obj,  ##args )
352
353 #define GST_ERROR(args...)              GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   NULL, ##args )
354 #define GST_WARNING(args...)            GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, ##args )
355 #define GST_INFO(args...)               GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, ##args )
356 #define GST_DEBUG(args...)              GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, ##args )
357 #define GST_LOG(args...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     NULL, ##args )
358
359 #endif /* G_HAVE_ISO_VARARGS */
360
361 #else /* GST_DEBUG_ENABLE_DEPRECATED */
362 /* This is a workaround so the old debugging stuff of GStreamer 0.6 works.
363    This is undocumented and will go when 0.8 comes out. */
364
365 #ifdef G_HAVE_ISO_VARARGS
366 #  define GST_INFO(cat,...)                     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
367 #  define GST_DEBUG(cat,...)                    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
368 #  define GST_INFO_ELEMENT(cat,obj,...)         GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj, __VA_ARGS__)
369 #  define GST_DEBUG_ELEMENT(cat,obj,...)        GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj, __VA_ARGS__)
370 #  define GST_DEBUG_ENTER(...)                  GST_DEBUG ("entering: " __VA_ARGS__ )
371 #  define GST_DEBUG_LEAVE(...)                  GST_DEBUG ("leaving: "  __VA_ARGS__ )
372 #  define GST_INFO_ENTER(...)                   GST_INFO ("entering: " __VA_ARGS__ )
373 #  define GST_INFO_LEAVE(...)                   GST_INFO ("leaving: "  __VA_ARGS__ )
374 #else /* G_HAVE_GNUC_VARARGS */
375 #  define GST_INFO(cat,args...)                 GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, ##args )
376 #  define GST_DEBUG(cat,args...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, ##args )
377 #  define GST_INFO_ELEMENT(cat,obj,args...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj, ##args )
378 #  define GST_DEBUG_ELEMENT(cat,obj,args...)    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj, ##args )
379 #  define GST_DEBUG_ENTER(args...)              GST_DEBUG ("entering: " ##args )
380 #  define GST_DEBUG_LEAVE(args...)              GST_DEBUG ("leaving: "  ##args )
381 #  define GST_INFO_ENTER(args...)               GST_INFO ("entering: " ##args )
382 #  define GST_INFO_LEAVE(args...)               GST_INFO ("leaving: "  ##args )
383 #endif /* G_HAVE_ISO_VARARGS */
384
385 #endif /* !GST_DEBUG_ENABLE_DEPRECATED */
386
387
388 /********** function pointer stuff **********/
389 void*           _gst_debug_register_funcptr     (void *                 ptr,
390                                                  gchar *                ptrname);
391 G_CONST_RETURN gchar*
392                 _gst_debug_nameof_funcptr       (void *                 ptr);
393
394 #define GST_DEBUG_FUNCPTR(ptr) (_gst_debug_register_funcptr((void *)(ptr), #ptr) , ptr)
395 #define GST_DEBUG_FUNCPTR_NAME(ptr) _gst_debug_nameof_funcptr((void *)ptr)
396
397 #else /* GST_DISABLE_GST_DEBUG */
398
399 #ifdef __GNUC__
400 #  pragma GCC poison gst_debug_log
401 #  pragma GCC poison gst_debug_log_valist
402 #  pragma GCC poison _gst_debug_category_new
403 #endif
404
405 #define _gst_debug_init()                               /* NOP */
406
407 #define gst_debug_set_log_function(func,data)           /* NOP */
408 #define gst_debug_reset_log_function(void)              /* NOP */
409 #define gst_debug_set_default_threshold(level)          /* NOP */
410 #define gst_debug_get_default_threshold()               (GST_LEVEL_NONE)
411 #define gst_debug_category_set_threshold_for_name(name, level) /* NOP */
412 #define gst_debug_category_unset_threshold_for_name(name) /* NOP */
413
414 #define gst_debug_level_get_name(level)                 ("NONE")
415 #define gst_debug_add_log_function(func,data)           (FALSE)
416 #define gst_debug_remove_log_function(func)             (0)
417 #define gst_debug_remove_log_function_by_data(data)     (0)
418 #define gst_debug_set_active(active)                    /* NOP */
419 #define gst_debug_is_active()                           (FALSE)
420 #define gst_debug_set_colored(colored)                  /* NOP */
421 #define gst_debug_is_colored()                          (FALSE)
422 #define gst_debug_set_default_threshold(level)          /* NOP */
423 #define gst_debug_get_default_threshold()               (GST_LEVEL_NONE)
424 #define gst_debug_set_threshold_for_name(name,level)    /* NOP */
425 #define gst_debug_unset_threshold_for_name(name)        /* NOP */
426
427 #define GST_DEBUG_CATEGORY(var)                         /* NOP */
428 #define GST_DEBUG_CATEGORY_EXTERN(var)                  /* NOP */
429 #define GST_DEBUG_CATEGORY_STATIC(var)                  /* NOP */
430 #define GST_DEBUG_CATEGORY_INIT(var,name,color,desc)    /* NOP */
431 #define gst_debug_category_free(category)               /* NOP */
432 #define gst_debug_category_set_threshold(category,level) /* NOP */
433 #define gst_debug_category_reset_threshold(category)    /* NOP */
434 #define gst_debug_category_get_threshold(category)      (GST_LEVEL_NONE)
435 #define gst_debug_category_get_name(cat)                ("")
436 #define gst_debug_category_get_color(cat)               (0)
437 #define gst_debug_category_get_description(cat)         ("")
438 #define gst_debug_get_all_categories()                  (NULL)
439 #define gst_debug_construct_term_color(colorinfo)       (g_strdup ("00"))
440
441 #ifdef G_HAVE_ISO_VARARGS
442
443 #define GST_CAT_LEVEL_LOG(cat,level,...)                /* NOP */
444
445 #define GST_CAT_ERROR_OBJECT(...)                       /* NOP */
446 #define GST_CAT_WARNING_OBJECT(...)                     /* NOP */
447 #define GST_CAT_INFO_OBJECT(...)                        /* NOP */
448 #define GST_CAT_DEBUG_OBJECT(...)                       /* NOP */
449 #define GST_CAT_LOG_OBJECT(...)                         /* NOP */
450
451 #define GST_CAT_ERROR(...)                              /* NOP */
452 #define GST_CAT_WARNING(...)                            /* NOP */
453 #define GST_CAT_INFO(...)                               /* NOP */
454 #define GST_CAT_DEBUG(...)                              /* NOP */
455 #define GST_CAT_LOG(...)                                /* NOP */
456
457 #define GST_ERROR_OBJECT(...)                           /* NOP */
458 #define GST_WARNING_OBJECT(...)                         /* NOP */
459 #define GST_INFO_OBJECT(...)                            /* NOP */
460 #define GST_DEBUG_OBJECT(...)                           /* NOP */
461 #define GST_LOG_OBJECT(...)                             /* NOP */
462
463 #define GST_ERROR(...)                                  /* NOP */
464 #define GST_WARNING(...)                                /* NOP */
465 #define GST_INFO(...)                                   /* NOP */
466 #define GST_DEBUG(...)                                  /* NOP */
467 #define GST_LOG(...)                                    /* NOP */
468
469 #ifdef GST_DEBUG_ENABLE_DEPRECATED
470 #define GST_INFO_ELEMENT(cat,obj,...) /* NOP */
471 #define GST_DEBUG_ELEMENT(cat,obj,...) /* NOP */
472 #define GST_DEBUG_ENTER(...) /* NOP */
473 #define GST_DEBUG_LEAVE(...) /* NOP */
474 #define GST_INFO_ENTER(...) /* NOP */
475 #define GST_INFO_LEAVE(...) /* NOP */
476 #endif /* GST_DEBUG_ENABLE_DEPRECATED */
477
478 #else /* !G_HAVE_ISO_VARARGS */
479
480 #define GST_CAT_LEVEL_LOG(cat,level,args...)            /* NOP */
481
482 #define GST_CAT_ERROR_OBJECT(args...)                   /* NOP */
483 #define GST_CAT_WARNING_OBJECT(args...)                 /* NOP */
484 #define GST_CAT_INFO_OBJECT(args...)                    /* NOP */
485 #define GST_CAT_DEBUG_OBJECT(args...)                   /* NOP */
486 #define GST_CAT_LOG_OBJECT(args...)                     /* NOP */
487
488 #define GST_CAT_ERROR(args...)                          /* NOP */
489 #define GST_CAT_WARNING(args...)                        /* NOP */
490 #define GST_CAT_INFO(args...)                           /* NOP */
491 #define GST_CAT_DEBUG(args...)                          /* NOP */
492 #define GST_CAT_LOG(args...)                            /* NOP */
493
494 #define GST_ERROR_OBJECT(args...)                       /* NOP */
495 #define GST_WARNING_OBJECT(args...)                     /* NOP */
496 #define GST_INFO_OBJECT(args...)                        /* NOP */
497 #define GST_DEBUG_OBJECT(args...)                       /* NOP */
498 #define GST_LOG_OBJECT(args...)                         /* NOP */
499
500 #define GST_ERROR(args...)                              /* NOP */
501 #define GST_WARNING(args...)                            /* NOP */
502 #define GST_INFO(args...)                               /* NOP */
503 #define GST_DEBUG(args...)                              /* NOP */
504 #define GST_LOG(args...)                                /* NOP */
505
506 #ifdef GST_DEBUG_ENABLE_DEPRECATED
507 #define GST_INFO_ELEMENT(cat,obj,args...) /* NOP */
508 #define GST_DEBUG_ELEMENT(cat,obj,args...) /* NOP */
509 #define GST_DEBUG_ENTER(args...) /* NOP */
510 #define GST_DEBUG_LEAVE(args...) /* NOP */
511 #define GST_INFO_ENTER(args...) /* NOP */
512 #define GST_INFO_LEAVE(args...) /* NOP */
513 #endif /* GST_DEBUG_ENABLE_DEPRECATED */
514
515 #endif /* G_HAVE_ISO_VARARGS */
516
517 #define GST_DEBUG_FUNCPTR(ptr) (ptr)
518 #define GST_DEBUG_FUNCPTR_NAME(ptr) (g_strdup_printf ("%p", ptr))
519
520 #endif /* GST_DISABLE_GST_DEBUG */
521
522 void gst_debug_print_stack_trace (void);
523
524 /* timestamp debugging macros */
525 #define GST_TIME_FORMAT "%u:%02u:%02u:%09u"
526 #define GST_TIME_ARGS(t) \
527         (guint) (t / (GST_SECOND * 60 * 60)), \
528         (guint) ((t / (GST_SECOND * 60)) % 60), \
529         (guint) ((t / GST_SECOND) % 60), \
530         (guint) (t % GST_SECOND)
531
532 G_END_DECLS
533
534 #endif /* __GSTINFO_H__ */