1/* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16 */
17
18/*
19 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
20 * file for a list of people on the GTK+ Team. See the ChangeLog
21 * files for a list of changes. These files are distributed with
22 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
23 */
24
25#ifndef __GTK_DEBUG_H__
26#define __GTK_DEBUG_H__
27
28#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
29#error "Only <gtk/gtk.h> can be included directly."
30#endif
31
32#include <glib.h>
33#include <gdk/gdk.h>
34
35G_BEGIN_DECLS
36
37/**
38 * GtkDebugFlags:
39 * @GTK_DEBUG_TEXT: Information about GtkTextView
40 * @GTK_DEBUG_TREE: Information about GtkTreeView
41 * @GTK_DEBUG_KEYBINDINGS: Information about keyboard shortcuts
42 * @GTK_DEBUG_MODULES: Information about modules and extensions
43 * @GTK_DEBUG_GEOMETRY: Information about size allocation
44 * @GTK_DEBUG_ICONTHEME: Information about icon themes
45 * @GTK_DEBUG_PRINTING: Information about printing
46 * @GTK_DEBUG_BUILDER: Trace GtkBuilder operation
47 * @GTK_DEBUG_SIZE_REQUEST: Information about size requests
48 * @GTK_DEBUG_NO_CSS_CACHE: Disable the style property cache
49 * @GTK_DEBUG_INTERACTIVE: Open the GTK inspector
50 * @GTK_DEBUG_TOUCHSCREEN: Pretend the pointer is a touchscreen
51 * @GTK_DEBUG_ACTIONS: Information about actions and menu models
52 * @GTK_DEBUG_LAYOUT: Information from layout managers
53 * @GTK_DEBUG_SNAPSHOT: Include debug render nodes in the generated snapshots
54 * @GTK_DEBUG_CONSTRAINTS: Information from the constraints solver
55 * @GTK_DEBUG_BUILDER_OBJECTS: Log unused GtkBuilder objects
56 * @GTK_DEBUG_A11Y: Information about accessibility state changes
57 * @GTK_DEBUG_ICONFALLBACK: Information about icon fallback. Since: 4.2
58 *
59 * Flags to use with gtk_set_debug_flags().
60 *
61 * Settings these flags causes GTK to print out different
62 * types of debugging information. Some of these flags are
63 * only available when GTK has been configured with `-Ddebug=true`.
64 */
65typedef enum {
66 GTK_DEBUG_TEXT = 1 << 0,
67 GTK_DEBUG_TREE = 1 << 1,
68 GTK_DEBUG_KEYBINDINGS = 1 << 2,
69 GTK_DEBUG_MODULES = 1 << 3,
70 GTK_DEBUG_GEOMETRY = 1 << 4,
71 GTK_DEBUG_ICONTHEME = 1 << 5,
72 GTK_DEBUG_PRINTING = 1 << 6,
73 GTK_DEBUG_BUILDER = 1 << 7,
74 GTK_DEBUG_SIZE_REQUEST = 1 << 8,
75 GTK_DEBUG_NO_CSS_CACHE = 1 << 9,
76 GTK_DEBUG_INTERACTIVE = 1 << 10,
77 GTK_DEBUG_TOUCHSCREEN = 1 << 11,
78 GTK_DEBUG_ACTIONS = 1 << 12,
79 GTK_DEBUG_LAYOUT = 1 << 13,
80 GTK_DEBUG_SNAPSHOT = 1 << 14,
81 GTK_DEBUG_CONSTRAINTS = 1 << 15,
82 GTK_DEBUG_BUILDER_OBJECTS = 1 << 16,
83 GTK_DEBUG_A11Y = 1 << 17,
84 GTK_DEBUG_ICONFALLBACK = 1 << 18,
85} GtkDebugFlags;
86
87#ifdef G_ENABLE_DEBUG
88
89#define GTK_DEBUG_CHECK(type) G_UNLIKELY (gtk_get_debug_flags () & GTK_DEBUG_##type)
90
91#define GTK_NOTE(type,action) G_STMT_START { \
92 if (GTK_DEBUG_CHECK (type)) \
93 { action; }; } G_STMT_END
94
95#else /* !G_ENABLE_DEBUG */
96
97#define GTK_DEBUG_CHECK(type) 0
98#define GTK_NOTE(type, action)
99
100#endif /* G_ENABLE_DEBUG */
101
102GDK_AVAILABLE_IN_ALL
103GtkDebugFlags gtk_get_debug_flags (void);
104GDK_AVAILABLE_IN_ALL
105void gtk_set_debug_flags (GtkDebugFlags flags);
106
107G_END_DECLS
108
109#endif /* __GTK_DEBUG_H__ */
110

source code of gtk/gtk/gtkdebug.h