← Back to branch summary

~ubuntu-branches/ubuntu/trusty/gstreamer1.0/trusty

« back to all changes in this revision

Viewing changes to gst/gstinfo.h

  • Committer: Package Import Robot
  • Author(s): Sebastian Dröge
  • Date: 2012-08-08 18:12:33 UTC
  • mfrom: (1.1.3)
  • Revision ID: package-import@ubuntu.com-20120808181233-riejwxprfsxh1njl
Tags: 0.11.93-1
* New upstream release:
  + debian/libgstreamer.symbols:
    - Update symbols file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
gst/gstinfo.h
46
46
 *  in the executed code path is not fully implemented or handled yet. Note
47
47
 *  that this does not replace proper error handling in any way, the purpose
48
48
 *  of this message is to make it easier to spot incomplete/unfinished pieces
49
 
 *  of code when reading the debug log. (Since: 0.10.23)
 
49
 *  of code when reading the debug log.
50
50
 * @GST_LEVEL_INFO: Informational messages should be used to keep the developer
51
51
 *  updated about what is happening.
52
52
 *  Examples where this should be used are when a typefind function has
63
63
 *  should never output anything else but LOG messages. Use this log level to
64
64
 *  log recurring information in chain functions and loop functions, for
65
65
 *  example.
66
 
 * @GST_LEVEL_TRACE: Tracing-related messages (Since: 0.10.30)
 
66
 * @GST_LEVEL_TRACE: Tracing-related messages.
67
67
 *  Examples for this are referencing/dereferencing of objects.
68
68
 * @GST_LEVEL_MEMDUMP: memory dump messages are used to log (small) chunks of
69
69
 *  data as memory dumps in the log. They will be displayed as hexdump with
70
 
 *  ASCII characters. (Since: 0.10.23)
 
70
 *  ASCII characters.
71
71
 * @GST_LEVEL_COUNT: The number of defined debugging levels.
72
72
 *
73
73
 * The level defines the importance of a debugging message. The more important a
241
241
 * @line: line number
242
242
 * @object: a #GObject
243
243
 * @message: the message
244
 
 * @data: user data for the log function
 
244
 * @user_data: user data for the log function
245
245
 *
246
246
 * Function prototype for a logging function that can be registered with
247
247
 * gst_debug_add_log_function().
254
254
                                 gint               line,
255
255
                                 GObject          * object,
256
256
                                 GstDebugMessage  * message,
257
 
                                 gpointer           data);
 
257
                                 gpointer           user_data);
258
258
 
259
259
#ifdef GST_USING_PRINTF_EXTENSION
260
260
 
330
330
const gchar *   gst_debug_level_get_name (GstDebugLevel level);
331
331
 
332
332
void            gst_debug_add_log_function            (GstLogFunction func,
333
 
                                                       gpointer       data);
 
333
                                                       gpointer       user_data,
 
334
                                                       GDestroyNotify notify);
334
335
 
335
336
guint           gst_debug_remove_log_function         (GstLogFunction func);
336
337
guint           gst_debug_remove_log_function_by_data (gpointer       data);
365
366
 
366
367
#ifndef GST_DISABLE_GST_DEBUG
367
368
 
368
 
#define gst_debug_add_log_function(func,data) \
369
 
G_STMT_START{                                 \
370
 
  if (func == gst_debug_log_default) {        \
371
 
    gst_debug_add_log_function(NULL,data);    \
372
 
  } else {                                    \
373
 
    gst_debug_add_log_function(func,data);    \
374
 
  }                                           \
 
369
#define gst_debug_add_log_function(func,data,notify) \
 
370
G_STMT_START{                                        \
 
371
  if (func == gst_debug_log_default) {               \
 
372
    gst_debug_add_log_function(NULL,data,notify);    \
 
373
  } else {                                           \
 
374
    gst_debug_add_log_function(func,data,notify);    \
 
375
  }                                                  \
375
376
}G_STMT_END
376
377
 
377
378
#define gst_debug_remove_log_function(func)   \
462
463
 * GST_DEBUG_CATEGORY_INIT (gst_myplugin_debug, "myplugin", 0, "nice element");
463
464
 * GST_DEBUG_CATEGORY_GET (GST_CAT_PERFORMANCE, "GST_PERFORMANCE");
464
465
 * ]|
465
 
 *
466
 
 * Since: 0.10.24
467
466
 */
468
467
#ifdef GST_CAT_DEFAULT
469
468
#define GST_DEBUG_CATEGORY_GET(cat,name)  G_STMT_START{\
487
486
/* this symbol may not be used */
488
487
GST_EXPORT gboolean                     _gst_debug_enabled;
489
488
 
490
 
/* since 0.10.7, the min debug level, used for quickly discarding debug
 
489
/* the min debug level, used for quickly discarding debug
491
490
 * messages that fall under the threshold. */
492
491
GST_EXPORT GstDebugLevel            _gst_debug_min;
493
492
 
608
607
 * @...: printf-style message to output
609
608
 *
610
609
 * Output a fixme message belonging to the given object in the given category.
611
 
 *
612
 
 * Since: 0.10.23
613
610
 */
614
611
/**
615
612
 * GST_CAT_TRACE_OBJECT:
619
616
 *
620
617
 * Output a tracing message belonging to the given object in the given
621
618
 * category.
622
 
 *
623
 
 * Since: 0.10.30
624
619
 */
625
620
/**
626
621
 * GST_CAT_MEMDUMP_OBJECT:
632
627
 *
633
628
 * Output a hexdump of @data relating to the given object in the given
634
629
 * category.
635
 
 *
636
 
 * Since: 0.10.23
637
630
 */
638
631
 
639
632
 
678
671
 * @...: printf-style message to output
679
672
 *
680
673
 * Output an fixme message in the given category.
681
 
 *
682
 
 * Since: 0.10.23
683
674
 */
684
675
/**
685
676
 * GST_CAT_TRACE:
687
678
 * @...: printf-style message to output
688
679
 *
689
680
 * Output a tracing message in the given category.
690
 
 *
691
 
 * Since: 0.10.30
692
681
 */
693
682
/**
694
683
 * GST_CAT_MEMDUMP:
698
687
 * @length: length of the data to output
699
688
 *
700
689
 * Output a hexdump of @data in the given category.
701
 
 *
702
 
 * Since: 0.10.23
703
690
 */
704
691
 
705
692
 
746
733
 * @...: printf-style message to output
747
734
 *
748
735
 * Output a fixme message belonging to the given object in the default category.
749
 
 *
750
 
 * Since: 0.10.23
751
736
 */
752
737
/**
753
738
 * GST_TRACE_OBJECT:
755
740
 * @...: printf-style message to output
756
741
 *
757
742
 * Output a tracing message belonging to the given object in the default category.
758
 
 *
759
 
 * Since: 0.10.30
760
743
 */
761
744
/**
762
745
 * GST_MEMDUMP_OBJECT:
766
749
 * @length: length of the data to output
767
750
 *
768
751
 * Output a logging message belonging to the given object in the default category.
769
 
 *
770
 
 * Since: 0.10.23
771
752
 */
772
753
 
773
754
 
806
787
 * @...: printf-style message to output
807
788
 *
808
789
 * Output a fixme message in the default category.
809
 
 *
810
 
 * Since: 0.10.23
811
790
 */
812
791
/**
813
792
 * GST_TRACE:
814
793
 * @...: printf-style message to output
815
794
 *
816
795
 * Output a tracing message in the default category.
817
 
 *
818
 
 * Since: 0.10.30
819
796
 */
820
797
/**
821
798
 * GST_MEMDUMP:
824
801
 * @length: length of the data to output
825
802
 *
826
803
 * Output a hexdump of @data.
827
 
 *
828
 
 * Since: 0.10.23
829
804
 */
830
805
 
831
806
#ifdef G_HAVE_ISO_VARARGS
1213
1188
 * GST_DEBUG_FUNCPTR_NAME().
1214
1189
 *
1215
1190
 * Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr.
1216
 
 *
1217
 
 * Since: 0.10.26
1218
1191
 */
1219
1192
#define GST_DEBUG_REGISTER_FUNCPTR(ptr) \
1220
1193
  _gst_debug_register_funcptr((GstDebugFuncPtr)(ptr), #ptr)
1262
1235
 
1263
1236
#define gst_debug_level_get_name(level)                         ("NONE")
1264
1237
#define gst_debug_message_get(message)                          ("")
1265
 
#define gst_debug_add_log_function(func,data)           G_STMT_START{ }G_STMT_END
 
1238
#define gst_debug_add_log_function(func,data,notify)    G_STMT_START{ }G_STMT_END
1266
1239
#define gst_debug_set_active(active)                    G_STMT_START{ }G_STMT_END
1267
1240
#define gst_debug_is_active()                           (FALSE)
1268
1241
#define gst_debug_set_colored(colored)                  G_STMT_START{ }G_STMT_END