1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
|
/* GIMP - The GNU Image Manipulation Program
* Copyright (C) 1995-2002 Spencer Kimball, Peter Mattis and others
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#ifndef __GIMP_TOOL_CONTROL_H__
#define __GIMP_TOOL_CONTROL_H__
#include "core/gimpobject.h"
#define GIMP_TYPE_TOOL_CONTROL (gimp_tool_control_get_type ())
#define GIMP_TOOL_CONTROL(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GIMP_TYPE_TOOL_CONTROL, GimpToolControl))
#define GIMP_TOOL_CONTROL_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GIMP_TYPE_TOOL_CONTROL, GimpToolControlClass))
#define GIMP_IS_TOOL_CONTROL(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GIMP_TYPE_TOOL_CONTROL))
#define GIMP_IS_TOOL_CONTROL_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_TOOL_CONTROL))
#define GIMP_TOOL_CONTROL_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GIMP_TYPE_TOOL_CONTROL, GimpToolControlClass))
typedef struct _GimpToolControlClass GimpToolControlClass;
struct _GimpToolControl
{
GimpObject parent_instance;
gboolean active; /* state of tool activity */
gint paused_count; /* paused control count */
gboolean preserve; /* Preserve this tool across *
* drawable changes */
GSList *preserve_stack; /* for push/pop preserve */
gboolean scroll_lock; /* allow scrolling or not */
gboolean handle_empty_image; /* invoke the tool on images *
* without active drawable */
GimpDirtyMask dirty_mask; /* if preserve is FALSE, stop *
* the tool on these events */
GimpToolAction dirty_action; /* use this action to stop the *
* tool when one of the dirty *
* events occurs */
GimpMotionMode motion_mode; /* how to process motion events *
* before they go to the tool */
gboolean auto_snap_to; /* snap to guides automatically */
gint snap_offset_x;
gint snap_offset_y;
gint snap_width;
gint snap_height;
GimpCursorPrecision precision;
gboolean wants_click; /* wants click detection */
gboolean wants_double_click;
gboolean wants_triple_click;
gboolean wants_all_key_events;
GimpToolActiveModifiers active_modifiers;
gboolean toggled;
GimpCursorType cursor;
GimpToolCursorType tool_cursor;
GimpCursorModifier cursor_modifier;
GimpCursorType toggle_cursor;
GimpToolCursorType toggle_tool_cursor;
GimpCursorModifier toggle_cursor_modifier;
gchar *action_size;
gchar *action_aspect;
gchar *action_angle;
gchar *action_spacing;
gchar *action_opacity;
gchar *action_hardness;
gchar *action_force;
gchar *action_object_1;
gchar *action_object_2;
/* Enum actions have a +-/min/max values which are not necessarily so
* useful. They also have a variable value which works as a per mille
* between the min and max, so it's hard to use, especially for
* actions which have a huge max or which can have negative values.
* For instance, aspect and angle can be negative. As for size and
* spacing, their max value can be huge. Finally "size" can be
* negative for the MyPaint brush tool, which uses a logarithmic
* radius as base value.
* For this reason, we also register specialized actions with clear
* unit if needed.
*/
gchar *action_pixel_size;
};
struct _GimpToolControlClass
{
GimpObjectClass parent_class;
};
GType gimp_tool_control_get_type (void) G_GNUC_CONST;
void gimp_tool_control_activate (GimpToolControl *control);
void gimp_tool_control_halt (GimpToolControl *control);
gboolean gimp_tool_control_is_active (GimpToolControl *control);
void gimp_tool_control_pause (GimpToolControl *control);
void gimp_tool_control_resume (GimpToolControl *control);
gboolean gimp_tool_control_is_paused (GimpToolControl *control);
void gimp_tool_control_set_preserve (GimpToolControl *control,
gboolean preserve);
gboolean gimp_tool_control_get_preserve (GimpToolControl *control);
void gimp_tool_control_push_preserve (GimpToolControl *control,
gboolean preserve);
void gimp_tool_control_pop_preserve (GimpToolControl *control);
void gimp_tool_control_set_scroll_lock (GimpToolControl *control,
gboolean scroll_lock);
gboolean gimp_tool_control_get_scroll_lock (GimpToolControl *control);
void gimp_tool_control_set_handle_empty_image
(GimpToolControl *control,
gboolean handle_empty);
gboolean gimp_tool_control_get_handle_empty_image
(GimpToolControl *control);
void gimp_tool_control_set_dirty_mask (GimpToolControl *control,
GimpDirtyMask dirty_mask);
GimpDirtyMask gimp_tool_control_get_dirty_mask (GimpToolControl *control);
void gimp_tool_control_set_dirty_action (GimpToolControl *control,
GimpToolAction action);
GimpToolAction gimp_tool_control_get_dirty_action (GimpToolControl *control);
void gimp_tool_control_set_motion_mode (GimpToolControl *control,
GimpMotionMode motion_mode);
GimpMotionMode gimp_tool_control_get_motion_mode (GimpToolControl *control);
void gimp_tool_control_set_snap_to (GimpToolControl *control,
gboolean snap_to);
gboolean gimp_tool_control_get_snap_to (GimpToolControl *control);
void gimp_tool_control_set_wants_click (GimpToolControl *control,
gboolean wants_click);
gboolean gimp_tool_control_get_wants_click (GimpToolControl *control);
void gimp_tool_control_set_wants_double_click
(GimpToolControl *control,
gboolean wants_double_click);
gboolean gimp_tool_control_get_wants_double_click
(GimpToolControl *control);
void gimp_tool_control_set_wants_triple_click
(GimpToolControl *control,
gboolean wants_double_click);
gboolean gimp_tool_control_get_wants_triple_click
(GimpToolControl *control);
void gimp_tool_control_set_wants_all_key_events
(GimpToolControl *control,
gboolean wants_key_events);
gboolean gimp_tool_control_get_wants_all_key_events
(GimpToolControl *control);
void gimp_tool_control_set_active_modifiers
(GimpToolControl *control,
GimpToolActiveModifiers active_modifiers);
GimpToolActiveModifiers
gimp_tool_control_get_active_modifiers
(GimpToolControl *control);
void gimp_tool_control_set_snap_offsets (GimpToolControl *control,
gint offset_x,
gint offset_y,
gint width,
gint height);
void gimp_tool_control_get_snap_offsets (GimpToolControl *control,
gint *offset_x,
gint *offset_y,
gint *width,
gint *height);
void gimp_tool_control_set_precision (GimpToolControl *control,
GimpCursorPrecision precision);
GimpCursorPrecision
gimp_tool_control_get_precision (GimpToolControl *control);
void gimp_tool_control_set_toggled (GimpToolControl *control,
gboolean toggled);
gboolean gimp_tool_control_get_toggled (GimpToolControl *control);
void gimp_tool_control_set_cursor (GimpToolControl *control,
GimpCursorType cursor);
void gimp_tool_control_set_tool_cursor (GimpToolControl *control,
GimpToolCursorType cursor);
void gimp_tool_control_set_cursor_modifier
(GimpToolControl *control,
GimpCursorModifier modifier);
void gimp_tool_control_set_toggle_cursor (GimpToolControl *control,
GimpCursorType cursor);
void gimp_tool_control_set_toggle_tool_cursor
(GimpToolControl *control,
GimpToolCursorType cursor);
void gimp_tool_control_set_toggle_cursor_modifier
(GimpToolControl *control,
GimpCursorModifier modifier);
GimpCursorType
gimp_tool_control_get_cursor (GimpToolControl *control);
GimpToolCursorType
gimp_tool_control_get_tool_cursor (GimpToolControl *control);
GimpCursorModifier
gimp_tool_control_get_cursor_modifier (GimpToolControl *control);
void gimp_tool_control_set_action_opacity (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_opacity (GimpToolControl *control);
void gimp_tool_control_set_action_size (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_size (GimpToolControl *control);
void gimp_tool_control_set_action_aspect (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_aspect (GimpToolControl *control);
void gimp_tool_control_set_action_angle (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_angle (GimpToolControl *control);
void gimp_tool_control_set_action_spacing (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_spacing (GimpToolControl *control);
void gimp_tool_control_set_action_hardness (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_hardness (GimpToolControl *control);
void gimp_tool_control_set_action_force (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_force (GimpToolControl *control);
void gimp_tool_control_set_action_object_1 (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_object_1 (GimpToolControl *control);
void gimp_tool_control_set_action_object_2 (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_object_2 (GimpToolControl *control);
void gimp_tool_control_set_action_pixel_size (GimpToolControl *control,
const gchar *action);
const gchar * gimp_tool_control_get_action_pixel_size (GimpToolControl *control);
#endif /* __GIMP_TOOL_CONTROL_H__ */
|
