Merge branch 'master' into blender2.8
[blender.git] / source / blender / editors / space_outliner / outliner_intern.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version. 
8  *
9  * This program 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
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2008 Blender Foundation.
19  * All rights reserved.
20  *
21  * 
22  * Contributor(s): Blender Foundation
23  *
24  * ***** END GPL LICENSE BLOCK *****
25  */
26
27 /** \file blender/editors/space_outliner/outliner_intern.h
28  *  \ingroup spoutliner
29  */
30
31
32 #ifndef __OUTLINER_INTERN_H__
33 #define __OUTLINER_INTERN_H__
34
35 #include "RNA_types.h"
36
37 /* internal exports only */
38
39 struct ARegion;
40 struct ListBase;
41 struct wmOperatorType;
42 struct TreeElement;
43 struct TreeStoreElem;
44 struct Main;
45 struct bContext;
46 struct Scene;
47 struct ViewLayer;
48 struct ID;
49 struct Object;
50 struct bPoseChannel;
51 struct EditBone;
52 struct wmEvent;
53 struct wmKeyConfig;
54 struct EvaluationContext;
55
56 typedef enum TreeElementInsertType {
57         TE_INSERT_BEFORE,
58         TE_INSERT_AFTER,
59         TE_INSERT_INTO,
60 } TreeElementInsertType;
61
62 typedef enum TreeTraversalAction {
63         /* Continue traversal regularly, don't skip children. */
64         TRAVERSE_CONTINUE = 0,
65         /* Stop traversal */
66         TRAVERSE_BREAK,
67         /* Continue traversal, but skip childs of traversed element */
68         TRAVERSE_SKIP_CHILDS,
69 } TreeTraversalAction;
70
71 /**
72  * Callback type for reinserting elements at a different position, used to allow user customizable element order.
73  */
74 typedef void (*TreeElementReinsertFunc)(struct Main *bmain,
75                                         struct SpaceOops *soops,
76                                         struct TreeElement *insert_element,
77                                         struct TreeElement *insert_handle,
78                                         TreeElementInsertType action,
79                                         const struct wmEvent *event);
80 /**
81  * Executed on (almost) each mouse move while dragging. It's supposed to give info
82  * if reinserting insert_element before/after/into insert_handle would be allowed.
83  * It's allowed to change the reinsert info here for non const pointers.
84  */
85 typedef bool (*TreeElementReinsertPollFunc)(const struct TreeElement *insert_element,
86                                             struct TreeElement **io_insert_handle, TreeElementInsertType *io_action);
87 typedef TreeTraversalAction (*TreeTraversalFunc)(struct TreeElement *te, void *customdata);
88
89
90 typedef struct TreeElement {
91         struct TreeElement *next, *prev, *parent;
92         ListBase subtree;
93         int xs, ys;                // do selection
94         TreeStoreElem *store_elem; // element in tree store
95         short flag;                // flag for non-saved stuff
96         short index;               // index for data arrays
97         short idcode;              // from TreeStore id
98         short xend;                // width of item display, for select
99         const char *name;
100         void *directdata;          // Armature Bones, Base, Sequence, Strip...
101         PointerRNA rnaptr;         // RNA Pointer
102
103         /* callbacks - TODO should be moved into a type (like TreeElementType) */
104         TreeElementReinsertFunc reinsert;
105         TreeElementReinsertPollFunc reinsert_poll;
106
107         struct {
108                 TreeElementInsertType insert_type;
109                 /* the element before/after/into which we may insert the dragged one (NULL to insert at top) */
110                 struct TreeElement *insert_handle;
111                 void *tooltip_draw_handle;
112         } *drag_data;
113 } TreeElement;
114
115 #define TREESTORE_ID_TYPE(_id) \
116         (ELEM(GS((_id)->name), ID_SCE, ID_LI, ID_OB, ID_ME, ID_CU, ID_MB, ID_NT, ID_MA, ID_TE, ID_IM, ID_LT, ID_LA, ID_CA) || \
117          ELEM(GS((_id)->name), ID_KE, ID_WO, ID_SPK, ID_GR, ID_AR, ID_AC, ID_BR, ID_PA, ID_GD, ID_LS, ID_LP) || \
118          ELEM(GS((_id)->name), ID_SCR, ID_WM, ID_TXT, ID_VF, ID_SO, ID_CF, ID_PAL, ID_WS))  /* Only in 'blendfile' mode ... :/ */
119
120 /* TreeElement->flag */
121 enum {
122         TE_ACTIVE      = (1 << 0),
123         /* Closed items display their children as icon within the row. TE_ICONROW is for
124          * these child-items that are visible but only within the row of the closed parent. */
125         TE_ICONROW     = (1 << 1),
126         TE_LAZY_CLOSED = (1 << 2),
127         TE_FREE_NAME   = (1 << 3),
128 };
129
130 /* button events */
131 #define OL_NAMEBUTTON       1
132
133 typedef enum {
134         OL_DRAWSEL_NONE    = 0,  /* inactive (regular black text) */
135         OL_DRAWSEL_NORMAL  = 1,  /* active object (draws white text) */
136         OL_DRAWSEL_ACTIVE  = 2,  /* active obdata (draws a circle around the icon) */
137 } eOLDrawState;
138
139 typedef enum {
140         OL_SETSEL_NONE     = 0,  /* don't change the selection state */
141         OL_SETSEL_NORMAL   = 1,  /* select the item */
142         OL_SETSEL_EXTEND   = 2,  /* select the item and extend (also toggles selection) */
143 } eOLSetState;
144
145 /* get TreeStoreElem associated with a TreeElement 
146  * < a: (TreeElement) tree element to find stored element for
147  */
148 #define TREESTORE(a) ((a)->store_elem)
149
150 /* size constants */
151 #define OL_Y_OFFSET 2
152
153 #define OL_TOG_RESTRICT_VIEWX   (UI_UNIT_X * 3.0f)
154 #define OL_TOG_RESTRICT_SELECTX (UI_UNIT_X * 2.0f)
155 #define OL_TOG_RESTRICT_RENDERX UI_UNIT_X
156
157 #define OL_TOGW OL_TOG_RESTRICT_VIEWX
158
159 #define OL_RNA_COLX         (UI_UNIT_X * 15)
160 #define OL_RNA_COL_SIZEX    (UI_UNIT_X * 7.5f)
161 #define OL_RNA_COL_SPACEX   (UI_UNIT_X * 2.5f)
162
163 /* The outliner display modes that support the filter system.
164  * Note: keep it synced with space_outliner.py */
165 #define SUPPORT_FILTER_OUTLINER(soops_) ELEM((soops_)->outlinevis, SO_VIEW_LAYER, SO_COLLECTIONS)
166
167 /* Outliner Searching --
168  *
169  * Are we looking for something in the outliner?
170  * If so finding matches in child items makes it more useful
171  *
172  * - We want to flag parents to act as being open to filter child matches 
173  * - and also flag matches so we can highlight them
174  * - Flags are stored in TreeStoreElem->flag
175  * - Flag options defined in DNA_outliner_types.h
176  * - SO_SEARCH_RECURSIVE defined in DNA_space_types.h
177  *
178  * - NOT in datablocks view - searching all datablocks takes way too long 
179  *   to be useful
180  * - not searching into RNA items helps but isn't the complete solution
181  */
182
183 #define SEARCHING_OUTLINER(sov)   ((sov->search_flags & SO_SEARCH_RECURSIVE) && (sov->filter & SO_FILTER_SEARCH))
184
185 /* is the currrent element open? if so we also show children */
186 #define TSELEM_OPEN(telm, sv)    ( (telm->flag & TSE_CLOSED) == 0 || (SEARCHING_OUTLINER(sv) && (telm->flag & TSE_CHILDSEARCH)) )
187
188 /* outliner_tree.c ----------------------------------------------- */
189
190 void outliner_free_tree(ListBase *tree);
191 void outliner_cleanup_tree(struct SpaceOops *soops);
192 void outliner_free_tree_element(TreeElement *element, ListBase *parent_subtree);
193 void outliner_remove_treestore_element(struct SpaceOops *soops, TreeStoreElem *tselem);
194
195 void outliner_build_tree(
196         struct Main *mainvar,
197         struct Scene *scene, struct ViewLayer *view_layer,
198         struct SpaceOops *soops, struct ARegion *ar);
199
200 typedef struct ObjectsSelectedData {
201         struct ListBase objects_selected_array;
202 } ObjectsSelectedData;
203
204 TreeTraversalAction outliner_find_selected_objects(struct TreeElement *te, void *customdata);
205
206 /* outliner_draw.c ---------------------------------------------- */
207
208 void draw_outliner(const struct bContext *C);
209 void restrictbutton_gr_restrict_flag(void *poin, void *poin2, int flag);
210
211 /* outliner_select.c -------------------------------------------- */
212 eOLDrawState tree_element_type_active(
213         struct bContext *C, struct Scene *scene, struct ViewLayer *view_layer, struct SpaceOops *soops,
214         TreeElement *te, TreeStoreElem *tselem, const eOLSetState set, bool recursive);
215 eOLDrawState tree_element_active(struct bContext *C, struct Scene *scene, struct ViewLayer *view_layer, SpaceOops *soops,
216                                  TreeElement *te, const eOLSetState set, const bool handle_all_types);
217
218 void outliner_item_do_activate_from_tree_element(
219         struct bContext *C, TreeElement *te, TreeStoreElem *tselem,
220         bool extend, bool recursive);
221 int outliner_item_do_activate_from_cursor(
222         struct bContext *C, const int mval[2],
223         bool extend, bool recursive);
224
225 void outliner_item_select(
226         struct SpaceOops *soops, const struct TreeElement *te,
227         const bool extend, const bool toggle);
228
229 /* outliner_edit.c ---------------------------------------------- */
230 typedef void (*outliner_operation_cb)(
231         struct bContext *C, struct ReportList *, struct Scene *scene,
232         struct TreeElement *, struct TreeStoreElem *, TreeStoreElem *, void *);
233
234 void outliner_do_object_operation_ex(
235         struct bContext *C, struct ReportList *reports, struct Scene *scene, struct SpaceOops *soops,
236         struct ListBase *lb, outliner_operation_cb operation_cb, bool recurse_selected);
237 void outliner_do_object_operation(
238         struct bContext *C, struct ReportList *reports, struct Scene *scene, struct SpaceOops *soops,
239         struct ListBase *lb, outliner_operation_cb operation_cb);
240
241 int common_restrict_check(struct bContext *C, struct Object *ob);
242
243 int outliner_has_one_flag(ListBase *lb, short flag, const int curlevel);
244 bool outliner_set_flag(ListBase *lb, short flag, short set);
245
246 void object_toggle_visibility_cb(
247         struct bContext *C, struct ReportList *reports, struct Scene *scene,
248         TreeElement *te, struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
249 void object_toggle_selectability_cb(
250         struct bContext *C, struct ReportList *reports, struct Scene *scene,
251         TreeElement *te, struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
252 void object_toggle_renderability_cb(
253         struct bContext *C, struct ReportList *reports, struct Scene *scene,
254         TreeElement *te, struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
255
256
257 void group_toggle_visibility_cb(
258         struct bContext *C, struct ReportList *reports, struct Scene *scene,
259         TreeElement *te, struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
260 void group_toggle_selectability_cb(
261         struct bContext *C, struct ReportList *reports, struct Scene *scene,
262         TreeElement *te, struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
263 void group_toggle_renderability_cb(
264         struct bContext *C, struct ReportList *reports, struct Scene *scene,
265         TreeElement *te, struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
266
267 void item_rename_cb(
268         struct bContext *C, struct ReportList *reports, struct Scene *scene,
269         TreeElement *te, struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
270 void lib_relocate_cb(
271         struct bContext *C, struct ReportList *reports, struct Scene *scene, struct TreeElement *te,
272         struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
273 void lib_reload_cb(
274         struct bContext *C, struct ReportList *reports, struct Scene *scene, struct TreeElement *te,
275         struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
276
277 void id_delete_cb(
278         struct bContext *C, struct ReportList *reports, struct Scene *scene, struct TreeElement *te,
279         struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
280 void id_remap_cb(
281         struct bContext *C, struct ReportList *reports, struct Scene *scene, struct TreeElement *te,
282         struct TreeStoreElem *tsep, struct TreeStoreElem *tselem, void *user_data);
283
284 TreeElement *outliner_dropzone_find(const struct SpaceOops *soops, const float fmval[2], const bool children);
285
286 void outliner_set_coordinates(struct ARegion *ar, struct SpaceOops *soops);
287
288 /* ...................................................... */
289
290 void OUTLINER_OT_highlight_update(struct wmOperatorType *ot);
291
292 void OUTLINER_OT_item_activate(struct wmOperatorType *ot);
293 void OUTLINER_OT_item_openclose(struct wmOperatorType *ot);
294 void OUTLINER_OT_item_rename(struct wmOperatorType *ot);
295 void OUTLINER_OT_lib_relocate(struct wmOperatorType *ot);
296 void OUTLINER_OT_lib_reload(struct wmOperatorType *ot);
297
298 void OUTLINER_OT_id_delete(struct wmOperatorType *ot);
299
300 void OUTLINER_OT_show_one_level(struct wmOperatorType *ot);
301 void OUTLINER_OT_show_active(struct wmOperatorType *ot);
302 void OUTLINER_OT_show_hierarchy(struct wmOperatorType *ot);
303
304 void OUTLINER_OT_select_border(struct wmOperatorType *ot);
305
306 void OUTLINER_OT_selected_toggle(struct wmOperatorType *ot);
307 void OUTLINER_OT_expanded_toggle(struct wmOperatorType *ot);
308
309 void OUTLINER_OT_scroll_page(struct wmOperatorType *ot);
310
311 void OUTLINER_OT_keyingset_add_selected(struct wmOperatorType *ot);
312 void OUTLINER_OT_keyingset_remove_selected(struct wmOperatorType *ot);
313
314 void OUTLINER_OT_drivers_add_selected(struct wmOperatorType *ot);
315 void OUTLINER_OT_drivers_delete_selected(struct wmOperatorType *ot);
316
317 void OUTLINER_OT_orphans_purge(struct wmOperatorType *ot);
318
319 void OUTLINER_OT_parent_drop(struct wmOperatorType *ot);
320 void OUTLINER_OT_parent_clear(struct wmOperatorType *ot);
321 void OUTLINER_OT_scene_drop(struct wmOperatorType *ot);
322 void OUTLINER_OT_material_drop(struct wmOperatorType *ot);
323 void OUTLINER_OT_group_link(struct wmOperatorType *ot);
324
325 /* outliner_tools.c ---------------------------------------------- */
326
327 void OUTLINER_OT_operation(struct wmOperatorType *ot);
328 void OUTLINER_OT_scene_operation(struct wmOperatorType *ot);
329 void OUTLINER_OT_object_operation(struct wmOperatorType *ot);
330 void OUTLINER_OT_group_operation(struct wmOperatorType *ot);
331 void OUTLINER_OT_lib_operation(struct wmOperatorType *ot);
332 void OUTLINER_OT_id_operation(struct wmOperatorType *ot);
333 void OUTLINER_OT_id_remap(struct wmOperatorType *ot);
334 void OUTLINER_OT_data_operation(struct wmOperatorType *ot);
335 void OUTLINER_OT_animdata_operation(struct wmOperatorType *ot);
336 void OUTLINER_OT_action_set(struct wmOperatorType *ot);
337 void OUTLINER_OT_constraint_operation(struct wmOperatorType *ot);
338 void OUTLINER_OT_modifier_operation(struct wmOperatorType *ot);
339 void OUTLINER_OT_collection_operation(struct wmOperatorType *ot);
340 /* ---------------------------------------------------------------- */
341
342 /* outliner_ops.c */
343 void outliner_operatortypes(void);
344 void outliner_keymap(struct wmKeyConfig *keyconf);
345
346 /* outliner_collections.c */
347
348 struct SceneCollection *outliner_scene_collection_from_tree_element(TreeElement *te);
349
350 void OUTLINER_OT_collections_delete(struct wmOperatorType *ot);
351 void OUTLINER_OT_collection_select(struct wmOperatorType *ot);
352 void OUTLINER_OT_collection_toggle(struct wmOperatorType *ot);
353 void OUTLINER_OT_collection_link(struct wmOperatorType *ot);
354 void OUTLINER_OT_collection_unlink(struct wmOperatorType *ot);
355 void OUTLINER_OT_collection_new(struct wmOperatorType *ot);
356 void OUTLINER_OT_collection_duplicate(struct wmOperatorType *ot);
357 void OUTLINER_OT_collection_objects_remove(struct wmOperatorType *ot);
358 void OUTLINER_OT_collection_objects_select(struct wmOperatorType *ot);
359 void OUTLINER_OT_object_add_to_new_collection(struct wmOperatorType *ot);
360 void OUTLINER_OT_object_remove_from_collection(struct wmOperatorType *ot);
361
362 void OUTLINER_OT_collection_objects_add(struct wmOperatorType *ot);
363 void OUTLINER_OT_collection_nested_new(struct wmOperatorType *ot);
364 void OUTLINER_OT_collection_delete_selected(struct wmOperatorType *ot);
365
366 /* outliner_utils.c ---------------------------------------------- */
367
368 TreeElement *outliner_find_item_at_y(const SpaceOops *soops, const ListBase *tree, float view_co_y);
369 TreeElement *outliner_find_item_at_x_in_row(const SpaceOops *soops, const TreeElement *parent_te, float view_co_x);
370 TreeElement *outliner_find_tse(struct SpaceOops *soops, const TreeStoreElem *tse);
371 TreeElement *outliner_find_tree_element(ListBase *lb, const TreeStoreElem *store_elem);
372 TreeElement *outliner_find_id(struct SpaceOops *soops, ListBase *lb, const struct ID *id);
373 TreeElement *outliner_find_posechannel(ListBase *lb, const struct bPoseChannel *pchan);
374 TreeElement *outliner_find_editbone(ListBase *lb, const struct EditBone *ebone);
375 struct ID *outliner_search_back(SpaceOops *soops, TreeElement *te, short idcode);
376 bool outliner_tree_traverse(const SpaceOops *soops, ListBase *tree, int filter_te_flag, int filter_tselem_flag,
377                             TreeTraversalFunc func, void *customdata);
378
379
380 #endif /* __OUTLINER_INTERN_H__ */