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 | |
35 | G_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 | */ |
65 | typedef 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 | |
102 | GDK_AVAILABLE_IN_ALL |
103 | GtkDebugFlags gtk_get_debug_flags (void); |
104 | GDK_AVAILABLE_IN_ALL |
105 | void gtk_set_debug_flags (GtkDebugFlags flags); |
106 | |
107 | G_END_DECLS |
108 | |
109 | #endif /* __GTK_DEBUG_H__ */ |
110 | |