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
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
|
/*
* ***** BEGIN GPL LICENSE BLOCK *****
*
* 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 2
* 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, write to the Free Software Foundation,
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
* The Original Code is Copyright (C) 2016 Blender Foundation.
* All rights reserved.
*
* Contributor(s): none yet.
*
* ***** END GPL LICENSE BLOCK *****
*/
/** \file blender/windowmanager/gizmo/WM_gizmo_api.h
* \ingroup wm
*
* \name Gizmo API
* \brief API for external use of wmGizmo types.
*
* Only included in WM_api.h
*/
#ifndef __WM_GIZMO_API_H__
#define __WM_GIZMO_API_H__
struct ARegion;
struct GHashIterator;
struct IDProperty;
struct Main;
struct PropertyRNA;
struct wmKeyConfig;
struct wmGizmo;
struct wmGizmoProperty;
struct wmGizmoPropertyType;
struct wmGizmoType;
struct wmGizmoGroup;
struct wmGizmoGroupType;
struct wmGizmoMap;
struct wmGizmoMapType;
struct wmGizmoMapType_Params;
struct wmMsgSubscribeKey;
struct wmMsgSubscribeValue;
#include "wm_gizmo_fn.h"
/* -------------------------------------------------------------------- */
/* wmGizmo */
struct wmGizmo *WM_gizmo_new_ptr(
const struct wmGizmoType *wt, struct wmGizmoGroup *mgroup,
struct PointerRNA *properties);
struct wmGizmo *WM_gizmo_new(
const char *idname, struct wmGizmoGroup *mgroup,
struct PointerRNA *properties);
void WM_gizmo_free(struct wmGizmo *mpr);
void WM_gizmo_unlink(
ListBase *gizmolist, struct wmGizmoMap *mmap, struct wmGizmo *mpr,
struct bContext *C);
void WM_gizmo_name_set(struct wmGizmoGroup *mgroup, struct wmGizmo *mpr, const char *name);
bool WM_gizmo_select_unlink(struct wmGizmoMap *mmap, struct wmGizmo *mpr);
bool WM_gizmo_select_set(struct wmGizmoMap *mmap, struct wmGizmo *mpr, bool select);
void WM_gizmo_highlight_set(struct wmGizmoMap *mmap, struct wmGizmo *mpr);
void WM_gizmo_modal_set_from_setup(
struct wmGizmoMap *mmap, struct bContext *C,
struct wmGizmo *mpr, int part_index, const struct wmEvent *event);
struct wmGizmoOpElem *WM_gizmo_operator_get(
struct wmGizmo *mpr, int part_index);
struct PointerRNA *WM_gizmo_operator_set(
struct wmGizmo *mpr, int part_index,
struct wmOperatorType *ot, struct IDProperty *properties);
/* callbacks */
void WM_gizmo_set_fn_custom_modal(struct wmGizmo *mpr, wmGizmoFnModal fn);
void WM_gizmo_set_matrix_location(
struct wmGizmo *mpr, const float origin[3]);
void WM_gizmo_set_matrix_rotation_from_z_axis(
struct wmGizmo *mpr, const float z_axis[3]);
void WM_gizmo_set_matrix_rotation_from_yz_axis(
struct wmGizmo *mpr, const float y_axis[3], const float z_axis[3]);
void WM_gizmo_set_matrix_offset_location(
struct wmGizmo *mpr, const float origin[3]);
void WM_gizmo_set_matrix_offset_rotation_from_z_axis(
struct wmGizmo *mpr, const float z_axis[3]);
void WM_gizmo_set_matrix_offset_rotation_from_yz_axis(
struct wmGizmo *mpr, const float y_axis[3], const float z_axis[3]);
void WM_gizmo_set_flag(struct wmGizmo *mpr, const int flag, const bool enable);
void WM_gizmo_set_scale(struct wmGizmo *mpr, float scale);
void WM_gizmo_set_line_width(struct wmGizmo *mpr, const float line_width);
void WM_gizmo_get_color(const struct wmGizmo *mpr, float color[4]);
void WM_gizmo_set_color(struct wmGizmo *mpr, const float color[4]);
void WM_gizmo_get_color_highlight(const struct wmGizmo *mpr, float color_hi[4]);
void WM_gizmo_set_color_highlight(struct wmGizmo *mpr, const float color[4]);
/**
* Leaving values NULL use values from #wmGizmo.
*/
struct WM_GizmoMatrixParams {
const float(*matrix_space)[4];
const float(*matrix_basis)[4];
const float(*matrix_offset)[4];
const float *scale_final;
};
void WM_gizmo_calc_matrix_final_params(
const struct wmGizmo *mpr, const struct WM_GizmoMatrixParams *params,
float r_mat[4][4]);
void WM_gizmo_calc_matrix_final_no_offset(
const struct wmGizmo *mpr, float r_mat[4][4]);
void WM_gizmo_calc_matrix_final(
const struct wmGizmo *mpr, float r_mat[4][4]);
/* properties */
void WM_gizmo_properties_create_ptr(struct PointerRNA *ptr, struct wmGizmoType *wt);
void WM_gizmo_properties_create(struct PointerRNA *ptr, const char *opstring);
void WM_gizmo_properties_alloc(struct PointerRNA **ptr, struct IDProperty **properties, const char *wtstring);
void WM_gizmo_properties_sanitize(struct PointerRNA *ptr, const bool no_context);
bool WM_gizmo_properties_default(struct PointerRNA *ptr, const bool do_update);
void WM_gizmo_properties_reset(struct wmGizmo *op);
void WM_gizmo_properties_clear(struct PointerRNA *ptr);
void WM_gizmo_properties_free(struct PointerRNA *ptr);
/* wm_gizmo_type.c */
const struct wmGizmoType *WM_gizmotype_find(const char *idname, bool quiet);
void WM_gizmotype_append(void (*wtfunc)(struct wmGizmoType *));
void WM_gizmotype_append_ptr(void (*mnpfunc)(struct wmGizmoType *, void *), void *userdata);
bool WM_gizmotype_remove(struct bContext *C, struct Main *bmain, const char *idname);
void WM_gizmotype_remove_ptr(struct bContext *C, struct Main *bmain, struct wmGizmoType *wt);
void WM_gizmotype_iter(struct GHashIterator *ghi);
/* wm_gizmo_group_type.c */
struct wmGizmoGroupType *WM_gizmogrouptype_find(const char *idname, bool quiet);
struct wmGizmoGroupType *WM_gizmogrouptype_append(void (*wtfunc)(struct wmGizmoGroupType *));
struct wmGizmoGroupType *WM_gizmogrouptype_append_ptr(void (*mnpfunc)(struct wmGizmoGroupType *, void *), void *userdata);
bool WM_gizmogrouptype_free(const char *idname);
void WM_gizmogrouptype_free_ptr(struct wmGizmoGroupType *wt);
void WM_gizmogrouptype_iter(struct GHashIterator *ghi);
struct wmGizmoGroupTypeRef *WM_gizmogrouptype_append_and_link(
struct wmGizmoMapType *mmap_type,
void (*wtfunc)(struct wmGizmoGroupType *));
/* wm_gizmo_map.c */
/* Dynamic Updates (for RNA runtime registration) */
void WM_gizmoconfig_update_tag_init(struct wmGizmoMapType *mmap_type, struct wmGizmoGroupType *wgt);
void WM_gizmoconfig_update_tag_remove(struct wmGizmoMapType *mmap_type, struct wmGizmoGroupType *wgt);
void WM_gizmoconfig_update(struct Main *bmain);
/* wm_maniulator_target_props.c */
struct wmGizmoProperty *WM_gizmo_target_property_array(struct wmGizmo *mpr);
struct wmGizmoProperty *WM_gizmo_target_property_at_index(
struct wmGizmo *mpr, int index);
struct wmGizmoProperty *WM_gizmo_target_property_find(
struct wmGizmo *mpr, const char *idname);
void WM_gizmo_target_property_def_rna_ptr(
struct wmGizmo *mpr, const struct wmGizmoPropertyType *mpr_prop_type,
struct PointerRNA *ptr, struct PropertyRNA *prop, int index);
void WM_gizmo_target_property_def_rna(
struct wmGizmo *mpr, const char *idname,
struct PointerRNA *ptr, const char *propname, int index);
void WM_gizmo_target_property_def_func_ptr(
struct wmGizmo *mpr, const struct wmGizmoPropertyType *mpr_prop_type,
const struct wmGizmoPropertyFnParams *params);
void WM_gizmo_target_property_def_func(
struct wmGizmo *mpr, const char *idname,
const struct wmGizmoPropertyFnParams *params);
void WM_gizmo_target_property_clear_rna_ptr(
struct wmGizmo *mpr, const struct wmGizmoPropertyType *mpr_prop_type);
void WM_gizmo_target_property_clear_rna(
struct wmGizmo *mpr, const char *idname);
bool WM_gizmo_target_property_is_valid_any(struct wmGizmo *mpr);
bool WM_gizmo_target_property_is_valid(
const struct wmGizmoProperty *mpr_prop);
float WM_gizmo_target_property_value_get(
const struct wmGizmo *mpr, struct wmGizmoProperty *mpr_prop);
void WM_gizmo_target_property_value_set(
struct bContext *C, const struct wmGizmo *mpr, struct wmGizmoProperty *mpr_prop,
const float value);
void WM_gizmo_target_property_value_get_array(
const struct wmGizmo *mpr, struct wmGizmoProperty *mpr_prop,
float *value);
void WM_gizmo_target_property_value_set_array(
struct bContext *C, const struct wmGizmo *mpr, struct wmGizmoProperty *mpr_prop,
const float *value);
bool WM_gizmo_target_property_range_get(
const struct wmGizmo *mpr, struct wmGizmoProperty *mpr_prop,
float range[2]);
int WM_gizmo_target_property_array_length(
const struct wmGizmo *mpr, struct wmGizmoProperty *mpr_prop);
/* definitions */
const struct wmGizmoPropertyType *WM_gizmotype_target_property_find(
const struct wmGizmoType *wt, const char *idname);
void WM_gizmotype_target_property_def(
struct wmGizmoType *wt, const char *idname, int data_type, int array_length);
/* utilities */
void WM_gizmo_do_msg_notify_tag_refresh(
struct bContext *C, struct wmMsgSubscribeKey *msg_key, struct wmMsgSubscribeValue *msg_val);
void WM_gizmo_target_property_subscribe_all(
struct wmGizmo *mpr, struct wmMsgBus *mbus, struct ARegion *ar);
/* -------------------------------------------------------------------- */
/* wmGizmoGroup */
/* Callbacks for 'wmGizmoGroupType.setup_keymap' */
struct wmKeyMap *WM_gizmogroup_keymap_common(
const struct wmGizmoGroupType *wgt, struct wmKeyConfig *config);
struct wmKeyMap *WM_gizmogroup_keymap_common_select(
const struct wmGizmoGroupType *wgt, struct wmKeyConfig *config);
/* -------------------------------------------------------------------- */
/* wmGizmoMap */
struct wmGizmoMap *WM_gizmomap_new_from_type(
const struct wmGizmoMapType_Params *mmap_params);
const struct ListBase *WM_gizmomap_group_list(struct wmGizmoMap *mmap);
struct wmGizmoGroup *WM_gizmomap_group_find(
struct wmGizmoMap *mmap,
const char *idname);
struct wmGizmoGroup *WM_gizmomap_group_find_ptr(
struct wmGizmoMap *mmap,
const struct wmGizmoGroupType *wgt);
void WM_gizmomap_tag_refresh(struct wmGizmoMap *mmap);
void WM_gizmomap_draw(
struct wmGizmoMap *mmap, const struct bContext *C, const eWM_GizmoFlagMapDrawStep drawstep);
void WM_gizmomap_add_handlers(struct ARegion *ar, struct wmGizmoMap *mmap);
bool WM_gizmomap_select_all(struct bContext *C, struct wmGizmoMap *mmap, const int action);
bool WM_gizmomap_cursor_set(const struct wmGizmoMap *mmap, struct wmWindow *win);
void WM_gizmomap_message_subscribe(
struct bContext *C, struct wmGizmoMap *mmap, struct ARegion *ar, struct wmMsgBus *mbus);
bool WM_gizmomap_is_any_selected(const struct wmGizmoMap *mmap);
bool WM_gizmomap_minmax(
const struct wmGizmoMap *mmap, bool use_hidden, bool use_select,
float r_min[3], float r_max[3]);
struct ARegion *WM_gizmomap_tooltip_init(
struct bContext *C, struct ARegion *ar, bool *r_exit_on_event);
/* -------------------------------------------------------------------- */
/* wmGizmoMapType */
struct wmGizmoMapType *WM_gizmomaptype_find(
const struct wmGizmoMapType_Params *mmap_params);
struct wmGizmoMapType *WM_gizmomaptype_ensure(
const struct wmGizmoMapType_Params *mmap_params);
struct wmGizmoGroupTypeRef *WM_gizmomaptype_group_find(
struct wmGizmoMapType *mmap_type,
const char *idname);
struct wmGizmoGroupTypeRef *WM_gizmomaptype_group_find_ptr(
struct wmGizmoMapType *mmap_type,
const struct wmGizmoGroupType *wgt);
struct wmGizmoGroupTypeRef *WM_gizmomaptype_group_link(
struct wmGizmoMapType *mmap_type,
const char *idname);
struct wmGizmoGroupTypeRef *WM_gizmomaptype_group_link_ptr(
struct wmGizmoMapType *mmap_type,
struct wmGizmoGroupType *wgt);
void WM_gizmomaptype_group_init_runtime_keymap(
const struct Main *bmain,
struct wmGizmoGroupType *wgt);
void WM_gizmomaptype_group_init_runtime(
const struct Main *bmain, struct wmGizmoMapType *mmap_type,
struct wmGizmoGroupType *wgt);
void WM_gizmomaptype_group_unlink(
struct bContext *C, struct Main *bmain, struct wmGizmoMapType *mmap_type,
const struct wmGizmoGroupType *wgt);
void WM_gizmomaptype_group_free(struct wmGizmoGroupTypeRef *wgt);
/* -------------------------------------------------------------------- */
/* GizmoGroup */
/* Add/Ensure/Remove (High level API) */
void WM_gizmo_group_type_add_ptr_ex(
struct wmGizmoGroupType *wgt,
struct wmGizmoMapType *mmap_type);
void WM_gizmo_group_type_add_ptr(
struct wmGizmoGroupType *wgt);
void WM_gizmo_group_type_add(const char *idname);
void WM_gizmo_group_type_ensure_ptr_ex(
struct wmGizmoGroupType *wgt,
struct wmGizmoMapType *mmap_type);
void WM_gizmo_group_type_ensure_ptr(
struct wmGizmoGroupType *wgt);
void WM_gizmo_group_type_ensure(const char *idname);
void WM_gizmo_group_type_remove_ptr_ex(
struct Main *bmain, struct wmGizmoGroupType *wgt,
struct wmGizmoMapType *mmap_type);
void WM_gizmo_group_type_remove_ptr(
struct Main *bmain, struct wmGizmoGroupType *wgt);
void WM_gizmo_group_type_remove(struct Main *bmain, const char *idname);
void WM_gizmo_group_type_unlink_delayed_ptr_ex(
struct wmGizmoGroupType *wgt,
struct wmGizmoMapType *mmap_type);
void WM_gizmo_group_type_unlink_delayed_ptr(
struct wmGizmoGroupType *wgt);
void WM_gizmo_group_type_unlink_delayed(const char *idname);
/* Utilities */
bool WM_gizmo_context_check_drawstep(const struct bContext *C, eWM_GizmoFlagMapDrawStep step);
bool WM_gizmo_group_type_poll(const struct bContext *C, const struct wmGizmoGroupType *wgt);
#endif /* __WM_GIZMO_API_H__ */
|