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 */
24 #ifndef __GSTINFO_H__
25 #define __GSTINFO_H__
27 #include <glib.h>
28 #include <glib-object.h>
29 #include <gst/gstconfig.h>
31 G_BEGIN_DECLS
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 */
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;
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
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;
91 #define GST_DEBUG_FG_MASK (0x000F)
92 #define GST_DEBUG_BG_MASK (0x00F0)
93 #define GST_DEBUG_FORMAT_MASK (0xFF00)
95 typedef struct _GstDebugCategory GstDebugCategory;
96 struct _GstDebugCategory {
97 /*< private >*/
98 gint threshold;
99 guint color; /* see defines above */
101 const gchar * name;
102 const gchar * description;
103 };
105 /********** some convenience macros for debugging **********/
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)")
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)
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 */
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);
139 #ifndef GST_DISABLE_GST_DEBUG
141 void _gst_debug_init (void);
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;
162 const gchar * gst_debug_message_get (GstDebugMessage * message);
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;
173 G_CONST_RETURN gchar *
174 gst_debug_level_get_name (GstDebugLevel level);
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);
181 void gst_debug_set_active (gboolean active);
182 gboolean gst_debug_is_active (void);
184 void gst_debug_set_colored (gboolean colored);
185 gboolean gst_debug_is_colored (void);
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);
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
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);
275 gchar * gst_debug_construct_term_color (guint colorinfo);
278 GST_EXPORT GstDebugCategory * GST_CAT_DEFAULT;
279 /* this symbol may not be used */
280 extern gboolean __gst_debug_enabled;
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 }
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;
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 */
321 #ifdef G_HAVE_ISO_VARARGS
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__)
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__)
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__)
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__)
347 #else
348 #ifdef G_HAVE_GNUC_VARARGS
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 )
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 )
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 )
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 )
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;
382 va_start (varargs, format);
383 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_ERROR, obj, format, varargs);
384 va_end (varargs);
385 }
387 static inline void
388 GST_CAT_WARNING_OBJECT (GstDebugCategory * cat, gpointer obj,
389 const char *format, ...)
390 {
391 va_list varargs;
393 va_start (varargs, format);
394 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_WARNING, obj, format, varargs);
395 va_end (varargs);
396 }
398 static inline void
399 GST_CAT_INFO_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
400 ...)
401 {
402 va_list varargs;
404 va_start (varargs, format);
405 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_INFO, obj, format, varargs);
406 va_end (varargs);
407 }
409 static inline void
410 GST_CAT_DEBUG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
411 ...)
412 {
413 va_list varargs;
415 va_start (varargs, format);
416 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_DEBUG, obj, format, varargs);
417 va_end (varargs);
418 }
420 static inline void
421 GST_CAT_LOG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
422 ...)
423 {
424 va_list varargs;
426 va_start (varargs, format);
427 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_LOG, obj, format, varargs);
428 va_end (varargs);
429 }
431 static inline void
432 GST_CAT_ERROR (GstDebugCategory * cat, const char *format, ...)
433 {
434 va_list varargs;
436 va_start (varargs, format);
437 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_ERROR, NULL, format, varargs);
438 va_end (varargs);
439 }
441 static inline void
442 GST_CAT_WARNING (GstDebugCategory * cat, const char *format, ...)
443 {
444 va_list varargs;
446 va_start (varargs, format);
447 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_WARNING, NULL, format, varargs);
448 va_end (varargs);
449 }
451 static inline void
452 GST_CAT_INFO (GstDebugCategory * cat, const char *format, ...)
453 {
454 va_list varargs;
456 va_start (varargs, format);
457 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_INFO, NULL, format, varargs);
458 va_end (varargs);
459 }
461 static inline void
462 GST_CAT_DEBUG (GstDebugCategory * cat, const char *format, ...)
463 {
464 va_list varargs;
466 va_start (varargs, format);
467 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_DEBUG, NULL, format, varargs);
468 va_end (varargs);
469 }
471 static inline void
472 GST_CAT_LOG (GstDebugCategory * cat, const char *format, ...)
473 {
474 va_list varargs;
476 va_start (varargs, format);
477 GST_CAT_LEVEL_LOG_valist (cat, GST_LEVEL_LOG, NULL, format, varargs);
478 va_end (varargs);
479 }
481 static inline void
482 GST_ERROR_OBJECT (gpointer obj, const char *format, ...)
483 {
484 va_list varargs;
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 }
492 static inline void
493 GST_WARNING_OBJECT (gpointer obj, const char *format, ...)
494 {
495 va_list varargs;
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 }
503 static inline void
504 GST_INFO_OBJECT (gpointer obj, const char *format, ...)
505 {
506 va_list varargs;
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 }
514 static inline void
515 GST_DEBUG_OBJECT (gpointer obj, const char *format, ...)
516 {
517 va_list varargs;
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 }
525 static inline void
526 GST_LOG_OBJECT (gpointer obj, const char *format, ...)
527 {
528 va_list varargs;
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 }
536 static inline void
537 GST_ERROR (const char *format, ...)
538 {
539 va_list varargs;
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 }
547 static inline void
548 GST_WARNING (const char *format, ...)
549 {
550 va_list varargs;
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 }
558 static inline void
559 GST_INFO (const char *format, ...)
560 {
561 va_list varargs;
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 }
569 static inline void
570 GST_DEBUG (const char *format, ...)
571 {
572 va_list varargs;
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 }
580 static inline void
581 GST_LOG (const char *format, ...)
582 {
583 va_list varargs;
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
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);
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)
606 #else /* GST_DISABLE_GST_DEBUG */
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
614 #define _gst_debug_init() /* NOP */
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)
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 */
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"))
652 #ifdef G_HAVE_ISO_VARARGS
654 #define GST_CAT_LEVEL_LOG(cat,level,...) /* NOP */
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 */
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 */
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 */
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 */
680 #else
681 #ifdef G_HAVE_GNUC_VARARGS
683 #define GST_CAT_LEVEL_LOG(cat,level,args...) /* NOP */
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 */
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 */
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 */
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 */
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 }
716 static inline void
717 GST_CAT_ERROR_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
718 ...)
719 {
720 }
722 static inline void
723 GST_CAT_WARNING_OBJECT (GstDebugCategory * cat, gpointer obj,
724 const char *format, ...)
725 {
726 }
728 static inline void
729 GST_CAT_INFO_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
730 ...)
731 {
732 }
734 static inline void
735 GST_CAT_DEBUG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
736 ...)
737 {
738 }
740 static inline void
741 GST_CAT_LOG_OBJECT (GstDebugCategory * cat, gpointer obj, const char *format,
742 ...)
743 {
744 }
746 static inline void
747 GST_CAT_ERROR (GstDebugCategory * cat, const char *format, ...)
748 {
749 }
751 static inline void
752 GST_CAT_WARNING (GstDebugCategory * cat, const char *format, ...)
753 {
754 }
756 static inline void
757 GST_CAT_INFO (GstDebugCategory * cat, const char *format, ...)
758 {
759 }
761 static inline void
762 GST_CAT_DEBUG (GstDebugCategory * cat, const char *format, ...)
763 {
764 }
766 static inline void
767 GST_CAT_LOG (GstDebugCategory * cat, const char *format, ...)
768 {
769 }
771 static inline void
772 GST_ERROR_OBJECT (gpointer obj, const char *format, ...)
773 {
774 }
776 static inline void
777 GST_WARNING_OBJECT (gpointer obj, const char *format, ...)
778 {
779 }
781 static inline void
782 GST_INFO_OBJECT (gpointer obj, const char *format, ...)
783 {
784 }
786 static inline void
787 GST_DEBUG_OBJECT (gpointer obj, const char *format, ...)
788 {
789 }
791 static inline void
792 GST_LOG_OBJECT (gpointer obj, const char *format, ...)
793 {
794 }
796 static inline void
797 GST_ERROR (const char *format, ...)
798 {
799 }
801 static inline void
802 GST_WARNING (const char *format, ...)
803 {
804 }
806 static inline void
807 GST_INFO (const char *format, ...)
808 {
809 }
811 static inline void
812 GST_DEBUG (const char *format, ...)
813 {
814 }
816 static inline void
817 GST_LOG (const char *format, ...)
818 {
819 }
820 #endif
821 #endif
823 #define GST_DEBUG_FUNCPTR(ptr) (ptr)
824 #define GST_DEBUG_FUNCPTR_NAME(ptr) (g_strdup_printf ("%p", ptr))
826 #endif /* GST_DISABLE_GST_DEBUG */
828 void gst_debug_print_stack_trace (void);
830 G_END_DECLS
832 #endif /* __GSTINFO_H__ */