gst/gstinfo.*: Fix illegal cast on some platforms (#309253).
[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/gstconfig.h>
30
31 G_BEGIN_DECLS
32
33 /*
34  * GStreamer's debugging subsystem is an easy way to get information about what
35  * the application is doing.
36  * It is not meant for programming errors. Use GLibs methods (g_warning and so
37  * on for that.
38  */
39
40 /* log levels */
41 typedef enum {
42   GST_LEVEL_NONE = 0,
43   GST_LEVEL_ERROR,
44   GST_LEVEL_WARNING,
45   GST_LEVEL_INFO,
46   GST_LEVEL_DEBUG,
47   GST_LEVEL_LOG,
48   /* add more */
49   GST_LEVEL_COUNT
50 } GstDebugLevel;
51
52 /* we can now override this to be more general in maintainer builds
53  * or cvs checkouts */
54 #ifndef GST_LEVEL_DEFAULT
55 #define GST_LEVEL_DEFAULT GST_LEVEL_NONE
56 #endif
57
58 /* defines for format (colors etc)
59  * 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   gint                  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 /* FIXME, not MT safe */
112 #define GST_DEBUG_PAD_NAME(pad) \
113   (GST_OBJECT_PARENT(pad) != NULL) ? \
114   GST_STR_NULL (GST_OBJECT_NAME (GST_OBJECT_PARENT(pad))) : \
115   "''", GST_OBJECT_NAME (pad)
116
117 /* You might want to define GST_FUNCTION in apps' configure script. */
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
266         gst_debug_category_get_threshold (GstDebugCategory *    category);
267 G_CONST_RETURN gchar *
268         gst_debug_category_get_name     (GstDebugCategory *     category);
269 guint   gst_debug_category_get_color    (GstDebugCategory *     category);
270 G_CONST_RETURN gchar *
271         gst_debug_category_get_description (GstDebugCategory *  category);
272 GSList *
273         gst_debug_get_all_categories    (void);
274
275 gchar * gst_debug_construct_term_color  (guint colorinfo);
276
277
278 GST_EXPORT GstDebugCategory *   GST_CAT_DEFAULT;
279 /* this symbol may not be used */
280 extern gboolean                 __gst_debug_enabled;
281
282 #ifdef G_HAVE_ISO_VARARGS
283 #define GST_CAT_LEVEL_LOG(cat,level,object,...) G_STMT_START{           \
284   if (__gst_debug_enabled) {                                            \
285     gst_debug_log ((cat), (level), __FILE__, GST_FUNCTION, __LINE__,    \
286         (GObject *) (object), __VA_ARGS__);                             \
287   }                                                                     \
288 }G_STMT_END
289 #else /* G_HAVE_GNUC_VARARGS */
290 #ifdef G_HAVE_GNUC_VARARGS
291 #define GST_CAT_LEVEL_LOG(cat,level,object,args...) G_STMT_START{       \
292   if (__gst_debug_enabled) {                                            \
293     gst_debug_log ((cat), (level), __FILE__, GST_FUNCTION, __LINE__,    \
294         (GObject *) (object), ##args );                                 \
295   }                                                                     \
296 }G_STMT_END
297 #else /* no variadic macros, use inline */
298 static inline void
299 GST_CAT_LEVEL_LOG_valist (GstDebugCategory * cat,
300     GstDebugLevel level, gpointer object, const char *format, va_list varargs)
301 {
302   gst_debug_log_valist (cat, level, "", "", 0, (GObject *) object, format,
303       varargs);
304 }
305
306 static inline void
307 GST_CAT_LEVEL_LOG (GstDebugCategory * cat, GstDebugLevel level,
308     gpointer object, const char *format, ...)
309 {
310   if (__gst_debug_enabled) {
311     va_list varargs;
312
313     va_start (varargs, format);
314     GST_CAT_LEVEL_LOG_valist (cat, level, object, format, varargs);
315     va_end (varargs);
316   }
317 }
318 #endif
319 #endif /* G_HAVE_ISO_VARARGS */
320
321 #ifdef G_HAVE_ISO_VARARGS
322
323 #define GST_CAT_ERROR_OBJECT(cat,obj,...)       GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   obj,  __VA_ARGS__)
324 #define GST_CAT_WARNING_OBJECT(cat,obj,...)     GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, obj,  __VA_ARGS__)
325 #define GST_CAT_INFO_OBJECT(cat,obj,...)        GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    obj,  __VA_ARGS__)
326 #define GST_CAT_DEBUG_OBJECT(cat,obj,...)       GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   obj,  __VA_ARGS__)
327 #define GST_CAT_LOG_OBJECT(cat,obj,...)         GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     obj,  __VA_ARGS__)
328
329 #define GST_CAT_ERROR(cat,...)                  GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   NULL, __VA_ARGS__)
330 #define GST_CAT_WARNING(cat,...)                GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, NULL, __VA_ARGS__)
331 #define GST_CAT_INFO(cat,...)                   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
332 #define GST_CAT_DEBUG(cat,...)                  GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
333 #define GST_CAT_LOG(cat,...)                    GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     NULL, __VA_ARGS__)
334
335 #define GST_ERROR_OBJECT(obj,...)       GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   obj,  __VA_ARGS__)
336 #define GST_WARNING_OBJECT(obj,...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj,  __VA_ARGS__)
337 #define GST_INFO_OBJECT(obj,...)        GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj,  __VA_ARGS__)
338 #define GST_DEBUG_OBJECT(obj,...)       GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj,  __VA_ARGS__)
339 #define GST_LOG_OBJECT(obj,...)         GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     obj,  __VA_ARGS__)
340
341 #define GST_ERROR(...)                  GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   NULL, __VA_ARGS__)
342 #define GST_WARNING(...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, __VA_ARGS__)
343 #define GST_INFO(...)                   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, __VA_ARGS__)
344 #define GST_DEBUG(...)                  GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, __VA_ARGS__)
345 #define GST_LOG(...)                    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     NULL, __VA_ARGS__)
346
347 #else
348 #ifdef G_HAVE_GNUC_VARARGS
349
350 #define GST_CAT_ERROR_OBJECT(cat,obj,args...)   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   obj,  ##args )
351 #define GST_CAT_WARNING_OBJECT(cat,obj,args...) GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, obj,  ##args )
352 #define GST_CAT_INFO_OBJECT(cat,obj,args...)    GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    obj,  ##args )
353 #define GST_CAT_DEBUG_OBJECT(cat,obj,args...)   GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   obj,  ##args )
354 #define GST_CAT_LOG_OBJECT(cat,obj,args...)     GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     obj,  ##args )
355
356 #define GST_CAT_ERROR(cat,args...)              GST_CAT_LEVEL_LOG (cat, GST_LEVEL_ERROR,   NULL, ##args )
357 #define GST_CAT_WARNING(cat,args...)            GST_CAT_LEVEL_LOG (cat, GST_LEVEL_WARNING, NULL, ##args )
358 #define GST_CAT_INFO(cat,args...)               GST_CAT_LEVEL_LOG (cat, GST_LEVEL_INFO,    NULL, ##args )
359 #define GST_CAT_DEBUG(cat,args...)              GST_CAT_LEVEL_LOG (cat, GST_LEVEL_DEBUG,   NULL, ##args )
360 #define GST_CAT_LOG(cat,args...)                GST_CAT_LEVEL_LOG (cat, GST_LEVEL_LOG,     NULL, ##args )
361
362 #define GST_ERROR_OBJECT(obj,args...)   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   obj,  ##args )
363 #define GST_WARNING_OBJECT(obj,args...) GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj,  ##args )
364 #define GST_INFO_OBJECT(obj,args...)    GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    obj,  ##args )
365 #define GST_DEBUG_OBJECT(obj,args...)   GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   obj,  ##args )
366 #define GST_LOG_OBJECT(obj,args...)     GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     obj,  ##args )
367
368 #define GST_ERROR(args...)              GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_ERROR,   NULL, ##args )
369 #define GST_WARNING(args...)            GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, ##args )
370 #define GST_INFO(args...)               GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_INFO,    NULL, ##args )
371 #define GST_DEBUG(args...)              GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_DEBUG,   NULL, ##args )
372 #define GST_LOG(args...)                GST_CAT_LEVEL_LOG (GST_CAT_DEFAULT, GST_LEVEL_LOG,     NULL, ##args )
373
374 #else
375 /* no variadic macros, use inline */
376 static inline void
377 GST_CAT_ERROR_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
378     ...)
379 {
380   va_list varargs;
381
382   va_start (varargs, format);
383   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_ERROR, obj, format, varargs);
384   va_end (varargs);
385 }
386
387 static inline void
388 GST_CAT_WARNING_OBJECT (GstDebugCategory * cat, gpointer obj,
389     const char *format, ...)
390 {
391   va_list varargs;
392
393   va_start (varargs, format);
394   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_WARNING, obj, format, varargs);
395   va_end (varargs);
396 }
397
398 static inline void
399 GST_CAT_INFO_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
400     ...)
401 {
402   va_list varargs;
403
404   va_start (varargs, format);
405   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_INFO, obj, format, varargs);
406   va_end (varargs);
407 }
408
409 static inline void
410 GST_CAT_DEBUG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
411     ...)
412 {
413   va_list varargs;
414
415   va_start (varargs, format);
416   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_DEBUG, obj, format, varargs);
417   va_end (varargs);
418 }
419
420 static inline void
421 GST_CAT_LOG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
422     ...)
423 {
424   va_list varargs;
425
426   va_start (varargs, format);
427   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_LOG, obj, format, varargs);
428   va_end (varargs);
429 }
430
431 static inline void
432 GST_CAT_ERROR (GstDebugCategory * cat, const char *format, ...)
433 {
434   va_list varargs;
435
436   va_start (varargs, format);
437   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_ERROR, NULL, format, varargs);
438   va_end (varargs);
439 }
440
441 static inline void
442 GST_CAT_WARNING (GstDebugCategory * cat, const char *format, ...)
443 {
444   va_list varargs;
445
446   va_start (varargs, format);
447   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_WARNING, NULL, format, varargs);
448   va_end (varargs);
449 }
450
451 static inline void
452 GST_CAT_INFO (GstDebugCategory * cat, const char *format, ...)
453 {
454   va_list varargs;
455
456   va_start (varargs, format);
457   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_INFO, NULL, format, varargs);
458   va_end (varargs);
459 }
460
461 static inline void
462 GST_CAT_DEBUG (GstDebugCategory * cat, const char *format, ...)
463 {
464   va_list varargs;
465
466   va_start (varargs, format);
467   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_DEBUG, NULL, format, varargs);
468   va_end (varargs);
469 }
470
471 static inline void
472 GST_CAT_LOG (GstDebugCategory * cat, const char *format, ...)
473 {
474   va_list varargs;
475
476   va_start (varargs, format);
477   GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_LOG, NULL, format, varargs);
478   va_end (varargs);
479 }
480
481 static inline void
482 GST_ERROR_OBJECT (gpointer obj, const char *format, ...)
483 {
484   va_list varargs;
485
486   va_start (varargs, format);
487   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_ERROR, obj, format,
488       varargs);
489   va_end (varargs);
490 }
491
492 static inline void
493 GST_WARNING_OBJECT (gpointer obj, const char *format, ...)
494 {
495   va_list varargs;
496
497   va_start (varargs, format);
498   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_WARNING, obj, format,
499       varargs);
500   va_end (varargs);
501 }
502
503 static inline void
504 GST_INFO_OBJECT (gpointer obj, const char *format, ...)
505 {
506   va_list varargs;
507
508   va_start (varargs, format);
509   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_INFO, obj, format,
510       varargs);
511   va_end (varargs);
512 }
513
514 static inline void
515 GST_DEBUG_OBJECT (gpointer obj, const char *format, ...)
516 {
517   va_list varargs;
518
519   va_start (varargs, format);
520   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_DEBUG, obj, format,
521       varargs);
522   va_end (varargs);
523 }
524
525 static inline void
526 GST_LOG_OBJECT (gpointer obj, const char *format, ...)
527 {
528   va_list varargs;
529
530   va_start (varargs, format);
531   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_LOG, obj, format,
532       varargs);
533   va_end (varargs);
534 }
535
536 static inline void
537 GST_ERROR (const char *format, ...)
538 {
539   va_list varargs;
540
541   va_start (varargs, format);
542   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_ERROR, NULL, format,
543       varargs);
544   va_end (varargs);
545 }
546
547 static inline void
548 GST_WARNING (const char *format, ...)
549 {
550   va_list varargs;
551
552   va_start (varargs, format);
553   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_WARNING, NULL, format,
554       varargs);
555   va_end (varargs);
556 }
557
558 static inline void
559 GST_INFO (const char *format, ...)
560 {
561   va_list varargs;
562
563   va_start (varargs, format);
564   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_INFO, NULL, format,
565       varargs);
566   va_end (varargs);
567 }
568
569 static inline void
570 GST_DEBUG (const char *format, ...)
571 {
572   va_list varargs;
573
574   va_start (varargs, format);
575   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_DEBUG, NULL, format,
576       varargs);
577   va_end (varargs);
578 }
579
580 static inline void
581 GST_LOG (const char *format, ...)
582 {
583   va_list varargs;
584
585   va_start (varargs, format);
586   GST_CAT_LEVEL_LOG_valist (GST_CAT_DEFAULT, GST_LEVEL_LOG, NULL,
587       format, varargs);
588   va_end (varargs);
589 }
590 #endif
591 #endif
592
593
594 /********** function pointer stuff **********/
595 typedef void (* GstDebugFuncPtr)        (void);
596 void    _gst_debug_register_funcptr     (GstDebugFuncPtr        func,
597                                          gchar *                ptrname);
598 G_CONST_RETURN gchar *
599         _gst_debug_nameof_funcptr       (GstDebugFuncPtr        func);
600
601 #define GST_DEBUG_FUNCPTR(ptr) \
602   (_gst_debug_register_funcptr((GstDebugFuncPtr)(ptr), #ptr) , ptr)
603 #define GST_DEBUG_FUNCPTR_NAME(ptr) \
604   _gst_debug_nameof_funcptr((GstDebugFuncPtr)ptr)
605
606 #else /* GST_DISABLE_GST_DEBUG */
607
608 #if defined(__GNUC__) && __GNUC__ >= 3
609 #  pragma GCC poison gst_debug_log
610 #  pragma GCC poison gst_debug_log_valist
611 #  pragma GCC poison _gst_debug_category_new
612 #endif
613
614 #define _gst_debug_init()                               /* NOP */
615
616 #define gst_debug_set_log_function(func,data)           /* NOP */
617 #define gst_debug_reset_log_function(void)              /* NOP */
618 #define gst_debug_set_default_threshold(level)          /* NOP */
619 #define gst_debug_get_default_threshold()               (GST_LEVEL_NONE)
620
621 #define gst_debug_level_get_name(level)                 ("NONE")
622 #define gst_debug_add_log_function(func,data)           /* NOP */
623 guint           gst_debug_remove_log_function   (GstLogFunction         func);
624 guint           gst_debug_remove_log_function_by_data (gpointer         data);
625 #define gst_debug_set_active(active)                    /* NOP */
626 #define gst_debug_is_active()                           (FALSE)
627 #define gst_debug_set_colored(colored)                  /* NOP */
628 #define gst_debug_is_colored()                          (FALSE)
629 #define gst_debug_set_default_threshold(level)          /* NOP */
630 #define gst_debug_get_default_threshold()               (GST_LEVEL_NONE)
631 #define gst_debug_set_threshold_for_name(name,level)    /* NOP */
632 #define gst_debug_unset_threshold_for_name(name)        /* NOP */
633
634 #define GST_DEBUG_CATEGORY(var)                         /* NOP */
635 #define GST_DEBUG_CATEGORY_EXTERN(var)                  /* NOP */
636 #if !defined(G_HAVE_GNUC_VARARGS) && !defined(G_HAVE_ISO_VARARGS)
637 #define GST_DEBUG_CATEGORY_STATIC(var)                  static GstDebugCategory *var = NULL
638 #else
639 #define GST_DEBUG_CATEGORY_STATIC(var)                  /* NOP */
640 #endif
641 #define GST_DEBUG_CATEGORY_INIT(var,name,color,desc)    /* NOP */
642 #define gst_debug_category_free(category)               /* NOP */
643 #define gst_debug_category_set_threshold(category,level) /* NOP */
644 #define gst_debug_category_reset_threshold(category)    /* NOP */
645 #define gst_debug_category_get_threshold(category)      (GST_LEVEL_NONE)
646 #define gst_debug_category_get_name(cat)                ("")
647 #define gst_debug_category_get_color(cat)               (0)
648 #define gst_debug_category_get_description(cat)         ("")
649 #define gst_debug_get_all_categories()                  (NULL)
650 #define gst_debug_construct_term_color(colorinfo)       (g_strdup ("00"))
651
652 #ifdef G_HAVE_ISO_VARARGS
653
654 #define GST_CAT_LEVEL_LOG(cat,level,...)                /* NOP */
655
656 #define GST_CAT_ERROR_OBJECT(...)                       /* NOP */
657 #define GST_CAT_WARNING_OBJECT(...)                     /* NOP */
658 #define GST_CAT_INFO_OBJECT(...)                        /* NOP */
659 #define GST_CAT_DEBUG_OBJECT(...)                       /* NOP */
660 #define GST_CAT_LOG_OBJECT(...)                         /* NOP */
661
662 #define GST_CAT_ERROR(...)                              /* NOP */
663 #define GST_CAT_WARNING(...)                            /* NOP */
664 #define GST_CAT_INFO(...)                               /* NOP */
665 #define GST_CAT_DEBUG(...)                              /* NOP */
666 #define GST_CAT_LOG(...)                                /* NOP */
667
668 #define GST_ERROR_OBJECT(...)                           /* NOP */
669 #define GST_WARNING_OBJECT(...)                         /* NOP */
670 #define GST_INFO_OBJECT(...)                            /* NOP */
671 #define GST_DEBUG_OBJECT(...)                           /* NOP */
672 #define GST_LOG_OBJECT(...)                             /* NOP */
673
674 #define GST_ERROR(...)                                  /* NOP */
675 #define GST_WARNING(...)                                /* NOP */
676 #define GST_INFO(...)                                   /* NOP */
677 #define GST_DEBUG(...)                                  /* NOP */
678 #define GST_LOG(...)                                    /* NOP */
679
680 #else
681 #ifdef G_HAVE_GNUC_VARARGS
682
683 #define GST_CAT_LEVEL_LOG(cat,level,args...)            /* NOP */
684
685 #define GST_CAT_ERROR_OBJECT(args...)                   /* NOP */
686 #define GST_CAT_WARNING_OBJECT(args...)                 /* NOP */
687 #define GST_CAT_INFO_OBJECT(args...)                    /* NOP */
688 #define GST_CAT_DEBUG_OBJECT(args...)                   /* NOP */
689 #define GST_CAT_LOG_OBJECT(args...)                     /* NOP */
690
691 #define GST_CAT_ERROR(args...)                          /* NOP */
692 #define GST_CAT_WARNING(args...)                        /* NOP */
693 #define GST_CAT_INFO(args...)                           /* NOP */
694 #define GST_CAT_DEBUG(args...)                          /* NOP */
695 #define GST_CAT_LOG(args...)                            /* NOP */
696
697 #define GST_ERROR_OBJECT(args...)                       /* NOP */
698 #define GST_WARNING_OBJECT(args...)                     /* NOP */
699 #define GST_INFO_OBJECT(args...)                        /* NOP */
700 #define GST_DEBUG_OBJECT(args...)                       /* NOP */
701 #define GST_LOG_OBJECT(args...)                         /* NOP */
702
703 #define GST_ERROR(args...)                              /* NOP */
704 #define GST_WARNING(args...)                            /* NOP */
705 #define GST_INFO(args...)                               /* NOP */
706 #define GST_DEBUG(args...)                              /* NOP */
707 #define GST_LOG(args...)                                /* NOP */
708
709 #else
710 static inline void
711 GST_CAT_LEVEL_LOG_valist (GstDebugCategory * cat,
712     GstDebugLevel level, gpointer object, const char *format, va_list varargs)
713 {
714 }
715
716 static inline void
717 GST_CAT_ERROR_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
718     ...)
719 {
720 }
721
722 static inline void
723 GST_CAT_WARNING_OBJECT (GstDebugCategory * cat, gpointer obj,
724     const char *format, ...)
725 {
726 }
727
728 static inline void
729 GST_CAT_INFO_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
730     ...)
731 {
732 }
733
734 static inline void
735 GST_CAT_DEBUG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
736     ...)
737 {
738 }
739
740 static inline void
741 GST_CAT_LOG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
742     ...)
743 {
744 }
745
746 static inline void
747 GST_CAT_ERROR (GstDebugCategory * cat, const char *format, ...)
748 {
749 }
750
751 static inline void
752 GST_CAT_WARNING (GstDebugCategory * cat, const char *format, ...)
753 {
754 }
755
756 static inline void
757 GST_CAT_INFO (GstDebugCategory * cat, const char *format, ...)
758 {
759 }
760
761 static inline void
762 GST_CAT_DEBUG (GstDebugCategory * cat, const char *format, ...)
763 {
764 }
765
766 static inline void
767 GST_CAT_LOG (GstDebugCategory * cat, const char *format, ...)
768 {
769 }
770
771 static inline void
772 GST_ERROR_OBJECT (gpointer obj, const char *format, ...)
773 {
774 }
775
776 static inline void
777 GST_WARNING_OBJECT (gpointer obj, const char *format, ...)
778 {
779 }
780
781 static inline void
782 GST_INFO_OBJECT (gpointer obj, const char *format, ...)
783 {
784 }
785
786 static inline void
787 GST_DEBUG_OBJECT (gpointer obj, const char *format, ...)
788 {
789 }
790
791 static inline void
792 GST_LOG_OBJECT (gpointer obj, const char *format, ...)
793 {
794 }
795
796 static inline void
797 GST_ERROR (const char *format, ...)
798 {
799 }
800
801 static inline void
802 GST_WARNING (const char *format, ...)
803 {
804 }
805
806 static inline void
807 GST_INFO (const char *format, ...)
808 {
809 }
810
811 static inline void
812 GST_DEBUG (const char *format, ...)
813 {
814 }
815
816 static inline void
817 GST_LOG (const char *format, ...)
818 {
819 }
820 #endif
821 #endif
822
823 #define GST_DEBUG_FUNCPTR(ptr) (ptr)
824 #define GST_DEBUG_FUNCPTR_NAME(ptr) (g_strdup_printf ("%p", ptr))
825
826 #endif /* GST_DISABLE_GST_DEBUG */
827
828 void gst_debug_print_stack_trace (void);
829
830 G_END_DECLS
831
832 #endif /* __GSTINFO_H__ */