Merge branch 'master' into blender2.8
[blender.git] / source / blender / blenkernel / intern / context.c
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  * Contributor(s): Blender Foundation (2008).
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 /** \file blender/blenkernel/intern/context.c
24  *  \ingroup bke
25  */
26
27 #include <string.h>
28 #include <stdlib.h>
29 #include <stddef.h>
30
31 #include "MEM_guardedalloc.h"
32
33 #include "DNA_scene_types.h"
34 #include "DNA_screen_types.h"
35 #include "DNA_space_types.h"
36 #include "DNA_view3d_types.h"
37 #include "DNA_windowmanager_types.h"
38 #include "DNA_object_types.h"
39 #include "DNA_linestyle_types.h"
40 #include "DNA_gpencil_types.h"
41 #include "DNA_workspace_types.h"
42
43 #include "DEG_depsgraph.h"
44
45 #include "BLI_listbase.h"
46 #include "BLI_string.h"
47 #include "BLI_threads.h"
48 #include "BLI_utildefines.h"
49
50 #include "BLT_translation.h"
51
52 #include "BKE_context.h"
53 #include "BKE_layer.h"
54 #include "BKE_main.h"
55 #include "BKE_scene.h"
56 #include "BKE_screen.h"
57 #include "BKE_sound.h"
58 #include "BKE_workspace.h"
59
60 #include "RE_engine.h"
61
62 #include "RNA_access.h"
63
64 #ifdef WITH_PYTHON
65 #  include "BPY_extern.h"
66 #endif
67
68 /* struct */
69
70 struct bContext {
71         int thread;
72
73         /* windowmanager context */
74         struct {
75                 struct wmWindowManager *manager;
76                 struct wmWindow *window;
77                 struct WorkSpace *workspace;
78                 struct bScreen *screen;
79                 struct ScrArea *area;
80                 struct ARegion *region;
81                 struct ARegion *menu;
82                 struct wmManipulatorGroup *manipulator_group;
83                 struct bContextStore *store;
84                 const char *operator_poll_msg; /* reason for poll failing */
85         } wm;
86         
87         /* data context */
88         struct {
89                 struct Main *main;
90                 struct Scene *scene;
91
92                 int recursion;
93                 int py_init; /* true if python is initialized */
94                 void *py_context;
95         } data;
96         
97         /* data evaluation */
98 #if 0
99         struct {
100                 int render;
101         } eval;
102 #endif
103 };
104
105 /* context */
106
107 bContext *CTX_create(void)
108 {
109         bContext *C;
110         
111         C = MEM_callocN(sizeof(bContext), "bContext");
112
113         return C;
114 }
115
116 bContext *CTX_copy(const bContext *C)
117 {
118         bContext *newC = MEM_dupallocN((void *)C);
119
120         return newC;
121 }
122
123 void CTX_free(bContext *C)
124 {
125         MEM_freeN(C);
126 }
127
128 /* store */
129
130 bContextStore *CTX_store_add(ListBase *contexts, const char *name, PointerRNA *ptr)
131 {
132         bContextStoreEntry *entry;
133         bContextStore *ctx, *lastctx;
134
135         /* ensure we have a context to put the entry in, if it was already used
136          * we have to copy the context to ensure */
137         ctx = contexts->last;
138
139         if (!ctx || ctx->used) {
140                 if (ctx) {
141                         lastctx = ctx;
142                         ctx = MEM_dupallocN(lastctx);
143                         BLI_duplicatelist(&ctx->entries, &lastctx->entries);
144                 }
145                 else
146                         ctx = MEM_callocN(sizeof(bContextStore), "bContextStore");
147
148                 BLI_addtail(contexts, ctx);
149         }
150
151         entry = MEM_callocN(sizeof(bContextStoreEntry), "bContextStoreEntry");
152         BLI_strncpy(entry->name, name, sizeof(entry->name));
153         entry->ptr = *ptr;
154
155         BLI_addtail(&ctx->entries, entry);
156
157         return ctx;
158 }
159
160 bContextStore *CTX_store_add_all(ListBase *contexts, bContextStore *context)
161 {
162         bContextStoreEntry *entry, *tentry;
163         bContextStore *ctx, *lastctx;
164
165         /* ensure we have a context to put the entries in, if it was already used
166          * we have to copy the context to ensure */
167         ctx = contexts->last;
168
169         if (!ctx || ctx->used) {
170                 if (ctx) {
171                         lastctx = ctx;
172                         ctx = MEM_dupallocN(lastctx);
173                         BLI_duplicatelist(&ctx->entries, &lastctx->entries);
174                 }
175                 else
176                         ctx = MEM_callocN(sizeof(bContextStore), "bContextStore");
177
178                 BLI_addtail(contexts, ctx);
179         }
180
181         for (tentry = context->entries.first; tentry; tentry = tentry->next) {
182                 entry = MEM_dupallocN(tentry);
183                 BLI_addtail(&ctx->entries, entry);
184         }
185
186         return ctx;
187 }
188
189 void CTX_store_set(bContext *C, bContextStore *store)
190 {
191         C->wm.store = store;
192 }
193
194 bContextStore *CTX_store_copy(bContextStore *store)
195 {
196         bContextStore *ctx;
197
198         ctx = MEM_dupallocN(store);
199         BLI_duplicatelist(&ctx->entries, &store->entries);
200
201         return ctx;
202 }
203
204 void CTX_store_free(bContextStore *store)
205 {
206         BLI_freelistN(&store->entries);
207         MEM_freeN(store);
208 }
209
210 void CTX_store_free_list(ListBase *contexts)
211 {
212         bContextStore *ctx;
213
214         while ((ctx = BLI_pophead(contexts))) {
215                 CTX_store_free(ctx);
216         }
217 }
218
219 /* is python initialied? */
220
221 int CTX_py_init_get(bContext *C)
222 {
223         return C->data.py_init;
224 }
225 void CTX_py_init_set(bContext *C, int value)
226 {
227         C->data.py_init = value;
228 }
229
230 void *CTX_py_dict_get(const bContext *C)
231 {
232         return C->data.py_context;
233 }
234 void CTX_py_dict_set(bContext *C, void *value)
235 {
236         C->data.py_context = value;
237 }
238
239 /* data context utility functions */
240
241 struct bContextDataResult {
242         PointerRNA ptr;
243         ListBase list;
244         const char **dir;
245         short type; /* 0: normal, 1: seq */
246 };
247
248 static void *ctx_wm_python_context_get(
249         const bContext *C,
250         const char *member, const StructRNA *member_type,
251         void *fall_through)
252 {
253 #ifdef WITH_PYTHON
254         if (UNLIKELY(C && CTX_py_dict_get(C))) {
255                 bContextDataResult result;
256                 memset(&result, 0, sizeof(bContextDataResult));
257                 BPY_context_member_get((bContext *)C, member, &result);
258
259                 if (result.ptr.data) {
260                         if (RNA_struct_is_a(result.ptr.type, member_type)) {
261                                 return result.ptr.data;
262                         }
263                         else {
264                                 printf("PyContext '%s' is a '%s', expected a '%s'\n",
265                                        member,
266                                        RNA_struct_identifier(result.ptr.type),
267                                        RNA_struct_identifier(member_type));
268                         }
269                 }
270         }
271 #else
272         UNUSED_VARS(C, member, member_type);
273 #endif
274
275         /* don't allow UI context access from non-main threads */
276         if (!BLI_thread_is_main())
277                 return NULL;
278
279         return fall_through;
280 }
281
282 static int ctx_data_get(bContext *C, const char *member, bContextDataResult *result)
283 {
284         bScreen *sc;
285         ScrArea *sa;
286         ARegion *ar;
287         int done = 0, recursion = C->data.recursion;
288         int ret = 0;
289
290         memset(result, 0, sizeof(bContextDataResult));
291 #ifdef WITH_PYTHON
292         if (CTX_py_dict_get(C)) {
293                 if (BPY_context_member_get(C, member, result)) {
294                         return 1;
295                 }
296         }
297 #endif
298
299         /* don't allow UI context access from non-main threads */
300         if (!BLI_thread_is_main())
301                 return done;
302
303         /* we check recursion to ensure that we do not get infinite
304          * loops requesting data from ourselves in a context callback */
305
306         /* Ok, this looks evil...
307          * if (ret) done = -(-ret | -done);
308          *
309          * Values in order of importance
310          * (0, -1, 1) - Where 1 is highest priority
311          * */
312         if (done != 1 && recursion < 1 && C->wm.store) {
313                 bContextStoreEntry *entry;
314
315                 C->data.recursion = 1;
316
317                 entry = BLI_rfindstring(&C->wm.store->entries, member, offsetof(bContextStoreEntry, name));
318                 if (entry) {
319                         result->ptr = entry->ptr;
320                         done = 1;
321                 }
322         }
323         if (done != 1 && recursion < 2 && (ar = CTX_wm_region(C))) {
324                 C->data.recursion = 2;
325                 if (ar->type && ar->type->context) {
326                         ret = ar->type->context(C, member, result);
327                         if (ret) done = -(-ret | -done);
328
329                 }
330         }
331         if (done != 1 && recursion < 3 && (sa = CTX_wm_area(C))) {
332                 C->data.recursion = 3;
333                 if (sa->type && sa->type->context) {
334                         ret = sa->type->context(C, member, result);
335                         if (ret) done = -(-ret | -done);
336                 }
337         }
338         if (done != 1 && recursion < 4 && (sc = CTX_wm_screen(C))) {
339                 bContextDataCallback cb = sc->context;
340                 C->data.recursion = 4;
341                 if (cb) {
342                         ret = cb(C, member, result);
343                         if (ret) done = -(-ret | -done);
344                 }
345         }
346
347         C->data.recursion = recursion;
348
349         return done;
350 }
351
352 static void *ctx_data_pointer_get(const bContext *C, const char *member)
353 {
354         bContextDataResult result;
355
356         if (C && ctx_data_get((bContext *)C, member, &result) == 1) {
357                 BLI_assert(result.type == CTX_DATA_TYPE_POINTER);
358                 return result.ptr.data;
359         }
360         else {
361                 return NULL;
362         }
363 }
364
365 static int ctx_data_pointer_verify(const bContext *C, const char *member, void **pointer)
366 {
367         bContextDataResult result;
368
369         /* if context is NULL, pointer must be NULL too and that is a valid return */
370         if (C == NULL) {
371                 *pointer = NULL;
372                 return 1;
373         }
374         else if (ctx_data_get((bContext *)C, member, &result) == 1) {
375                 BLI_assert(result.type == CTX_DATA_TYPE_POINTER);
376                 *pointer = result.ptr.data;
377                 return 1;
378         }
379         else {
380                 *pointer = NULL;
381                 return 0;
382         }
383 }
384
385 static int ctx_data_collection_get(const bContext *C, const char *member, ListBase *list)
386 {
387         bContextDataResult result;
388
389         if (ctx_data_get((bContext *)C, member, &result) == 1) {
390                 BLI_assert(result.type == CTX_DATA_TYPE_COLLECTION);
391                 *list = result.list;
392                 return 1;
393         }
394
395         BLI_listbase_clear(list);
396
397         return 0;
398 }
399
400 PointerRNA CTX_data_pointer_get(const bContext *C, const char *member)
401 {
402         bContextDataResult result;
403
404         if (ctx_data_get((bContext *)C, member, &result) == 1) {
405                 BLI_assert(result.type == CTX_DATA_TYPE_POINTER);
406                 return result.ptr;
407         }
408         else {
409                 return PointerRNA_NULL;
410         }
411 }
412
413 PointerRNA CTX_data_pointer_get_type(const bContext *C, const char *member, StructRNA *type)
414 {
415         PointerRNA ptr = CTX_data_pointer_get(C, member);
416
417         if (ptr.data) {
418                 if (RNA_struct_is_a(ptr.type, type)) {
419                         return ptr;
420                 }
421                 else {
422                         printf("%s: warning, member '%s' is '%s', not '%s'\n",
423                                __func__, member, RNA_struct_identifier(ptr.type), RNA_struct_identifier(type));
424                 }
425         }
426         
427         return PointerRNA_NULL;
428 }
429
430 ListBase CTX_data_collection_get(const bContext *C, const char *member)
431 {
432         bContextDataResult result;
433
434         if (ctx_data_get((bContext *)C, member, &result) == 1) {
435                 BLI_assert(result.type == CTX_DATA_TYPE_COLLECTION);
436                 return result.list;
437         }
438         else {
439                 ListBase list = {NULL, NULL};
440                 return list;
441         }
442 }
443
444 /* 1:found,  -1:found but not set,  0:not found */
445 int CTX_data_get(const bContext *C, const char *member, PointerRNA *r_ptr, ListBase *r_lb, short *r_type)
446 {
447         bContextDataResult result;
448         int ret = ctx_data_get((bContext *)C, member, &result);
449
450         if (ret == 1) {
451                 *r_ptr = result.ptr;
452                 *r_lb = result.list;
453                 *r_type = result.type;
454         }
455         else {
456                 memset(r_ptr, 0, sizeof(*r_ptr));
457                 memset(r_lb, 0, sizeof(*r_lb));
458                 *r_type = 0;
459         }
460
461         return ret;
462 }
463
464 static void data_dir_add(ListBase *lb, const char *member, const bool use_all)
465 {
466         LinkData *link;
467         
468         if ((use_all == false) && STREQ(member, "scene")) /* exception */
469                 return;
470
471         if (BLI_findstring(lb, member, offsetof(LinkData, data)))
472                 return;
473         
474         link = MEM_callocN(sizeof(LinkData), "LinkData");
475         link->data = (void *)member;
476         BLI_addtail(lb, link);
477 }
478
479 /**
480  * \param C Context
481  * \param use_store Use 'C->wm.store'
482  * \param use_rna Use Include the properties from 'RNA_Context'
483  * \param use_all Don't skip values (currently only "scene")
484  */
485 ListBase CTX_data_dir_get_ex(const bContext *C, const bool use_store, const bool use_rna, const bool use_all)
486 {
487         bContextDataResult result;
488         ListBase lb;
489         bScreen *sc;
490         ScrArea *sa;
491         ARegion *ar;
492         int a;
493
494         memset(&lb, 0, sizeof(lb));
495
496         if (use_rna) {
497                 char name[256], *nameptr;
498                 int namelen;
499
500                 PropertyRNA *iterprop;
501                 PointerRNA ctx_ptr;
502                 RNA_pointer_create(NULL, &RNA_Context, (void *)C, &ctx_ptr);
503
504                 iterprop = RNA_struct_iterator_property(ctx_ptr.type);
505
506                 RNA_PROP_BEGIN (&ctx_ptr, itemptr, iterprop)
507                 {
508                         nameptr = RNA_struct_name_get_alloc(&itemptr, name, sizeof(name), &namelen);
509                         data_dir_add(&lb, name, use_all);
510                         if (nameptr) {
511                                 if (name != nameptr) {
512                                         MEM_freeN(nameptr);
513                                 }
514                         }
515                 }
516                 RNA_PROP_END;
517         }
518         if (use_store && C->wm.store) {
519                 bContextStoreEntry *entry;
520
521                 for (entry = C->wm.store->entries.first; entry; entry = entry->next)
522                         data_dir_add(&lb, entry->name, use_all);
523         }
524         if ((ar = CTX_wm_region(C)) && ar->type && ar->type->context) {
525                 memset(&result, 0, sizeof(result));
526                 ar->type->context(C, "", &result);
527
528                 if (result.dir)
529                         for (a = 0; result.dir[a]; a++)
530                                 data_dir_add(&lb, result.dir[a], use_all);
531         }
532         if ((sa = CTX_wm_area(C)) && sa->type && sa->type->context) {
533                 memset(&result, 0, sizeof(result));
534                 sa->type->context(C, "", &result);
535
536                 if (result.dir)
537                         for (a = 0; result.dir[a]; a++)
538                                 data_dir_add(&lb, result.dir[a], use_all);
539         }
540         if ((sc = CTX_wm_screen(C)) && sc->context) {
541                 bContextDataCallback cb = sc->context;
542                 memset(&result, 0, sizeof(result));
543                 cb(C, "", &result);
544
545                 if (result.dir)
546                         for (a = 0; result.dir[a]; a++)
547                                 data_dir_add(&lb, result.dir[a], use_all);
548         }
549
550         return lb;
551 }
552
553 ListBase CTX_data_dir_get(const bContext *C)
554 {
555         return CTX_data_dir_get_ex(C, true, false, false);
556 }
557
558 bool CTX_data_equals(const char *member, const char *str)
559 {
560         return (STREQ(member, str));
561 }
562
563 bool CTX_data_dir(const char *member)
564 {
565         return member[0] == '\0';
566 }
567
568 void CTX_data_id_pointer_set(bContextDataResult *result, ID *id)
569 {
570         RNA_id_pointer_create(id, &result->ptr);
571 }
572
573 void CTX_data_pointer_set(bContextDataResult *result, ID *id, StructRNA *type, void *data)
574 {
575         RNA_pointer_create(id, type, data, &result->ptr);
576 }
577
578 void CTX_data_id_list_add(bContextDataResult *result, ID *id)
579 {
580         CollectionPointerLink *link;
581
582         link = MEM_callocN(sizeof(CollectionPointerLink), "CTX_data_id_list_add");
583         RNA_id_pointer_create(id, &link->ptr);
584
585         BLI_addtail(&result->list, link);
586 }
587
588 void CTX_data_list_add(bContextDataResult *result, ID *id, StructRNA *type, void *data)
589 {
590         CollectionPointerLink *link;
591
592         link = MEM_callocN(sizeof(CollectionPointerLink), "CTX_data_list_add");
593         RNA_pointer_create(id, type, data, &link->ptr);
594
595         BLI_addtail(&result->list, link);
596 }
597
598 int ctx_data_list_count(const bContext *C, int (*func)(const bContext *, ListBase *))
599 {
600         ListBase list;
601
602         if (func(C, &list)) {
603                 int tot = BLI_listbase_count(&list);
604                 BLI_freelistN(&list);
605                 return tot;
606         }
607         else
608                 return 0;
609 }
610
611 void CTX_data_dir_set(bContextDataResult *result, const char **dir)
612 {
613         result->dir = dir;
614 }
615
616 void CTX_data_type_set(bContextDataResult *result, short type)
617 {
618         result->type = type;
619 }
620
621 short CTX_data_type_get(bContextDataResult *result)
622 {
623         return result->type;
624 }
625
626
627
628 /* window manager context */
629
630 wmWindowManager *CTX_wm_manager(const bContext *C)
631 {
632         return C->wm.manager;
633 }
634
635 wmWindow *CTX_wm_window(const bContext *C)
636 {
637         return ctx_wm_python_context_get(C, "window", &RNA_Window, C->wm.window);
638 }
639
640 WorkSpace *CTX_wm_workspace(const bContext *C)
641 {
642         return ctx_wm_python_context_get(C, "workspace", &RNA_WorkSpace, C->wm.workspace);
643 }
644
645 bScreen *CTX_wm_screen(const bContext *C)
646 {
647         return ctx_wm_python_context_get(C, "screen", &RNA_Screen, C->wm.screen);
648 }
649
650 ScrArea *CTX_wm_area(const bContext *C)
651 {
652         return ctx_wm_python_context_get(C, "area", &RNA_Area, C->wm.area);
653 }
654
655 SpaceLink *CTX_wm_space_data(const bContext *C)
656 {
657         ScrArea *sa = CTX_wm_area(C);
658         return (sa) ? sa->spacedata.first : NULL;
659 }
660
661 ARegion *CTX_wm_region(const bContext *C)
662 {
663         return ctx_wm_python_context_get(C, "region", &RNA_Region, C->wm.region);
664 }
665
666 void *CTX_wm_region_data(const bContext *C)
667 {
668         ARegion *ar = CTX_wm_region(C);
669         return (ar) ? ar->regiondata : NULL;
670 }
671
672 struct ARegion *CTX_wm_menu(const bContext *C)
673 {
674         return C->wm.menu;
675 }
676
677 struct wmManipulatorGroup *CTX_wm_manipulator_group(const bContext *C)
678 {
679         return C->wm.manipulator_group;
680 }
681
682 struct ReportList *CTX_wm_reports(const bContext *C)
683 {
684         if (C->wm.manager)
685                 return &(C->wm.manager->reports);
686
687         return NULL;
688 }
689
690 View3D *CTX_wm_view3d(const bContext *C)
691 {
692         ScrArea *sa = CTX_wm_area(C);
693         if (sa && sa->spacetype == SPACE_VIEW3D)
694                 return sa->spacedata.first;
695         return NULL;
696 }
697
698 RegionView3D *CTX_wm_region_view3d(const bContext *C)
699 {
700         ScrArea *sa = CTX_wm_area(C);
701         ARegion *ar = CTX_wm_region(C);
702
703         if (sa && sa->spacetype == SPACE_VIEW3D)
704                 if (ar)
705                         return ar->regiondata;
706         return NULL;
707 }
708
709 struct SpaceText *CTX_wm_space_text(const bContext *C)
710 {
711         ScrArea *sa = CTX_wm_area(C);
712         if (sa && sa->spacetype == SPACE_TEXT)
713                 return sa->spacedata.first;
714         return NULL;
715 }
716
717 struct SpaceConsole *CTX_wm_space_console(const bContext *C)
718 {
719         ScrArea *sa = CTX_wm_area(C);
720         if (sa && sa->spacetype == SPACE_CONSOLE)
721                 return sa->spacedata.first;
722         return NULL;
723 }
724
725 struct SpaceImage *CTX_wm_space_image(const bContext *C)
726 {
727         ScrArea *sa = CTX_wm_area(C);
728         if (sa && sa->spacetype == SPACE_IMAGE)
729                 return sa->spacedata.first;
730         return NULL;
731 }
732
733 struct SpaceButs *CTX_wm_space_buts(const bContext *C)
734 {
735         ScrArea *sa = CTX_wm_area(C);
736         if (sa && sa->spacetype == SPACE_BUTS)
737                 return sa->spacedata.first;
738         return NULL;
739 }
740
741 struct SpaceFile *CTX_wm_space_file(const bContext *C)
742 {
743         ScrArea *sa = CTX_wm_area(C);
744         if (sa && sa->spacetype == SPACE_FILE)
745                 return sa->spacedata.first;
746         return NULL;
747 }
748
749 struct SpaceSeq *CTX_wm_space_seq(const bContext *C)
750 {
751         ScrArea *sa = CTX_wm_area(C);
752         if (sa && sa->spacetype == SPACE_SEQ)
753                 return sa->spacedata.first;
754         return NULL;
755 }
756
757 struct SpaceOops *CTX_wm_space_outliner(const bContext *C)
758 {
759         ScrArea *sa = CTX_wm_area(C);
760         if (sa && sa->spacetype == SPACE_OUTLINER)
761                 return sa->spacedata.first;
762         return NULL;
763 }
764
765 struct SpaceNla *CTX_wm_space_nla(const bContext *C)
766 {
767         ScrArea *sa = CTX_wm_area(C);
768         if (sa && sa->spacetype == SPACE_NLA)
769                 return sa->spacedata.first;
770         return NULL;
771 }
772
773 struct SpaceTime *CTX_wm_space_time(const bContext *C)
774 {
775         ScrArea *sa = CTX_wm_area(C);
776         if (sa && sa->spacetype == SPACE_TIME)
777                 return sa->spacedata.first;
778         return NULL;
779 }
780
781 struct SpaceNode *CTX_wm_space_node(const bContext *C)
782 {
783         ScrArea *sa = CTX_wm_area(C);
784         if (sa && sa->spacetype == SPACE_NODE)
785                 return sa->spacedata.first;
786         return NULL;
787 }
788
789 struct SpaceLogic *CTX_wm_space_logic(const bContext *C)
790 {
791         ScrArea *sa = CTX_wm_area(C);
792         if (sa && sa->spacetype == SPACE_LOGIC)
793                 return sa->spacedata.first;
794         return NULL;
795 }
796
797 struct SpaceIpo *CTX_wm_space_graph(const bContext *C)
798 {
799         ScrArea *sa = CTX_wm_area(C);
800         if (sa && sa->spacetype == SPACE_IPO)
801                 return sa->spacedata.first;
802         return NULL;
803 }
804
805 struct SpaceAction *CTX_wm_space_action(const bContext *C)
806 {
807         ScrArea *sa = CTX_wm_area(C);
808         if (sa && sa->spacetype == SPACE_ACTION)
809                 return sa->spacedata.first;
810         return NULL;
811 }
812
813 struct SpaceInfo *CTX_wm_space_info(const bContext *C)
814 {
815         ScrArea *sa = CTX_wm_area(C);
816         if (sa && sa->spacetype == SPACE_INFO)
817                 return sa->spacedata.first;
818         return NULL;
819 }
820
821 struct SpaceUserPref *CTX_wm_space_userpref(const bContext *C)
822 {
823         ScrArea *sa = CTX_wm_area(C);
824         if (sa && sa->spacetype == SPACE_USERPREF)
825                 return sa->spacedata.first;
826         return NULL;
827 }
828
829 struct SpaceClip *CTX_wm_space_clip(const bContext *C)
830 {
831         ScrArea *sa = CTX_wm_area(C);
832         if (sa && sa->spacetype == SPACE_CLIP)
833                 return sa->spacedata.first;
834         return NULL;
835 }
836
837 void CTX_wm_manager_set(bContext *C, wmWindowManager *wm)
838 {
839         C->wm.manager = wm;
840         C->wm.window = NULL;
841         C->wm.screen = NULL;
842         C->wm.area = NULL;
843         C->wm.region = NULL;
844 }
845
846 void CTX_wm_window_set(bContext *C, wmWindow *win)
847 {
848         C->wm.window = win;
849         if (win) {
850                 C->data.scene = win->scene;
851         }
852         C->wm.workspace = (win) ? BKE_workspace_active_get(win->workspace_hook) : NULL;
853         C->wm.screen = (win) ? BKE_workspace_active_screen_get(win->workspace_hook) : NULL;
854         C->wm.area = NULL;
855         C->wm.region = NULL;
856 }
857
858 void CTX_wm_screen_set(bContext *C, bScreen *screen)
859 {
860         C->wm.screen = screen;
861         C->wm.area = NULL;
862         C->wm.region = NULL;
863 }
864
865 void CTX_wm_area_set(bContext *C, ScrArea *area)
866 {
867         C->wm.area = area;
868         C->wm.region = NULL;
869 }
870
871 void CTX_wm_region_set(bContext *C, ARegion *region)
872 {
873         C->wm.region = region;
874 }
875
876 void CTX_wm_menu_set(bContext *C, ARegion *menu)
877 {
878         C->wm.menu = menu;
879 }
880
881 void CTX_wm_manipulator_group_set(bContext *C, struct wmManipulatorGroup *mgroup)
882 {
883         C->wm.manipulator_group = mgroup;
884 }
885
886 void CTX_wm_operator_poll_msg_set(bContext *C, const char *msg)
887 {
888         C->wm.operator_poll_msg = msg;
889 }
890
891 const char *CTX_wm_operator_poll_msg_get(bContext *C)
892 {
893         return IFACE_(C->wm.operator_poll_msg);
894 }
895
896 /* data context */
897
898 Main *CTX_data_main(const bContext *C)
899 {
900         Main *bmain;
901
902         if (ctx_data_pointer_verify(C, "blend_data", (void *)&bmain))
903                 return bmain;
904         else
905                 return C->data.main;
906 }
907
908 void CTX_data_main_set(bContext *C, Main *bmain)
909 {
910         C->data.main = bmain;
911         BKE_sound_init_main(bmain);
912 }
913
914 Scene *CTX_data_scene(const bContext *C)
915 {
916         Scene *scene;
917
918         if (ctx_data_pointer_verify(C, "scene", (void *)&scene))
919                 return scene;
920         else
921                 return C->data.scene;
922 }
923
924 SceneLayer *CTX_data_scene_layer(const bContext *C)
925 {
926         SceneLayer *sl;
927
928         if (ctx_data_pointer_verify(C, "render_layer", (void *)&sl)) {
929                 return sl;
930         }
931         else {
932                 return BKE_scene_layer_from_workspace_get(CTX_data_scene(C), CTX_wm_workspace(C));
933         }
934 }
935
936 ViewRender *CTX_data_view_render(const bContext *C)
937 {
938         ViewRender *view_render;
939
940         if (ctx_data_pointer_verify(C, "view_render", (void *)&view_render)) {
941                 return view_render;
942         }
943         else {
944                 Scene *scene = CTX_data_scene(C);
945                 WorkSpace *workspace = CTX_wm_workspace(C);
946                 return BKE_viewrender_get(scene, workspace);
947         }
948 }
949
950 RenderEngineType *CTX_data_engine(const bContext *C)
951 {
952         ViewRender *view_render = CTX_data_view_render(C);
953         return RE_engines_find(view_render->engine_id);
954 }
955
956 /**
957  * This is tricky. Sometimes the user overrides the render_layer
958  * but not the scene_collection. In this case what to do?
959  *
960  * If the scene_collection is linked to the SceneLayer we use it.
961  * Otherwise we fallback to the active one of the SceneLayer.
962  */
963 LayerCollection *CTX_data_layer_collection(const bContext *C)
964 {
965         SceneLayer *sl = CTX_data_scene_layer(C);
966         LayerCollection *lc;
967
968         if (ctx_data_pointer_verify(C, "layer_collection", (void *)&lc)) {
969                 if (BKE_scene_layer_has_collection(sl, lc->scene_collection)) {
970                         return lc;
971                 }
972         }
973
974         /* fallback */
975         return BKE_layer_collection_get_active(sl);
976 }
977
978 SceneCollection *CTX_data_scene_collection(const bContext *C)
979 {
980         SceneCollection *sc;
981         if (ctx_data_pointer_verify(C, "scene_collection", (void *)&sc)) {
982                 if (BKE_scene_layer_has_collection(CTX_data_scene_layer(C), sc)) {
983                         return sc;
984                 }
985         }
986
987         LayerCollection *lc = CTX_data_layer_collection(C);
988         if (lc) {
989                 return lc->scene_collection;
990         }
991
992         /* fallback */
993         Scene *scene = CTX_data_scene(C);
994         return BKE_collection_master(scene);
995 }
996
997 int CTX_data_mode_enum_ex(const Object *obedit, const Object *ob)
998 {
999         // Object *obedit = CTX_data_edit_object(C);
1000         if (obedit) {
1001                 switch (obedit->type) {
1002                         case OB_MESH:
1003                                 return CTX_MODE_EDIT_MESH;
1004                         case OB_CURVE:
1005                                 return CTX_MODE_EDIT_CURVE;
1006                         case OB_SURF:
1007                                 return CTX_MODE_EDIT_SURFACE;
1008                         case OB_FONT:
1009                                 return CTX_MODE_EDIT_TEXT;
1010                         case OB_ARMATURE:
1011                                 return CTX_MODE_EDIT_ARMATURE;
1012                         case OB_MBALL:
1013                                 return CTX_MODE_EDIT_METABALL;
1014                         case OB_LATTICE:
1015                                 return CTX_MODE_EDIT_LATTICE;
1016                 }
1017         }
1018         else {
1019                 // Object *ob = CTX_data_active_object(C);
1020                 if (ob) {
1021                         if (ob->mode & OB_MODE_POSE) return CTX_MODE_POSE;
1022                         else if (ob->mode & OB_MODE_SCULPT) return CTX_MODE_SCULPT;
1023                         else if (ob->mode & OB_MODE_WEIGHT_PAINT) return CTX_MODE_PAINT_WEIGHT;
1024                         else if (ob->mode & OB_MODE_VERTEX_PAINT) return CTX_MODE_PAINT_VERTEX;
1025                         else if (ob->mode & OB_MODE_TEXTURE_PAINT) return CTX_MODE_PAINT_TEXTURE;
1026                         else if (ob->mode & OB_MODE_PARTICLE_EDIT) return CTX_MODE_PARTICLE;
1027                 }
1028         }
1029
1030         return CTX_MODE_OBJECT;
1031 }
1032
1033 int CTX_data_mode_enum(const bContext *C)
1034 {
1035         Object *obedit = CTX_data_edit_object(C);
1036         Object *obact = obedit ? NULL : CTX_data_active_object(C);
1037         return CTX_data_mode_enum_ex(obedit, obact);
1038 }
1039
1040 /* would prefer if we can use the enum version below over this one - Campbell */
1041 /* must be aligned with above enum  */
1042 static const char *data_mode_strings[] = {
1043         "mesh_edit",
1044         "curve_edit",
1045         "surface_edit",
1046         "text_edit",
1047         "armature_edit",
1048         "mball_edit",
1049         "lattice_edit",
1050         "posemode",
1051         "sculpt_mode",
1052         "weightpaint",
1053         "vertexpaint",
1054         "imagepaint",
1055         "particlemode",
1056         "objectmode",
1057         NULL
1058 };
1059 const char *CTX_data_mode_string(const bContext *C)
1060 {
1061         return data_mode_strings[CTX_data_mode_enum(C)];
1062 }
1063
1064 void CTX_data_scene_set(bContext *C, Scene *scene)
1065 {
1066         C->data.scene = scene;
1067 }
1068
1069 ToolSettings *CTX_data_tool_settings(const bContext *C)
1070 {
1071         Scene *scene = CTX_data_scene(C);
1072
1073         if (scene)
1074                 return scene->toolsettings;
1075         else
1076                 return NULL;
1077 }
1078
1079 int CTX_data_selected_nodes(const bContext *C, ListBase *list)
1080 {
1081         return ctx_data_collection_get(C, "selected_nodes", list);
1082 }
1083
1084 int CTX_data_selected_editable_objects(const bContext *C, ListBase *list)
1085 {
1086         return ctx_data_collection_get(C, "selected_editable_objects", list);
1087 }
1088
1089 int CTX_data_selected_editable_bases(const bContext *C, ListBase *list)
1090 {
1091         return ctx_data_collection_get(C, "selected_editable_bases", list);
1092 }
1093
1094 int CTX_data_editable_objects(const bContext *C, ListBase *list)
1095 {
1096         return ctx_data_collection_get(C, "editable_objects", list);
1097 }
1098
1099 int CTX_data_editable_bases(const bContext *C, ListBase *list)
1100 {
1101         return ctx_data_collection_get(C, "editable_bases", list);
1102 }
1103
1104 int CTX_data_selected_objects(const bContext *C, ListBase *list)
1105 {
1106         return ctx_data_collection_get(C, "selected_objects", list);
1107 }
1108
1109 int CTX_data_selected_bases(const bContext *C, ListBase *list)
1110 {
1111         return ctx_data_collection_get(C, "selected_bases", list);
1112 }
1113
1114 int CTX_data_visible_objects(const bContext *C, ListBase *list)
1115 {
1116         return ctx_data_collection_get(C, "visible_objects", list);
1117 }
1118
1119 int CTX_data_visible_bases(const bContext *C, ListBase *list)
1120 {
1121         return ctx_data_collection_get(C, "visible_bases", list);
1122 }
1123
1124 int CTX_data_selectable_objects(const bContext *C, ListBase *list)
1125 {
1126         return ctx_data_collection_get(C, "selectable_objects", list);
1127 }
1128
1129 int CTX_data_selectable_bases(const bContext *C, ListBase *list)
1130 {
1131         return ctx_data_collection_get(C, "selectable_bases", list);
1132 }
1133
1134 struct Object *CTX_data_active_object(const bContext *C)
1135 {
1136         return ctx_data_pointer_get(C, "active_object");
1137 }
1138
1139 struct Base *CTX_data_active_base(const bContext *C)
1140 {
1141         return ctx_data_pointer_get(C, "active_base");
1142 }
1143
1144 struct Object *CTX_data_edit_object(const bContext *C)
1145 {
1146         return ctx_data_pointer_get(C, "edit_object");
1147 }
1148
1149 struct Image *CTX_data_edit_image(const bContext *C)
1150 {
1151         return ctx_data_pointer_get(C, "edit_image");
1152 }
1153
1154 struct Text *CTX_data_edit_text(const bContext *C)
1155 {
1156         return ctx_data_pointer_get(C, "edit_text");
1157 }
1158
1159 struct MovieClip *CTX_data_edit_movieclip(const bContext *C)
1160 {
1161         return ctx_data_pointer_get(C, "edit_movieclip");
1162 }
1163
1164 struct Mask *CTX_data_edit_mask(const bContext *C)
1165 {
1166         return ctx_data_pointer_get(C, "edit_mask");
1167 }
1168
1169 struct EditBone *CTX_data_active_bone(const bContext *C)
1170 {
1171         return ctx_data_pointer_get(C, "active_bone");
1172 }
1173
1174 struct CacheFile *CTX_data_edit_cachefile(const bContext *C)
1175 {
1176         return ctx_data_pointer_get(C, "edit_cachefile");
1177 }
1178
1179 int CTX_data_selected_bones(const bContext *C, ListBase *list)
1180 {
1181         return ctx_data_collection_get(C, "selected_bones", list);
1182 }
1183
1184 int CTX_data_selected_editable_bones(const bContext *C, ListBase *list)
1185 {
1186         return ctx_data_collection_get(C, "selected_editable_bones", list);
1187 }
1188
1189 int CTX_data_visible_bones(const bContext *C, ListBase *list)
1190 {
1191         return ctx_data_collection_get(C, "visible_bones", list);
1192 }
1193
1194 int CTX_data_editable_bones(const bContext *C, ListBase *list)
1195 {
1196         return ctx_data_collection_get(C, "editable_bones", list);
1197 }
1198
1199 struct bPoseChannel *CTX_data_active_pose_bone(const bContext *C)
1200 {
1201         return ctx_data_pointer_get(C, "active_pose_bone");
1202 }
1203
1204 int CTX_data_selected_pose_bones(const bContext *C, ListBase *list)
1205 {
1206         return ctx_data_collection_get(C, "selected_pose_bones", list);
1207 }
1208
1209 int CTX_data_visible_pose_bones(const bContext *C, ListBase *list)
1210 {
1211         return ctx_data_collection_get(C, "visible_pose_bones", list);
1212 }
1213
1214 bGPdata *CTX_data_gpencil_data(const bContext *C)
1215 {
1216         return ctx_data_pointer_get(C, "gpencil_data");
1217 }
1218
1219 bGPDlayer *CTX_data_active_gpencil_layer(const bContext *C)
1220 {
1221         return ctx_data_pointer_get(C, "active_gpencil_layer");
1222 }
1223
1224 bGPDpalette *CTX_data_active_gpencil_palette(const bContext *C)
1225 {
1226         return ctx_data_pointer_get(C, "active_gpencil_palette");
1227 }
1228
1229 bGPDpalettecolor *CTX_data_active_gpencil_palettecolor(const bContext *C)
1230 {
1231         return ctx_data_pointer_get(C, "active_gpencil_palettecolor");
1232 }
1233
1234 bGPDbrush *CTX_data_active_gpencil_brush(const bContext *C)
1235 {
1236         return ctx_data_pointer_get(C, "active_gpencil_brush");
1237 }
1238
1239 bGPDframe *CTX_data_active_gpencil_frame(const bContext *C)
1240 {
1241         return ctx_data_pointer_get(C, "active_gpencil_frame");
1242 }
1243
1244 int CTX_data_visible_gpencil_layers(const bContext *C, ListBase *list)
1245 {
1246         return ctx_data_collection_get(C, "visible_gpencil_layers", list);
1247 }
1248
1249 int CTX_data_editable_gpencil_layers(const bContext *C, ListBase *list)
1250 {
1251         return ctx_data_collection_get(C, "editable_gpencil_layers", list);
1252 }
1253
1254 int CTX_data_editable_gpencil_strokes(const bContext *C, ListBase *list)
1255 {
1256         return ctx_data_collection_get(C, "editable_gpencil_strokes", list);
1257 }
1258
1259 Depsgraph *CTX_data_depsgraph(const bContext *C)
1260 {
1261         Scene *scene = CTX_data_scene(C);
1262         SceneLayer *scene_layer = CTX_data_scene_layer(C);
1263         return BKE_scene_get_depsgraph(scene, scene_layer, true);
1264 }
1265
1266 void CTX_data_eval_ctx(const bContext *C, EvaluationContext *eval_ctx)
1267 {
1268         BLI_assert(C != NULL);
1269
1270         Scene *scene = CTX_data_scene(C);
1271         SceneLayer *scene_layer = CTX_data_scene_layer(C);
1272         RenderEngineType *engine = CTX_data_engine(C);
1273         DEG_evaluation_context_init_from_scene(eval_ctx,
1274                                                scene, scene_layer, engine,
1275                                                DAG_EVAL_VIEWPORT);
1276 }