Merge branch 'master' into blender2.8
[blender.git] / source / blender / blenkernel / intern / node.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  * The Original Code is Copyright (C) 2005 Blender Foundation.
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): Bob Holcomb.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file blender/blenkernel/intern/node.c
29  *  \ingroup bke
30  */
31
32 #include "MEM_guardedalloc.h"
33
34 #include <stdlib.h>
35 #include <stddef.h>
36 #include <string.h>
37 #include <limits.h>
38
39 #include "DNA_action_types.h"
40 #include "DNA_anim_types.h"
41 #include "DNA_lamp_types.h"
42 #include "DNA_material_types.h"
43 #include "DNA_node_types.h"
44 #include "DNA_scene_types.h"
45 #include "DNA_texture_types.h"
46 #include "DNA_world_types.h"
47 #include "DNA_linestyle_types.h"
48
49 #include "BLI_listbase.h"
50 #include "BLI_math.h"
51 #include "BLI_path_util.h"
52 #include "BLI_string.h"
53 #include "BLI_string_utils.h"
54 #include "BLI_utildefines.h"
55
56 #include "BLT_translation.h"
57
58 #include "BKE_animsys.h"
59 #include "BKE_global.h"
60 #include "BKE_idprop.h"
61 #include "BKE_library.h"
62 #include "BKE_library_query.h"
63 #include "BKE_library_remap.h"
64 #include "BKE_main.h"
65 #include "BKE_node.h"
66
67 #include "BLI_ghash.h"
68 #include "BLI_threads.h"
69 #include "RNA_access.h"
70 #include "RNA_define.h"
71
72 #include "NOD_socket.h"
73 #include "NOD_common.h"
74 #include "NOD_composite.h"
75 #include "NOD_shader.h"
76 #include "NOD_texture.h"
77
78 #define NODE_DEFAULT_MAX_WIDTH 700
79
80 /* Fallback types for undefined tree, nodes, sockets */
81 bNodeTreeType NodeTreeTypeUndefined;
82 bNodeType NodeTypeUndefined;
83 bNodeSocketType NodeSocketTypeUndefined;
84
85
86 static void node_add_sockets_from_type(bNodeTree *ntree, bNode *node, bNodeType *ntype)
87 {
88         bNodeSocketTemplate *sockdef;
89         /* bNodeSocket *sock; */ /* UNUSED */
90
91         if (ntype->inputs) {
92                 sockdef = ntype->inputs;
93                 while (sockdef->type != -1) {
94                         /* sock = */ node_add_socket_from_template(ntree, node, sockdef, SOCK_IN);
95                         
96                         sockdef++;
97                 }
98         }
99         if (ntype->outputs) {
100                 sockdef = ntype->outputs;
101                 while (sockdef->type != -1) {
102                         /* sock = */ node_add_socket_from_template(ntree, node, sockdef, SOCK_OUT);
103                         
104                         sockdef++;
105                 }
106         }
107 }
108
109 /* Note: This function is called to initialize node data based on the type.
110  * The bNodeType may not be registered at creation time of the node,
111  * so this can be delayed until the node type gets registered.
112  */
113 static void node_init(const struct bContext *C, bNodeTree *ntree, bNode *node)
114 {
115         bNodeType *ntype = node->typeinfo;
116         if (ntype == &NodeTypeUndefined)
117                 return;
118         
119         /* only do this once */
120         if (node->flag & NODE_INIT)
121                 return;
122         
123         node->flag = NODE_SELECT | NODE_OPTIONS | ntype->flag;
124         node->width = ntype->width;
125         node->miniwidth = 42.0f;
126         node->height = ntype->height;
127         node->color[0] = node->color[1] = node->color[2] = 0.608;   /* default theme color */
128         /* initialize the node name with the node label.
129          * note: do this after the initfunc so nodes get their data set which may be used in naming
130          * (node groups for example) */
131         /* XXX Do not use nodeLabel() here, it returns translated content for UI, which should *only* be used
132          *     in UI, *never* in data... Data have their own translation option!
133          *     This solution may be a bit rougher than nodeLabel()'s returned string, but it's simpler
134          *     than adding "do_translate" flags to this func (and labelfunc() as well). */
135         BLI_strncpy(node->name, DATA_(ntype->ui_name), NODE_MAXSTR);
136         nodeUniqueName(ntree, node);
137         
138         node_add_sockets_from_type(ntree, node, ntype);
139
140         if (ntype->initfunc != NULL)
141                 ntype->initfunc(ntree, node);
142
143         if (ntree->typeinfo->node_add_init != NULL)
144                 ntree->typeinfo->node_add_init(ntree, node);
145
146         /* extra init callback */
147         if (ntype->initfunc_api) {
148                 PointerRNA ptr;
149                 RNA_pointer_create((ID *)ntree, &RNA_Node, node, &ptr);
150                 
151                 /* XXX Warning: context can be NULL in case nodes are added in do_versions.
152                  * Delayed init is not supported for nodes with context-based initfunc_api atm.
153                  */
154                 BLI_assert(C != NULL);
155                 ntype->initfunc_api(C, &ptr);
156         }
157         
158         if (node->id)
159                 id_us_plus(node->id);
160         
161         node->flag |= NODE_INIT;
162 }
163
164 static void ntree_set_typeinfo(bNodeTree *ntree, bNodeTreeType *typeinfo)
165 {
166         if (typeinfo) {
167                 ntree->typeinfo = typeinfo;
168                 
169                 /* deprecated integer type */
170                 ntree->type = typeinfo->type;
171         }
172         else {
173                 ntree->typeinfo = &NodeTreeTypeUndefined;
174                 
175                 ntree->init &= ~NTREE_TYPE_INIT;
176         }
177 }
178
179 static void node_set_typeinfo(const struct bContext *C, bNodeTree *ntree, bNode *node, bNodeType *typeinfo)
180 {
181         /* for nodes saved in older versions storage can get lost, make undefined then */
182         if (node->flag & NODE_INIT) {
183                 if (typeinfo && typeinfo->storagename[0] && !node->storage)
184                         typeinfo = NULL;
185         }
186         
187         if (typeinfo) {
188                 node->typeinfo = typeinfo;
189                 
190                 /* deprecated integer type */
191                 node->type = typeinfo->type;
192                 
193                 /* initialize the node if necessary */
194                 node_init(C, ntree, node);
195         }
196         else {
197                 node->typeinfo = &NodeTypeUndefined;
198                 
199                 ntree->init &= ~NTREE_TYPE_INIT;
200         }
201 }
202
203 static void node_socket_set_typeinfo(bNodeTree *ntree, bNodeSocket *sock, bNodeSocketType *typeinfo)
204 {
205         if (typeinfo) {
206                 sock->typeinfo = typeinfo;
207                 
208                 /* deprecated integer type */
209                 sock->type = typeinfo->type;
210                 
211                 if (sock->default_value == NULL) {
212                         /* initialize the default_value pointer used by standard socket types */
213                         node_socket_init_default_value(sock);
214                 }
215         }
216         else {
217                 sock->typeinfo = &NodeSocketTypeUndefined;
218                 
219                 ntree->init &= ~NTREE_TYPE_INIT;
220         }
221 }
222
223 /* Set specific typeinfo pointers in all node trees on register/unregister */
224 static void update_typeinfo(Main *bmain, const struct bContext *C, bNodeTreeType *treetype, bNodeType *nodetype, bNodeSocketType *socktype, bool unregister)
225 {
226         if (!bmain)
227                 return;
228         
229         FOREACH_NODETREE(bmain, ntree, id) {
230                 bNode *node;
231                 bNodeSocket *sock;
232                 
233                 ntree->init |= NTREE_TYPE_INIT;
234                 
235                 if (treetype && STREQ(ntree->idname, treetype->idname))
236                         ntree_set_typeinfo(ntree, unregister ? NULL : treetype);
237                 
238                 /* initialize nodes */
239                 for (node = ntree->nodes.first; node; node = node->next) {
240                         if (nodetype && STREQ(node->idname, nodetype->idname))
241                                 node_set_typeinfo(C, ntree, node, unregister ? NULL : nodetype);
242                         
243                         /* initialize node sockets */
244                         for (sock = node->inputs.first; sock; sock = sock->next)
245                                 if (socktype && STREQ(sock->idname, socktype->idname))
246                                         node_socket_set_typeinfo(ntree, sock, unregister ? NULL : socktype);
247                         for (sock = node->outputs.first; sock; sock = sock->next)
248                                 if (socktype && STREQ(sock->idname, socktype->idname))
249                                         node_socket_set_typeinfo(ntree, sock, unregister ? NULL : socktype);
250                 }
251                 
252                 /* initialize tree sockets */
253                 for (sock = ntree->inputs.first; sock; sock = sock->next)
254                         if (socktype && STREQ(sock->idname, socktype->idname))
255                                 node_socket_set_typeinfo(ntree, sock, unregister ? NULL : socktype);
256                 for (sock = ntree->outputs.first; sock; sock = sock->next)
257                         if (socktype && STREQ(sock->idname, socktype->idname))
258                                 node_socket_set_typeinfo(ntree, sock, unregister ? NULL : socktype);
259         }
260         FOREACH_NODETREE_END
261 }
262
263 /* Try to initialize all typeinfo in a node tree.
264  * NB: In general undefined typeinfo is a perfectly valid case, the type may just be registered later.
265  * In that case the update_typeinfo function will set typeinfo on registration
266  * and do necessary updates.
267  */
268 void ntreeSetTypes(const struct bContext *C, bNodeTree *ntree)
269 {
270         bNode *node;
271         bNodeSocket *sock;
272         
273         ntree->init |= NTREE_TYPE_INIT;
274         
275         ntree_set_typeinfo(ntree, ntreeTypeFind(ntree->idname));
276         
277         for (node = ntree->nodes.first; node; node = node->next) {
278                 node_set_typeinfo(C, ntree, node, nodeTypeFind(node->idname));
279                 
280                 for (sock = node->inputs.first; sock; sock = sock->next)
281                         node_socket_set_typeinfo(ntree, sock, nodeSocketTypeFind(sock->idname));
282                 for (sock = node->outputs.first; sock; sock = sock->next)
283                         node_socket_set_typeinfo(ntree, sock, nodeSocketTypeFind(sock->idname));
284         }
285         
286         for (sock = ntree->inputs.first; sock; sock = sock->next)
287                 node_socket_set_typeinfo(ntree, sock, nodeSocketTypeFind(sock->idname));
288         for (sock = ntree->outputs.first; sock; sock = sock->next)
289                 node_socket_set_typeinfo(ntree, sock, nodeSocketTypeFind(sock->idname));
290 }
291
292
293 static GHash *nodetreetypes_hash = NULL;
294 static GHash *nodetypes_hash = NULL;
295 static GHash *nodesockettypes_hash = NULL;
296 static SpinLock spin;
297
298 bNodeTreeType *ntreeTypeFind(const char *idname)
299 {
300         bNodeTreeType *nt;
301
302         if (idname[0]) {
303                 nt = BLI_ghash_lookup(nodetreetypes_hash, idname);
304                 if (nt)
305                         return nt;
306         }
307
308         return NULL;
309 }
310
311 void ntreeTypeAdd(bNodeTreeType *nt)
312 {
313         BLI_ghash_insert(nodetreetypes_hash, nt->idname, nt);
314         /* XXX pass Main to register function? */
315         update_typeinfo(G.main, NULL, nt, NULL, NULL, false);
316 }
317
318 /* callback for hash value free function */
319 static void ntree_free_type(void *treetype_v)
320 {
321         bNodeTreeType *treetype = treetype_v;
322         /* XXX pass Main to unregister function? */
323         update_typeinfo(G.main, NULL, treetype, NULL, NULL, true);
324         MEM_freeN(treetype);
325 }
326
327 void ntreeTypeFreeLink(const bNodeTreeType *nt)
328 {
329         BLI_ghash_remove(nodetreetypes_hash, nt->idname, NULL, ntree_free_type);
330 }
331
332 bool ntreeIsRegistered(bNodeTree *ntree)
333 {
334         return (ntree->typeinfo != &NodeTreeTypeUndefined);
335 }
336
337 GHashIterator *ntreeTypeGetIterator(void)
338 {
339         return BLI_ghashIterator_new(nodetreetypes_hash);
340 }
341
342 bNodeType *nodeTypeFind(const char *idname)
343 {
344         bNodeType *nt;
345
346         if (idname[0]) {
347                 nt = BLI_ghash_lookup(nodetypes_hash, idname);
348                 if (nt)
349                         return nt;
350         }
351
352         return NULL;
353 }
354
355 static void free_dynamic_typeinfo(bNodeType *ntype)
356 {
357         if (ntype->type == NODE_DYNAMIC) {
358                 if (ntype->inputs) {
359                         MEM_freeN(ntype->inputs);
360                 }
361                 if (ntype->outputs) {
362                         MEM_freeN(ntype->outputs);
363                 }
364         }
365 }
366
367 /* callback for hash value free function */
368 static void node_free_type(void *nodetype_v)
369 {
370         bNodeType *nodetype = nodetype_v;
371         /* XXX pass Main to unregister function? */
372         update_typeinfo(G.main, NULL, NULL, nodetype, NULL, true);
373         
374         /* XXX deprecated */
375         if (nodetype->type == NODE_DYNAMIC)
376                 free_dynamic_typeinfo(nodetype);
377         
378         if (nodetype->needs_free)
379                 MEM_freeN(nodetype);
380 }
381
382 void nodeRegisterType(bNodeType *nt)
383 {
384         /* debug only: basic verification of registered types */
385         BLI_assert(nt->idname[0] != '\0');
386         BLI_assert(nt->poll != NULL);
387         
388         BLI_ghash_insert(nodetypes_hash, nt->idname, nt);
389         /* XXX pass Main to register function? */
390         update_typeinfo(G.main, NULL, NULL, nt, NULL, false);
391 }
392
393 void nodeUnregisterType(bNodeType *nt)
394 {
395         BLI_ghash_remove(nodetypes_hash, nt->idname, NULL, node_free_type);
396 }
397
398 bool nodeIsRegistered(bNode *node)
399 {
400         return (node->typeinfo != &NodeTypeUndefined);
401 }
402
403 GHashIterator *nodeTypeGetIterator(void)
404 {
405         return BLI_ghashIterator_new(nodetypes_hash);
406 }
407
408 bNodeSocketType *nodeSocketTypeFind(const char *idname)
409 {
410         bNodeSocketType *st;
411
412         if (idname[0]) {
413                 st = BLI_ghash_lookup(nodesockettypes_hash, idname);
414                 if (st)
415                         return st;
416         }
417
418         return NULL;
419 }
420
421 /* callback for hash value free function */
422 static void node_free_socket_type(void *socktype_v)
423 {
424         bNodeSocketType *socktype = socktype_v;
425         /* XXX pass Main to unregister function? */
426         update_typeinfo(G.main, NULL, NULL, NULL, socktype, true);
427         
428         MEM_freeN(socktype);
429 }
430
431 void nodeRegisterSocketType(bNodeSocketType *st)
432 {
433         BLI_ghash_insert(nodesockettypes_hash, (void *)st->idname, st);
434         /* XXX pass Main to register function? */
435         update_typeinfo(G.main, NULL, NULL, NULL, st, false);
436 }
437
438 void nodeUnregisterSocketType(bNodeSocketType *st)
439 {
440         BLI_ghash_remove(nodesockettypes_hash, st->idname, NULL, node_free_socket_type);
441 }
442
443 bool nodeSocketIsRegistered(bNodeSocket *sock)
444 {
445         return (sock->typeinfo != &NodeSocketTypeUndefined);
446 }
447
448 GHashIterator *nodeSocketTypeGetIterator(void)
449 {
450         return BLI_ghashIterator_new(nodesockettypes_hash);
451 }
452
453 struct bNodeSocket *nodeFindSocket(bNode *node, int in_out, const char *identifier)
454 {
455         bNodeSocket *sock = (in_out == SOCK_IN ? node->inputs.first : node->outputs.first);
456         for (; sock; sock = sock->next) {
457                 if (STREQ(sock->identifier, identifier))
458                         return sock;
459         }
460         return NULL;
461 }
462
463 /* find unique socket identifier */
464 static bool unique_identifier_check(void *arg, const char *identifier)
465 {
466         struct ListBase *lb = arg;
467         bNodeSocket *sock;
468         for (sock = lb->first; sock; sock = sock->next) {
469                 if (STREQ(sock->identifier, identifier))
470                         return true;
471         }
472         return false;
473 }
474
475 static bNodeSocket *make_socket(bNodeTree *ntree, bNode *UNUSED(node), int in_out, ListBase *lb,
476                                 const char *idname, const char *identifier, const char *name)
477 {
478         bNodeSocket *sock;
479         char auto_identifier[MAX_NAME];
480         
481         if (identifier && identifier[0] != '\0') {
482                 /* use explicit identifier */
483                 BLI_strncpy(auto_identifier, identifier, sizeof(auto_identifier));
484         }
485         else {
486                 /* if no explicit identifier is given, assign a unique identifier based on the name */
487                 BLI_strncpy(auto_identifier, name, sizeof(auto_identifier));
488         }
489         /* make the identifier unique */
490         BLI_uniquename_cb(unique_identifier_check, lb, "socket", '.', auto_identifier, sizeof(auto_identifier));
491         
492         sock = MEM_callocN(sizeof(bNodeSocket), "sock");
493         sock->in_out = in_out;
494         
495         BLI_strncpy(sock->identifier, auto_identifier, NODE_MAXSTR);
496         sock->limit = (in_out == SOCK_IN ? 1 : 0xFFF);
497         
498         BLI_strncpy(sock->name, name, NODE_MAXSTR);
499         sock->storage = NULL;
500         sock->flag |= SOCK_COLLAPSED;
501         sock->type = SOCK_CUSTOM;       /* int type undefined by default */
502         
503         BLI_strncpy(sock->idname, idname, sizeof(sock->idname));
504         node_socket_set_typeinfo(ntree, sock, nodeSocketTypeFind(idname));
505         
506         return sock;
507 }
508
509 bNodeSocket *nodeAddSocket(bNodeTree *ntree, bNode *node, int in_out, const char *idname,
510                            const char *identifier, const char *name)
511 {
512         ListBase *lb = (in_out == SOCK_IN ? &node->inputs : &node->outputs);
513         bNodeSocket *sock = make_socket(ntree, node, in_out, lb, idname, identifier, name);
514         
515         BLI_remlink(lb, sock);  /* does nothing for new socket */
516         BLI_addtail(lb, sock);
517         
518         node->update |= NODE_UPDATE;
519         
520         return sock;
521 }
522
523 bNodeSocket *nodeInsertSocket(bNodeTree *ntree, bNode *node, int in_out, const char *idname,
524                               bNodeSocket *next_sock, const char *identifier, const char *name)
525 {
526         ListBase *lb = (in_out == SOCK_IN ? &node->inputs : &node->outputs);
527         bNodeSocket *sock = make_socket(ntree, node, in_out, lb, idname, identifier, name);
528         
529         BLI_remlink(lb, sock);  /* does nothing for new socket */
530         BLI_insertlinkbefore(lb, next_sock, sock);
531         
532         node->update |= NODE_UPDATE;
533         
534         return sock;
535 }
536
537 const char *nodeStaticSocketType(int type, int subtype)
538 {
539         switch (type) {
540                 case SOCK_FLOAT:
541                         switch (subtype) {
542                                 case PROP_UNSIGNED:
543                                         return "NodeSocketFloatUnsigned";
544                                 case PROP_PERCENTAGE:
545                                         return "NodeSocketFloatPercentage";
546                                 case PROP_FACTOR:
547                                         return "NodeSocketFloatFactor";
548                                 case PROP_ANGLE:
549                                         return "NodeSocketFloatAngle";
550                                 case PROP_TIME:
551                                         return "NodeSocketFloatTime";
552                                 case PROP_NONE:
553                                 default:
554                                         return "NodeSocketFloat";
555                         }
556                 case SOCK_INT:
557                         switch (subtype) {
558                                 case PROP_UNSIGNED:
559                                         return "NodeSocketIntUnsigned";
560                                 case PROP_PERCENTAGE:
561                                         return "NodeSocketIntPercentage";
562                                 case PROP_FACTOR:
563                                         return "NodeSocketIntFactor";
564                                 case PROP_NONE:
565                                 default:
566                                         return "NodeSocketInt";
567                         }
568                 case SOCK_BOOLEAN:
569                         return "NodeSocketBool";
570                 case SOCK_VECTOR:
571                         switch (subtype) {
572                                 case PROP_TRANSLATION:
573                                         return "NodeSocketVectorTranslation";
574                                 case PROP_DIRECTION:
575                                         return "NodeSocketVectorDirection";
576                                 case PROP_VELOCITY:
577                                         return "NodeSocketVectorVelocity";
578                                 case PROP_ACCELERATION:
579                                         return "NodeSocketVectorAcceleration";
580                                 case PROP_EULER:
581                                         return "NodeSocketVectorEuler";
582                                 case PROP_XYZ:
583                                         return "NodeSocketVectorXYZ";
584                                 case PROP_NONE:
585                                 default:
586                                         return "NodeSocketVector";
587                         }
588                 case SOCK_RGBA:
589                         return "NodeSocketColor";
590                 case SOCK_STRING:
591                         return "NodeSocketString";
592                 case SOCK_SHADER:
593                         return "NodeSocketShader";
594         }
595         return NULL;
596 }
597
598 const char *nodeStaticSocketInterfaceType(int type, int subtype)
599 {
600         switch (type) {
601                 case SOCK_FLOAT:
602                         switch (subtype) {
603                                 case PROP_UNSIGNED:
604                                         return "NodeSocketInterfaceFloatUnsigned";
605                                 case PROP_PERCENTAGE:
606                                         return "NodeSocketInterfaceFloatPercentage";
607                                 case PROP_FACTOR:
608                                         return "NodeSocketInterfaceFloatFactor";
609                                 case PROP_ANGLE:
610                                         return "NodeSocketInterfaceFloatAngle";
611                                 case PROP_TIME:
612                                         return "NodeSocketInterfaceFloatTime";
613                                 case PROP_NONE:
614                                 default:
615                                         return "NodeSocketInterfaceFloat";
616                         }
617                 case SOCK_INT:
618                         switch (subtype) {
619                                 case PROP_UNSIGNED:
620                                         return "NodeSocketInterfaceIntUnsigned";
621                                 case PROP_PERCENTAGE:
622                                         return "NodeSocketInterfaceIntPercentage";
623                                 case PROP_FACTOR:
624                                         return "NodeSocketInterfaceIntFactor";
625                                 case PROP_NONE:
626                                 default:
627                                         return "NodeSocketInterfaceInt";
628                         }
629                 case SOCK_BOOLEAN:
630                         return "NodeSocketInterfaceBool";
631                 case SOCK_VECTOR:
632                         switch (subtype) {
633                                 case PROP_TRANSLATION:
634                                         return "NodeSocketInterfaceVectorTranslation";
635                                 case PROP_DIRECTION:
636                                         return "NodeSocketInterfaceVectorDirection";
637                                 case PROP_VELOCITY:
638                                         return "NodeSocketInterfaceVectorVelocity";
639                                 case PROP_ACCELERATION:
640                                         return "NodeSocketInterfaceVectorAcceleration";
641                                 case PROP_EULER:
642                                         return "NodeSocketInterfaceVectorEuler";
643                                 case PROP_XYZ:
644                                         return "NodeSocketInterfaceVectorXYZ";
645                                 case PROP_NONE:
646                                 default:
647                                         return "NodeSocketInterfaceVector";
648                         }
649                 case SOCK_RGBA:
650                         return "NodeSocketInterfaceColor";
651                 case SOCK_STRING:
652                         return "NodeSocketInterfaceString";
653                 case SOCK_SHADER:
654                         return "NodeSocketInterfaceShader";
655         }
656         return NULL;
657 }
658
659 bNodeSocket *nodeAddStaticSocket(bNodeTree *ntree, bNode *node, int in_out, int type, int subtype,
660                                  const char *identifier, const char *name)
661 {
662         const char *idname = nodeStaticSocketType(type, subtype);
663         bNodeSocket *sock;
664         
665         if (!idname) {
666                 printf("Error: static node socket type %d undefined\n", type);
667                 return NULL;
668         }
669         
670         sock = nodeAddSocket(ntree, node, in_out, idname, identifier, name);
671         sock->type = type;
672         return sock;
673 }
674
675 bNodeSocket *nodeInsertStaticSocket(bNodeTree *ntree, bNode *node, int in_out, int type, int subtype,
676                                     bNodeSocket *next_sock, const char *identifier, const char *name)
677 {
678         const char *idname = nodeStaticSocketType(type, subtype);
679         bNodeSocket *sock;
680         
681         if (!idname) {
682                 printf("Error: static node socket type %d undefined\n", type);
683                 return NULL;
684         }
685         
686         sock = nodeInsertSocket(ntree, node, in_out, idname, next_sock, identifier, name);
687         sock->type = type;
688         return sock;
689 }
690
691 static void node_socket_free(bNodeTree *UNUSED(ntree), bNodeSocket *sock, bNode *UNUSED(node))
692 {
693         if (sock->prop) {
694                 IDP_FreeProperty(sock->prop);
695                 MEM_freeN(sock->prop);
696         }
697         
698         if (sock->default_value)
699                 MEM_freeN(sock->default_value);
700 }
701
702 void nodeRemoveSocket(bNodeTree *ntree, bNode *node, bNodeSocket *sock)
703 {
704         bNodeLink *link, *next;
705         
706         for (link = ntree->links.first; link; link = next) {
707                 next = link->next;
708                 if (link->fromsock == sock || link->tosock == sock) {
709                         nodeRemLink(ntree, link);
710                 }
711         }
712         
713         /* this is fast, this way we don't need an in_out argument */
714         BLI_remlink(&node->inputs, sock);
715         BLI_remlink(&node->outputs, sock);
716         
717         node_socket_free(ntree, sock, node);
718         MEM_freeN(sock);
719         
720         node->update |= NODE_UPDATE;
721 }
722
723 void nodeRemoveAllSockets(bNodeTree *ntree, bNode *node)
724 {
725         bNodeSocket *sock, *sock_next;
726         bNodeLink *link, *next;
727         
728         for (link = ntree->links.first; link; link = next) {
729                 next = link->next;
730                 if (link->fromnode == node || link->tonode == node) {
731                         nodeRemLink(ntree, link);
732                 }
733         }
734         
735         for (sock = node->inputs.first; sock; sock = sock_next) {
736                 sock_next = sock->next;
737                 node_socket_free(ntree, sock, node);
738                 MEM_freeN(sock);
739         }
740         BLI_listbase_clear(&node->inputs);
741
742         for (sock = node->outputs.first; sock; sock = sock_next) {
743                 sock_next = sock->next;
744                 node_socket_free(ntree, sock, node);
745                 MEM_freeN(sock);
746         }
747         BLI_listbase_clear(&node->outputs);
748         
749         node->update |= NODE_UPDATE;
750 }
751
752 /* finds a node based on its name */
753 bNode *nodeFindNodebyName(bNodeTree *ntree, const char *name)
754 {
755         return BLI_findstring(&ntree->nodes, name, offsetof(bNode, name));
756 }
757
758 /* finds a node based on given socket */
759 int nodeFindNode(bNodeTree *ntree, bNodeSocket *sock, bNode **nodep, int *sockindex)
760 {
761         int in_out = sock->in_out;
762         bNode *node;
763         bNodeSocket *tsock;
764         int index = 0;
765         
766         for (node = ntree->nodes.first; node; node = node->next) {
767                 tsock = (in_out == SOCK_IN ? node->inputs.first : node->outputs.first);
768                 for (index = 0; tsock; tsock = tsock->next, index++) {
769                         if (tsock == sock)
770                                 break;
771                 }
772                 if (tsock)
773                         break;
774         }
775
776         if (node) {
777                 *nodep = node;
778                 if (sockindex) *sockindex = index;
779                 return 1;
780         }
781         
782         *nodep = NULL;
783         return 0;
784 }
785
786 /**
787  * \note Recursive
788  */
789 bNode *nodeFindRootParent(bNode *node)
790 {
791         if (node->parent) {
792                 return nodeFindRootParent(node->parent);
793         }
794         else {
795                 return node->type == NODE_FRAME ? node : NULL;
796         }
797 }
798
799 /**
800  * \returns true if \a child has \a parent as a parent/grandparent/...
801  * \note Recursive
802  */
803 bool nodeIsChildOf(const bNode *parent, const bNode *child)
804 {
805         if (parent == child) {
806                 return true;
807         }
808         else if (child->parent) {
809                 return nodeIsChildOf(parent, child->parent);
810         }
811         return false;
812 }
813
814 /**
815  * Iterate over a chain of nodes, starting with \a node_start, executing
816  * \a callback for each node (which can return false to end iterator).
817  * 
818  * \param reversed for backwards iteration
819  * \note Recursive
820  */
821 void nodeChainIter(
822         const bNodeTree *ntree, const bNode *node_start,
823         bool (*callback)(bNode *, bNode *, void *, const bool), void *userdata,
824         const bool reversed)
825 {
826         bNodeLink *link;
827
828         for (link = ntree->links.first; link; link = link->next) {
829                 if ((link->flag & NODE_LINK_VALID) == 0) {
830                         /* Skip links marked as cyclic. */
831                         continue;
832                 }
833                 if (link->tonode && link->fromnode) {
834                         /* is the link part of the chain meaning node_start == fromnode (or tonode for reversed case)? */
835                         if ((reversed && (link->tonode == node_start)) ||
836                             (!reversed && link->fromnode == node_start))
837                         {
838                                 if (!callback(link->fromnode, link->tonode, userdata, reversed)) {
839                                         return;
840                                 }
841                                 nodeChainIter(ntree, reversed ? link->fromnode : link->tonode, callback, userdata, reversed);
842                         }
843                 }
844         }
845 }
846
847 /**
848  * Iterate over all parents of \a node, executing \a callback for each parent (which can return false to end iterator)
849  * 
850  * \note Recursive
851  */
852 void nodeParentsIter(bNode *node, bool (*callback)(bNode *, void *), void *userdata)
853 {
854         if (node->parent) {
855                 if (!callback(node->parent, userdata)) {
856                         return;
857                 }
858                 nodeParentsIter(node->parent, callback, userdata);
859         }
860 }
861
862 /* ************** Add stuff ********** */
863
864 /* Find the first available, non-duplicate name for a given node */
865 void nodeUniqueName(bNodeTree *ntree, bNode *node)
866 {
867         BLI_uniquename(&ntree->nodes, node, DATA_("Node"), '.', offsetof(bNode, name), sizeof(node->name));
868 }
869
870 bNode *nodeAddNode(const struct bContext *C, bNodeTree *ntree, const char *idname)
871 {
872         bNode *node;
873         
874         node = MEM_callocN(sizeof(bNode), "new node");
875         BLI_addtail(&ntree->nodes, node);
876         
877         BLI_strncpy(node->idname, idname, sizeof(node->idname));
878         node_set_typeinfo(C, ntree, node, nodeTypeFind(idname));
879         
880         ntree->update |= NTREE_UPDATE_NODES;
881         
882         return node;
883 }
884
885 bNode *nodeAddStaticNode(const struct bContext *C, bNodeTree *ntree, int type)
886 {
887         const char *idname = NULL;
888         
889         NODE_TYPES_BEGIN(ntype)
890                 /* do an extra poll here, because some int types are used
891                  * for multiple node types, this helps find the desired type
892                  */
893                 if (ntype->type == type && (!ntype->poll || ntype->poll(ntype, ntree))) {
894                         idname = ntype->idname;
895                         break;
896                 }
897         NODE_TYPES_END
898         if (!idname) {
899                 printf("Error: static node type %d undefined\n", type);
900                 return NULL;
901         }
902         return nodeAddNode(C, ntree, idname);
903 }
904
905 static void node_socket_copy(bNodeSocket *sock_dst, bNodeSocket *sock_src, const int flag)
906 {
907         sock_src->new_sock = sock_dst;
908
909         if (sock_src->prop) {
910                 sock_dst->prop = IDP_CopyProperty_ex(sock_src->prop, flag);
911         }
912
913         if (sock_src->default_value) {
914                 sock_dst->default_value = MEM_dupallocN(sock_src->default_value);
915         }
916
917         sock_dst->stack_index = 0;
918         /* XXX some compositor node (e.g. image, render layers) still store
919          * some persistent buffer data here, need to clear this to avoid dangling pointers.
920          */
921         sock_dst->cache = NULL;
922 }
923
924 /* keep socket listorder identical, for copying links */
925 /* ntree is the target tree */
926 bNode *BKE_node_copy_ex(bNodeTree *ntree, bNode *node_src, const int flag)
927 {
928         bNode *node_dst = MEM_callocN(sizeof(bNode), "dupli node");
929         bNodeSocket *sock_dst, *sock_src;
930         bNodeLink *link_dst, *link_src;
931
932         *node_dst = *node_src;
933         /* can be called for nodes outside a node tree (e.g. clipboard) */
934         if (ntree) {
935                 nodeUniqueName(ntree, node_dst);
936
937                 BLI_addtail(&ntree->nodes, node_dst);
938         }
939
940         BLI_duplicatelist(&node_dst->inputs, &node_src->inputs);
941         for (sock_dst = node_dst->inputs.first, sock_src = node_src->inputs.first;
942              sock_dst != NULL;
943              sock_dst = sock_dst->next, sock_src = sock_src->next)
944         {
945                 node_socket_copy(sock_dst, sock_src, flag);
946         }
947
948         BLI_duplicatelist(&node_dst->outputs, &node_src->outputs);
949         for (sock_dst = node_dst->outputs.first, sock_src = node_src->outputs.first;
950              sock_dst != NULL;
951              sock_dst = sock_dst->next, sock_src = sock_src->next)
952         {
953                 node_socket_copy(sock_dst, sock_src, flag);
954         }
955
956         if (node_src->prop) {
957                 node_dst->prop = IDP_CopyProperty_ex(node_src->prop, flag);
958         }
959
960         BLI_duplicatelist(&node_dst->internal_links, &node_src->internal_links);
961         for (link_dst = node_dst->internal_links.first, link_src = node_src->internal_links.first;
962              link_dst != NULL;
963              link_dst = link_dst->next, link_src = link_src->next)
964         {
965                 link_dst->fromnode = node_dst;
966                 link_dst->tonode = node_dst;
967                 link_dst->fromsock = link_dst->fromsock->new_sock;
968                 link_dst->tosock = link_dst->tosock->new_sock;
969         }
970
971         if ((flag & LIB_ID_CREATE_NO_USER_REFCOUNT) == 0) {
972                 id_us_plus(node_dst->id);
973         }
974
975         if (node_src->typeinfo->copyfunc) {
976                 node_src->typeinfo->copyfunc(ntree, node_dst, node_src);
977         }
978
979         node_src->new_node = node_dst;
980         node_dst->new_node = NULL;
981
982         if (node_dst->typeinfo->copyfunc_api) {
983                 PointerRNA ptr;
984                 RNA_pointer_create((ID *)ntree, &RNA_Node, node_dst, &ptr);
985
986                 node_dst->typeinfo->copyfunc_api(&ptr, node_src);
987         }
988
989         if (ntree) {
990                 ntree->update |= NTREE_UPDATE_NODES;
991         }
992
993         return node_dst;
994 }
995
996 bNode *nodeCopyNode(bNodeTree *ntree, bNode *node)
997 {
998         return BKE_node_copy_ex(ntree, node, LIB_ID_CREATE_NO_USER_REFCOUNT);
999 }
1000
1001 /* also used via rna api, so we check for proper input output direction */
1002 bNodeLink *nodeAddLink(bNodeTree *ntree, bNode *fromnode, bNodeSocket *fromsock, bNode *tonode, bNodeSocket *tosock)
1003 {
1004         bNodeLink *link = NULL;
1005         
1006         /* test valid input */
1007         BLI_assert(fromnode);
1008         BLI_assert(tonode);
1009         
1010         if (fromsock->in_out == SOCK_OUT && tosock->in_out == SOCK_IN) {
1011                 link = MEM_callocN(sizeof(bNodeLink), "link");
1012                 if (ntree)
1013                         BLI_addtail(&ntree->links, link);
1014                 link->fromnode = fromnode;
1015                 link->fromsock = fromsock;
1016                 link->tonode = tonode;
1017                 link->tosock = tosock;
1018         }
1019         else if (fromsock->in_out == SOCK_IN && tosock->in_out == SOCK_OUT) {
1020                 /* OK but flip */
1021                 link = MEM_callocN(sizeof(bNodeLink), "link");
1022                 if (ntree)
1023                         BLI_addtail(&ntree->links, link);
1024                 link->fromnode = tonode;
1025                 link->fromsock = tosock;
1026                 link->tonode = fromnode;
1027                 link->tosock = fromsock;
1028         }
1029         
1030         if (ntree)
1031                 ntree->update |= NTREE_UPDATE_LINKS;
1032         
1033         return link;
1034 }
1035
1036 void nodeRemLink(bNodeTree *ntree, bNodeLink *link)
1037 {
1038         /* can be called for links outside a node tree (e.g. clipboard) */
1039         if (ntree)
1040                 BLI_remlink(&ntree->links, link);
1041
1042         if (link->tosock)
1043                 link->tosock->link = NULL;
1044         MEM_freeN(link);
1045         
1046         if (ntree)
1047                 ntree->update |= NTREE_UPDATE_LINKS;
1048 }
1049
1050 void nodeRemSocketLinks(bNodeTree *ntree, bNodeSocket *sock)
1051 {
1052         bNodeLink *link, *next;
1053         
1054         for (link = ntree->links.first; link; link = next) {
1055                 next = link->next;
1056                 if (link->fromsock == sock || link->tosock == sock) {
1057                         nodeRemLink(ntree, link);
1058                 }
1059         }
1060         
1061         ntree->update |= NTREE_UPDATE_LINKS;
1062 }
1063
1064 bool nodeLinkIsHidden(bNodeLink *link)
1065 {
1066         return nodeSocketIsHidden(link->fromsock) || nodeSocketIsHidden(link->tosock);
1067 }
1068
1069 void nodeInternalRelink(bNodeTree *ntree, bNode *node)
1070 {
1071         bNodeLink *link, *link_next;
1072         
1073         /* store link pointers in output sockets, for efficient lookup */
1074         for (link = node->internal_links.first; link; link = link->next)
1075                 link->tosock->link = link;
1076         
1077         /* redirect downstream links */
1078         for (link = ntree->links.first; link; link = link_next) {
1079                 link_next = link->next;
1080                 
1081                 /* do we have internal link? */
1082                 if (link->fromnode == node) {
1083                         if (link->fromsock->link) {
1084                                 /* get the upstream input link */
1085                                 bNodeLink *fromlink = link->fromsock->link->fromsock->link;
1086                                 /* skip the node */
1087                                 if (fromlink) {
1088                                         link->fromnode = fromlink->fromnode;
1089                                         link->fromsock = fromlink->fromsock;
1090                                         
1091                                         /* if the up- or downstream link is invalid,
1092                                          * the replacement link will be invalid too.
1093                                          */
1094                                         if (!(fromlink->flag & NODE_LINK_VALID))
1095                                                 link->flag &= ~NODE_LINK_VALID;
1096                                         
1097                                         ntree->update |= NTREE_UPDATE_LINKS;
1098                                 }
1099                                 else
1100                                         nodeRemLink(ntree, link);
1101                         }
1102                         else
1103                                 nodeRemLink(ntree, link);
1104                 }
1105         }
1106         
1107         /* remove remaining upstream links */
1108         for (link = ntree->links.first; link; link = link_next) {
1109                 link_next = link->next;
1110                 
1111                 if (link->tonode == node)
1112                         nodeRemLink(ntree, link);
1113         }
1114 }
1115
1116 void nodeToView(bNode *node, float x, float y, float *rx, float *ry)
1117 {
1118         if (node->parent) {
1119                 nodeToView(node->parent, x + node->locx, y + node->locy, rx, ry);
1120         }
1121         else {
1122                 *rx = x + node->locx;
1123                 *ry = y + node->locy;
1124         }
1125 }
1126
1127 void nodeFromView(bNode *node, float x, float y, float *rx, float *ry)
1128 {
1129         if (node->parent) {
1130                 nodeFromView(node->parent, x, y, rx, ry);
1131                 *rx -= node->locx;
1132                 *ry -= node->locy;
1133         }
1134         else {
1135                 *rx = x - node->locx;
1136                 *ry = y - node->locy;
1137         }
1138 }
1139
1140 bool nodeAttachNodeCheck(bNode *node, bNode *parent)
1141 {
1142         bNode *parent_recurse;
1143         for (parent_recurse = node; parent_recurse; parent_recurse = parent_recurse->parent) {
1144                 if (parent_recurse == parent) {
1145                         return true;
1146                 }
1147         }
1148
1149         return false;
1150 }
1151
1152 void nodeAttachNode(bNode *node, bNode *parent)
1153 {
1154         float locx, locy;
1155
1156         BLI_assert(parent->type == NODE_FRAME);
1157         BLI_assert(nodeAttachNodeCheck(parent, node) == false);
1158
1159         nodeToView(node, 0.0f, 0.0f, &locx, &locy);
1160         
1161         node->parent = parent;
1162         /* transform to parent space */
1163         nodeFromView(parent, locx, locy, &node->locx, &node->locy);
1164 }
1165
1166 void nodeDetachNode(struct bNode *node)
1167 {
1168         float locx, locy;
1169         
1170         if (node->parent) {
1171
1172                 BLI_assert(node->parent->type == NODE_FRAME);
1173
1174                 /* transform to view space */
1175                 nodeToView(node, 0.0f, 0.0f, &locx, &locy);
1176                 node->locx = locx;
1177                 node->locy = locy;
1178                 node->parent = NULL;
1179         }
1180 }
1181
1182 void ntreeInitDefault(bNodeTree *ntree)
1183 {
1184         ntree_set_typeinfo(ntree, NULL);
1185 }
1186
1187 bNodeTree *ntreeAddTree(Main *bmain, const char *name, const char *idname)
1188 {
1189         bNodeTree *ntree;
1190         
1191         /* trees are created as local trees for compositor, material or texture nodes,
1192          * node groups and other tree types are created as library data.
1193          */
1194         if (bmain) {
1195                 ntree = BKE_libblock_alloc(bmain, ID_NT, name, 0);
1196         }
1197         else {
1198                 ntree = MEM_callocN(sizeof(bNodeTree), "new node tree");
1199                 *( (short *)ntree->id.name ) = ID_NT;
1200                 BLI_strncpy(ntree->id.name + 2, name, sizeof(ntree->id.name));
1201         }
1202         
1203         /* Types are fully initialized at this point,
1204          * if an undefined node is added later this will be reset.
1205          */
1206         ntree->init |= NTREE_TYPE_INIT;
1207         
1208         BLI_strncpy(ntree->idname, idname, sizeof(ntree->idname));
1209         ntree_set_typeinfo(ntree, ntreeTypeFind(idname));
1210         
1211         return ntree;
1212 }
1213
1214 /**
1215  * Only copy internal data of NodeTree ID from source to already allocated/initialized destination.
1216  * You probably nerver want to use that directly, use id_copy or BKE_id_copy_ex for typical needs.
1217  *
1218  * WARNING! This function will not handle ID user count!
1219  *
1220  * \param flag  Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more).
1221  */
1222 void BKE_node_tree_copy_data(Main *UNUSED(bmain), bNodeTree *ntree_dst, const bNodeTree *ntree_src, const int flag)
1223 {
1224         bNodeSocket *sock_dst, *sock_src;
1225         bNodeLink *link_dst;
1226
1227         /* We never handle usercount here for own data. */
1228         const int flag_subdata = flag | LIB_ID_CREATE_NO_USER_REFCOUNT;
1229
1230         /* in case a running nodetree is copied */
1231         ntree_dst->execdata = NULL;
1232
1233         ntree_dst->duplilock = NULL;
1234
1235         BLI_listbase_clear(&ntree_dst->nodes);
1236         BLI_listbase_clear(&ntree_dst->links);
1237
1238         for (bNode *node_src = ntree_src->nodes.first; node_src; node_src = node_src->next) {
1239                 BKE_node_copy_ex(ntree_dst, node_src, flag_subdata);
1240         }
1241
1242         /* copy links */
1243         BLI_duplicatelist(&ntree_dst->links, &ntree_src->links);
1244         for (link_dst = ntree_dst->links.first; link_dst; link_dst = link_dst->next) {
1245                 link_dst->fromnode = (link_dst->fromnode ? link_dst->fromnode->new_node : NULL);
1246                 link_dst->fromsock = (link_dst->fromsock ? link_dst->fromsock->new_sock : NULL);
1247                 link_dst->tonode = (link_dst->tonode ? link_dst->tonode->new_node : NULL);
1248                 link_dst->tosock = (link_dst->tosock ? link_dst->tosock->new_sock : NULL);
1249                 /* update the link socket's pointer */
1250                 if (link_dst->tosock) {
1251                         link_dst->tosock->link = link_dst;
1252                 }
1253         }
1254
1255         /* copy interface sockets */
1256         BLI_duplicatelist(&ntree_dst->inputs, &ntree_src->inputs);
1257         for (sock_dst = ntree_dst->inputs.first, sock_src = ntree_src->inputs.first;
1258              sock_dst != NULL;
1259              sock_dst = sock_dst->next, sock_src = sock_src->next)
1260         {
1261                 node_socket_copy(sock_dst, sock_src, flag_subdata);
1262         }
1263
1264         BLI_duplicatelist(&ntree_dst->outputs, &ntree_src->outputs);
1265         for (sock_dst = ntree_dst->outputs.first, sock_src = ntree_src->outputs.first;
1266              sock_dst != NULL;
1267              sock_dst = sock_dst->next, sock_src = sock_src->next)
1268         {
1269                 node_socket_copy(sock_dst, sock_src, flag_subdata);
1270         }
1271
1272         /* copy preview hash */
1273         if (ntree_src->previews && (flag & LIB_ID_COPY_NO_PREVIEW) == 0) {
1274                 bNodeInstanceHashIterator iter;
1275
1276                 ntree_dst->previews = BKE_node_instance_hash_new("node previews");
1277
1278                 NODE_INSTANCE_HASH_ITER(iter, ntree_src->previews) {
1279                         bNodeInstanceKey key = BKE_node_instance_hash_iterator_get_key(&iter);
1280                         bNodePreview *preview = BKE_node_instance_hash_iterator_get_value(&iter);
1281                         BKE_node_instance_hash_insert(ntree_dst->previews, key, BKE_node_preview_copy(preview));
1282                 }
1283         }
1284         else {
1285                 ntree_dst->previews = NULL;
1286         }
1287
1288         /* update node->parent pointers */
1289         for (bNode *node_dst = ntree_dst->nodes.first, *node_src = ntree_src->nodes.first; node_dst; node_dst = node_dst->next, node_src = node_src->next) {
1290                 if (node_dst->parent) {
1291                         node_dst->parent = node_dst->parent->new_node;
1292                 }
1293         }
1294
1295         /* node tree will generate its own interface type */
1296         ntree_dst->interface_type = NULL;
1297 }
1298
1299 bNodeTree *ntreeCopyTree_ex(const bNodeTree *ntree, Main *bmain, const bool do_id_user)
1300 {
1301         bNodeTree *ntree_copy;
1302         BKE_id_copy_ex(bmain, (ID *)ntree, (ID **)&ntree_copy, do_id_user ? 0 : LIB_ID_CREATE_NO_USER_REFCOUNT, false);
1303         return ntree_copy;
1304 }
1305 bNodeTree *ntreeCopyTree(Main *bmain, const bNodeTree *ntree)
1306 {
1307         return ntreeCopyTree_ex(ntree, bmain, true);
1308 }
1309
1310 void ntreeUserIncrefID(bNodeTree *ntree)
1311 {
1312         bNode *node;
1313         for (node = ntree->nodes.first; node; node = node->next) {
1314                 id_us_plus(node->id);
1315         }
1316 }
1317 void ntreeUserDecrefID(bNodeTree *ntree)
1318 {
1319         bNode *node;
1320         for (node = ntree->nodes.first; node; node = node->next) {
1321                 id_us_min(node->id);
1322         }
1323 }
1324
1325 /* *************** Node Preview *********** */
1326
1327 /* XXX this should be removed eventually ...
1328  * Currently BKE functions are modeled closely on previous code,
1329  * using BKE_node_preview_init_tree to set up previews for a whole node tree in advance.
1330  * This should be left more to the individual node tree implementations.
1331  */
1332 int BKE_node_preview_used(bNode *node)
1333 {
1334         /* XXX check for closed nodes? */
1335         return (node->typeinfo->flag & NODE_PREVIEW) != 0;
1336 }
1337
1338 bNodePreview *BKE_node_preview_verify(bNodeInstanceHash *previews, bNodeInstanceKey key, int xsize, int ysize, bool create)
1339 {
1340         bNodePreview *preview;
1341         
1342         preview = BKE_node_instance_hash_lookup(previews, key);
1343         if (!preview) {
1344                 if (create) {
1345                         preview = MEM_callocN(sizeof(bNodePreview), "node preview");
1346                         BKE_node_instance_hash_insert(previews, key, preview);
1347                 }
1348                 else
1349                         return NULL;
1350         }
1351         
1352         /* node previews can get added with variable size this way */
1353         if (xsize == 0 || ysize == 0)
1354                 return preview;
1355         
1356         /* sanity checks & initialize */
1357         if (preview->rect) {
1358                 if (preview->xsize != xsize || preview->ysize != ysize) {
1359                         MEM_freeN(preview->rect);
1360                         preview->rect = NULL;
1361                 }
1362         }
1363         
1364         if (preview->rect == NULL) {
1365                 preview->rect = MEM_callocN(4 * xsize + xsize * ysize * sizeof(char) * 4, "node preview rect");
1366                 preview->xsize = xsize;
1367                 preview->ysize = ysize;
1368         }
1369         /* no clear, makes nicer previews */
1370         
1371         return preview;
1372 }
1373
1374 bNodePreview *BKE_node_preview_copy(bNodePreview *preview)
1375 {
1376         bNodePreview *new_preview = MEM_dupallocN(preview);
1377         if (preview->rect)
1378                 new_preview->rect = MEM_dupallocN(preview->rect);
1379         return new_preview;
1380 }
1381
1382 void BKE_node_preview_free(bNodePreview *preview)
1383 {
1384         if (preview->rect)
1385                 MEM_freeN(preview->rect);
1386         MEM_freeN(preview);
1387 }
1388
1389 static void node_preview_init_tree_recursive(bNodeInstanceHash *previews, bNodeTree *ntree, bNodeInstanceKey parent_key, int xsize, int ysize, int create)
1390 {
1391         bNode *node;
1392         for (node = ntree->nodes.first; node; node = node->next) {
1393                 bNodeInstanceKey key = BKE_node_instance_key(parent_key, ntree, node);
1394                 
1395                 if (BKE_node_preview_used(node)) {
1396                         node->preview_xsize = xsize;
1397                         node->preview_ysize = ysize;
1398                         
1399                         BKE_node_preview_verify(previews, key, xsize, ysize, create);
1400                 }
1401                 
1402                 if (node->type == NODE_GROUP && node->id)
1403                         node_preview_init_tree_recursive(previews, (bNodeTree *)node->id, key, xsize, ysize, create);
1404         }
1405 }
1406
1407 void BKE_node_preview_init_tree(bNodeTree *ntree, int xsize, int ysize, int create_previews)
1408 {
1409         if (!ntree)
1410                 return;
1411         
1412         if (!ntree->previews)
1413                 ntree->previews = BKE_node_instance_hash_new("node previews");
1414         
1415         node_preview_init_tree_recursive(ntree->previews, ntree, NODE_INSTANCE_KEY_BASE, xsize, ysize, create_previews);
1416 }
1417
1418 static void node_preview_tag_used_recursive(bNodeInstanceHash *previews, bNodeTree *ntree, bNodeInstanceKey parent_key)
1419 {
1420         bNode *node;
1421         for (node = ntree->nodes.first; node; node = node->next) {
1422                 bNodeInstanceKey key = BKE_node_instance_key(parent_key, ntree, node);
1423                 
1424                 if (BKE_node_preview_used(node))
1425                         BKE_node_instance_hash_tag_key(previews, key);
1426                 
1427                 if (node->type == NODE_GROUP && node->id)
1428                         node_preview_tag_used_recursive(previews, (bNodeTree *)node->id, key);
1429         }
1430 }
1431
1432 void BKE_node_preview_remove_unused(bNodeTree *ntree)
1433 {
1434         if (!ntree || !ntree->previews)
1435                 return;
1436         
1437         /* use the instance hash functions for tagging and removing unused previews */
1438         BKE_node_instance_hash_clear_tags(ntree->previews);
1439         node_preview_tag_used_recursive(ntree->previews, ntree, NODE_INSTANCE_KEY_BASE);
1440         
1441         BKE_node_instance_hash_remove_untagged(ntree->previews, (bNodeInstanceValueFP)BKE_node_preview_free);
1442 }
1443
1444 void BKE_node_preview_free_tree(bNodeTree *ntree)
1445 {
1446         if (!ntree)
1447                 return;
1448         
1449         if (ntree->previews) {
1450                 BKE_node_instance_hash_free(ntree->previews, (bNodeInstanceValueFP)BKE_node_preview_free);
1451                 ntree->previews = NULL;
1452         }
1453 }
1454
1455 void BKE_node_preview_clear(bNodePreview *preview)
1456 {
1457         if (preview && preview->rect)
1458                 memset(preview->rect, 0, MEM_allocN_len(preview->rect));
1459 }
1460
1461 void BKE_node_preview_clear_tree(bNodeTree *ntree)
1462 {
1463         bNodeInstanceHashIterator iter;
1464         
1465         if (!ntree || !ntree->previews)
1466                 return;
1467         
1468         NODE_INSTANCE_HASH_ITER(iter, ntree->previews) {
1469                 bNodePreview *preview = BKE_node_instance_hash_iterator_get_value(&iter);
1470                 BKE_node_preview_clear(preview);
1471         }
1472 }
1473
1474 static void node_preview_sync(bNodePreview *to, bNodePreview *from)
1475 {
1476         /* sizes should have been initialized by BKE_node_preview_init_tree */
1477         BLI_assert(to->xsize == from->xsize && to->ysize == from->ysize);
1478         
1479         /* copy over contents of previews */
1480         if (to->rect && from->rect) {
1481                 int xsize = to->xsize;
1482                 int ysize = to->ysize;
1483                 memcpy(to->rect, from->rect, xsize * ysize * sizeof(char) * 4);
1484         }
1485 }
1486
1487 void BKE_node_preview_sync_tree(bNodeTree *to_ntree, bNodeTree *from_ntree)
1488 {
1489         bNodeInstanceHash *from_previews = from_ntree->previews;
1490         bNodeInstanceHash *to_previews = to_ntree->previews;
1491         bNodeInstanceHashIterator iter;
1492         
1493         if (!from_previews || !to_previews)
1494                 return;
1495         
1496         NODE_INSTANCE_HASH_ITER(iter, from_previews) {
1497                 bNodeInstanceKey key = BKE_node_instance_hash_iterator_get_key(&iter);
1498                 bNodePreview *from = BKE_node_instance_hash_iterator_get_value(&iter);
1499                 bNodePreview *to = BKE_node_instance_hash_lookup(to_previews, key);
1500                 
1501                 if (from && to)
1502                         node_preview_sync(to, from);
1503         }
1504 }
1505
1506 void BKE_node_preview_merge_tree(bNodeTree *to_ntree, bNodeTree *from_ntree, bool remove_old)
1507 {
1508         if (remove_old || !to_ntree->previews) {
1509                 /* free old previews */
1510                 if (to_ntree->previews)
1511                         BKE_node_instance_hash_free(to_ntree->previews, (bNodeInstanceValueFP)BKE_node_preview_free);
1512                 
1513                 /* transfer previews */
1514                 to_ntree->previews = from_ntree->previews;
1515                 from_ntree->previews = NULL;
1516                 
1517                 /* clean up, in case any to_ntree nodes have been removed */
1518                 BKE_node_preview_remove_unused(to_ntree);
1519         }
1520         else {
1521                 bNodeInstanceHashIterator iter;
1522                 
1523                 if (from_ntree->previews) {
1524                         NODE_INSTANCE_HASH_ITER(iter, from_ntree->previews) {
1525                                 bNodeInstanceKey key = BKE_node_instance_hash_iterator_get_key(&iter);
1526                                 bNodePreview *preview = BKE_node_instance_hash_iterator_get_value(&iter);
1527                                 
1528                                 /* replace existing previews */
1529                                 BKE_node_instance_hash_remove(to_ntree->previews, key, (bNodeInstanceValueFP)BKE_node_preview_free);
1530                                 BKE_node_instance_hash_insert(to_ntree->previews, key, preview);
1531                         }
1532                         
1533                         /* Note: NULL free function here, because pointers have already been moved over to to_ntree->previews! */
1534                         BKE_node_instance_hash_free(from_ntree->previews, NULL);
1535                         from_ntree->previews = NULL;
1536                 }
1537         }
1538 }
1539
1540 /* hack warning! this function is only used for shader previews, and 
1541  * since it gets called multiple times per pixel for Ztransp we only
1542  * add the color once. Preview gets cleared before it starts render though */
1543 void BKE_node_preview_set_pixel(bNodePreview *preview, const float col[4], int x, int y, bool do_manage)
1544 {
1545         if (preview) {
1546                 if (x >= 0 && y >= 0) {
1547                         if (x < preview->xsize && y < preview->ysize) {
1548                                 unsigned char *tar = preview->rect + 4 * ((preview->xsize * y) + x);
1549                                 
1550                                 if (do_manage) {
1551                                         linearrgb_to_srgb_uchar4(tar, col);
1552                                 }
1553                                 else {
1554                                         rgba_float_to_uchar(tar, col);
1555                                 }
1556                         }
1557                         //else printf("prv out bound x y %d %d\n", x, y);
1558                 }
1559                 //else printf("prv out bound x y %d %d\n", x, y);
1560         }
1561 }
1562
1563 #if 0
1564 static void nodeClearPreview(bNode *node)
1565 {
1566         if (node->preview && node->preview->rect)
1567                 memset(node->preview->rect, 0, MEM_allocN_len(node->preview->rect));
1568 }
1569
1570 /* use it to enforce clear */
1571 void ntreeClearPreview(bNodeTree *ntree)
1572 {
1573         bNode *node;
1574         
1575         if (ntree == NULL)
1576                 return;
1577         
1578         for (node = ntree->nodes.first; node; node = node->next) {
1579                 if (node->typeinfo->flag & NODE_PREVIEW)
1580                         nodeClearPreview(node);
1581                 if (node->type == NODE_GROUP)
1582                         ntreeClearPreview((bNodeTree *)node->id);
1583         }
1584 }
1585
1586 /* hack warning! this function is only used for shader previews, and 
1587  * since it gets called multiple times per pixel for Ztransp we only
1588  * add the color once. Preview gets cleared before it starts render though */
1589 void nodeAddToPreview(bNode *node, const float col[4], int x, int y, int do_manage)
1590 {
1591         bNodePreview *preview = node->preview;
1592         if (preview) {
1593                 if (x >= 0 && y >= 0) {
1594                         if (x < preview->xsize && y < preview->ysize) {
1595                                 unsigned char *tar = preview->rect + 4 * ((preview->xsize * y) + x);
1596                                 
1597                                 if (do_manage) {
1598                                         linearrgb_to_srgb_uchar4(tar, col);
1599                                 }
1600                                 else {
1601                                         rgba_float_to_uchar(tar, col);
1602                                 }
1603                         }
1604                         //else printf("prv out bound x y %d %d\n", x, y);
1605                 }
1606                 //else printf("prv out bound x y %d %d\n", x, y);
1607         }
1608 }
1609 #endif
1610
1611 /* ************** Free stuff ********** */
1612
1613 /* goes over entire tree */
1614 void nodeUnlinkNode(bNodeTree *ntree, bNode *node)
1615 {
1616         bNodeLink *link, *next;
1617         bNodeSocket *sock;
1618         ListBase *lb;
1619         
1620         for (link = ntree->links.first; link; link = next) {
1621                 next = link->next;
1622                 
1623                 if (link->fromnode == node) {
1624                         lb = &node->outputs;
1625                         if (link->tonode)
1626                                 link->tonode->update |= NODE_UPDATE;
1627                 }
1628                 else if (link->tonode == node)
1629                         lb = &node->inputs;
1630                 else
1631                         lb = NULL;
1632
1633                 if (lb) {
1634                         for (sock = lb->first; sock; sock = sock->next) {
1635                                 if (link->fromsock == sock || link->tosock == sock)
1636                                         break;
1637                         }
1638                         if (sock) {
1639                                 nodeRemLink(ntree, link);
1640                         }
1641                 }
1642         }
1643 }
1644
1645 static void node_unlink_attached(bNodeTree *ntree, bNode *parent)
1646 {
1647         bNode *node;
1648         for (node = ntree->nodes.first; node; node = node->next) {
1649                 if (node->parent == parent)
1650                         nodeDetachNode(node);
1651         }
1652 }
1653
1654 /** \note caller needs to manage node->id user */
1655 static void node_free_node_ex(bNodeTree *ntree, bNode *node, bool remove_animdata, bool use_api_free_cb)
1656 {
1657         bNodeSocket *sock, *nextsock;
1658         
1659         /* don't remove node animdata if the tree is localized,
1660          * Action is shared with the original tree (T38221)
1661          */
1662         remove_animdata &= ntree && !(ntree->flag & NTREE_IS_LOCALIZED);
1663         
1664         /* extra free callback */
1665         if (use_api_free_cb && node->typeinfo->freefunc_api) {
1666                 PointerRNA ptr;
1667                 RNA_pointer_create((ID *)ntree, &RNA_Node, node, &ptr);
1668                 
1669                 node->typeinfo->freefunc_api(&ptr);
1670         }
1671         
1672         /* since it is called while free database, node->id is undefined */
1673         
1674         /* can be called for nodes outside a node tree (e.g. clipboard) */
1675         if (ntree) {
1676                 /* remove all references to this node */
1677                 nodeUnlinkNode(ntree, node);
1678                 node_unlink_attached(ntree, node);
1679                 
1680                 BLI_remlink(&ntree->nodes, node);
1681                 
1682                 if (remove_animdata) {
1683                         char propname_esc[MAX_IDPROP_NAME * 2];
1684                         char prefix[MAX_IDPROP_NAME * 2];
1685
1686                         BLI_strescape(propname_esc, node->name, sizeof(propname_esc));
1687                         BLI_snprintf(prefix, sizeof(prefix), "nodes[\"%s\"]", propname_esc);
1688
1689                         BKE_animdata_fix_paths_remove((ID *)ntree, prefix);
1690                 }
1691
1692                 if (ntree->typeinfo->free_node_cache)
1693                         ntree->typeinfo->free_node_cache(ntree, node);
1694                 
1695                 /* texture node has bad habit of keeping exec data around */
1696                 if (ntree->type == NTREE_TEXTURE && ntree->execdata) {
1697                         ntreeTexEndExecTree(ntree->execdata);
1698                         ntree->execdata = NULL;
1699                 }
1700         }
1701
1702         if (node->typeinfo->freefunc) {
1703                 node->typeinfo->freefunc(node);
1704         }
1705
1706         for (sock = node->inputs.first; sock; sock = nextsock) {
1707                 nextsock = sock->next;
1708                 node_socket_free(ntree, sock, node);
1709                 MEM_freeN(sock);
1710         }
1711         for (sock = node->outputs.first; sock; sock = nextsock) {
1712                 nextsock = sock->next;
1713                 node_socket_free(ntree, sock, node);
1714                 MEM_freeN(sock);
1715         }
1716
1717         BLI_freelistN(&node->internal_links);
1718
1719         if (node->prop) {
1720                 IDP_FreeProperty(node->prop);
1721                 MEM_freeN(node->prop);
1722         }
1723
1724         MEM_freeN(node);
1725         
1726         if (ntree)
1727                 ntree->update |= NTREE_UPDATE_NODES;
1728 }
1729
1730 void nodeFreeNode(bNodeTree *ntree, bNode *node)
1731 {
1732         node_free_node_ex(ntree, node, true, true);
1733 }
1734
1735 static void node_socket_interface_free(bNodeTree *UNUSED(ntree), bNodeSocket *sock)
1736 {
1737         if (sock->prop) {
1738                 IDP_FreeProperty(sock->prop);
1739                 MEM_freeN(sock->prop);
1740         }
1741         
1742         if (sock->default_value)
1743                 MEM_freeN(sock->default_value);
1744 }
1745
1746 static void free_localized_node_groups(bNodeTree *ntree)
1747 {
1748         bNode *node;
1749         
1750         /* Only localized node trees store a copy for each node group tree.
1751          * Each node group tree in a localized node tree can be freed,
1752          * since it is a localized copy itself (no risk of accessing free'd
1753          * data in main, see [#37939]).
1754          */
1755         if (!(ntree->flag & NTREE_IS_LOCALIZED))
1756                 return;
1757         
1758         for (node = ntree->nodes.first; node; node = node->next) {
1759                 if (node->type == NODE_GROUP && node->id) {
1760                         bNodeTree *ngroup = (bNodeTree *)node->id;
1761                         ntreeFreeTree(ngroup);
1762                         MEM_freeN(ngroup);
1763                 }
1764         }
1765 }
1766
1767 /** Free (or release) any data used by this nodetree (does not free the nodetree itself). */
1768 void ntreeFreeTree(bNodeTree *ntree)
1769 {
1770         bNodeTree *tntree;
1771         bNode *node, *next;
1772         bNodeSocket *sock, *nextsock;
1773
1774         BKE_animdata_free((ID *)ntree, false);
1775
1776         /* XXX hack! node trees should not store execution graphs at all.
1777          * This should be removed when old tree types no longer require it.
1778          * Currently the execution data for texture nodes remains in the tree
1779          * after execution, until the node tree is updated or freed.
1780          */
1781         if (ntree->execdata) {
1782                 switch (ntree->type) {
1783                         case NTREE_SHADER:
1784                                 ntreeShaderEndExecTree(ntree->execdata);
1785                                 break;
1786                         case NTREE_TEXTURE:
1787                                 ntreeTexEndExecTree(ntree->execdata);
1788                                 ntree->execdata = NULL;
1789                                 break;
1790                 }
1791         }
1792         
1793         /* XXX not nice, but needed to free localized node groups properly */
1794         free_localized_node_groups(ntree);
1795         
1796         /* unregister associated RNA types */
1797         ntreeInterfaceTypeFree(ntree);
1798         
1799         BLI_freelistN(&ntree->links);   /* do first, then unlink_node goes fast */
1800         
1801         for (node = ntree->nodes.first; node; node = next) {
1802                 next = node->next;
1803                 node_free_node_ex(ntree, node, false, false);
1804         }
1805
1806         /* free interface sockets */
1807         for (sock = ntree->inputs.first; sock; sock = nextsock) {
1808                 nextsock = sock->next;
1809                 node_socket_interface_free(ntree, sock);
1810                 MEM_freeN(sock);
1811         }
1812         for (sock = ntree->outputs.first; sock; sock = nextsock) {
1813                 nextsock = sock->next;
1814                 node_socket_interface_free(ntree, sock);
1815                 MEM_freeN(sock);
1816         }
1817         
1818         /* free preview hash */
1819         if (ntree->previews) {
1820                 BKE_node_instance_hash_free(ntree->previews, (bNodeInstanceValueFP)BKE_node_preview_free);
1821         }
1822
1823         if (ntree->duplilock)
1824                 BLI_mutex_free(ntree->duplilock);
1825         
1826         /* if ntree is not part of library, free the libblock data explicitly */
1827         for (tntree = G.main->nodetree.first; tntree; tntree = tntree->id.next)
1828                 if (tntree == ntree)
1829                         break;
1830         if (tntree == NULL) {
1831                 BKE_libblock_free_data(&ntree->id, true);
1832         }
1833 }
1834
1835 void ntreeFreeCache(bNodeTree *ntree)
1836 {
1837         if (ntree == NULL) return;
1838         
1839         if (ntree->typeinfo->free_cache)
1840                 ntree->typeinfo->free_cache(ntree);
1841 }
1842
1843 void ntreeSetOutput(bNodeTree *ntree)
1844 {
1845         bNode *node;
1846
1847         /* find the active outputs, might become tree type dependent handler */
1848         for (node = ntree->nodes.first; node; node = node->next) {
1849                 if (node->typeinfo->nclass == NODE_CLASS_OUTPUT) {
1850                         bNode *tnode;
1851                         int output = 0;
1852                         
1853                         /* we need a check for which output node should be tagged like this, below an exception */
1854                         if (node->type == CMP_NODE_OUTPUT_FILE)
1855                                 continue;
1856
1857                         /* there is more types having output class, each one is checked */
1858                         for (tnode = ntree->nodes.first; tnode; tnode = tnode->next) {
1859                                 if (tnode->typeinfo->nclass == NODE_CLASS_OUTPUT) {
1860                                         
1861                                         if (ntree->type == NTREE_COMPOSIT) {
1862                                                         
1863                                                 /* same type, exception for viewer */
1864                                                 if (tnode->type == node->type ||
1865                                                     (ELEM(tnode->type, CMP_NODE_VIEWER, CMP_NODE_SPLITVIEWER) &&
1866                                                      ELEM(node->type, CMP_NODE_VIEWER, CMP_NODE_SPLITVIEWER)))
1867                                                 {
1868                                                         if (tnode->flag & NODE_DO_OUTPUT) {
1869                                                                 output++;
1870                                                                 if (output > 1)
1871                                                                         tnode->flag &= ~NODE_DO_OUTPUT;
1872                                                         }
1873                                                 }
1874                                         }
1875                                         else {
1876                                                 /* same type */
1877                                                 if (tnode->type == node->type) {
1878                                                         if (tnode->flag & NODE_DO_OUTPUT) {
1879                                                                 output++;
1880                                                                 if (output > 1)
1881                                                                         tnode->flag &= ~NODE_DO_OUTPUT;
1882                                                         }
1883                                                 }
1884                                         }
1885                                 }
1886                         }
1887                         if (output == 0)
1888                                 node->flag |= NODE_DO_OUTPUT;
1889                 }
1890                 
1891                 /* group node outputs use this flag too */
1892                 if (node->type == NODE_GROUP_OUTPUT) {
1893                         bNode *tnode;
1894                         int output = 0;
1895                         
1896                         for (tnode = ntree->nodes.first; tnode; tnode = tnode->next) {
1897                                 if (tnode->type == NODE_GROUP_OUTPUT) {
1898                                         if (tnode->flag & NODE_DO_OUTPUT) {
1899                                                 output++;
1900                                                 if (output > 1)
1901                                                         tnode->flag &= ~NODE_DO_OUTPUT;
1902                                         }
1903                                 }
1904                         }
1905                         if (output == 0)
1906                                 node->flag |= NODE_DO_OUTPUT;
1907                 }
1908         }
1909         
1910         /* here we could recursively set which nodes have to be done,
1911          * might be different for editor or for "real" use... */
1912 }
1913
1914 bNodeTree *ntreeFromID(ID *id)
1915 {
1916         switch (GS(id->name)) {
1917                 case ID_MA:  return ((Material *)id)->nodetree;
1918                 case ID_LA:  return ((Lamp *)id)->nodetree;
1919                 case ID_WO:  return ((World *)id)->nodetree;
1920                 case ID_TE:  return ((Tex *)id)->nodetree;
1921                 case ID_SCE: return ((Scene *)id)->nodetree;
1922                 case ID_LS:  return ((FreestyleLineStyle *)id)->nodetree;
1923                 default: return NULL;
1924         }
1925 }
1926
1927 void ntreeMakeLocal(Main *bmain, bNodeTree *ntree, bool id_in_mainlist, const bool lib_local)
1928 {
1929         BKE_id_make_local_generic(bmain, &ntree->id, id_in_mainlist, lib_local);
1930 }
1931
1932 int ntreeNodeExists(bNodeTree *ntree, bNode *testnode)
1933 {
1934         bNode *node = ntree->nodes.first;
1935         for (; node; node = node->next)
1936                 if (node == testnode)
1937                         return 1;
1938         return 0;
1939 }
1940
1941 int ntreeOutputExists(bNode *node, bNodeSocket *testsock)
1942 {
1943         bNodeSocket *sock = node->outputs.first;
1944         for (; sock; sock = sock->next)
1945                 if (sock == testsock)
1946                         return 1;
1947         return 0;
1948 }
1949
1950 void ntreeNodeFlagSet(const bNodeTree *ntree, const int flag, const bool enable)
1951 {
1952         bNode *node = ntree->nodes.first;
1953
1954         for (; node; node = node->next) {
1955                 if (enable) {
1956                         node->flag |= flag;
1957                 }
1958                 else {
1959                         node->flag &= ~flag;
1960                 }
1961         }
1962 }
1963
1964 /* returns localized tree for execution in threads */
1965 bNodeTree *ntreeLocalize(bNodeTree *ntree)
1966 {
1967         if (ntree) {
1968                 bNodeTree *ltree;
1969                 bNode *node;
1970                 AnimData *adt;
1971
1972                 bAction *action_backup = NULL, *tmpact_backup = NULL;
1973
1974                 BLI_spin_lock(&spin);
1975                 if (!ntree->duplilock) {
1976                         ntree->duplilock = BLI_mutex_alloc();
1977                 }
1978                 BLI_spin_unlock(&spin);
1979
1980                 BLI_mutex_lock(ntree->duplilock);
1981
1982                 /* Workaround for copying an action on each render!
1983                  * set action to NULL so animdata actions don't get copied */
1984                 adt = BKE_animdata_from_id(&ntree->id);
1985
1986                 if (adt) {
1987                         action_backup = adt->action;
1988                         tmpact_backup = adt->tmpact;
1989
1990                         adt->action = NULL;
1991                         adt->tmpact = NULL;
1992                 }
1993
1994                 /* Make full copy outside of Main database.
1995                  * Note: previews are not copied here.
1996                  */
1997                 BKE_id_copy_ex(G.main, (ID *)ntree, (ID **)&ltree,
1998                                LIB_ID_CREATE_NO_MAIN | LIB_ID_CREATE_NO_USER_REFCOUNT | LIB_ID_COPY_NO_PREVIEW, false);
1999                 ltree->flag |= NTREE_IS_LOCALIZED;
2000
2001                 for (node = ltree->nodes.first; node; node = node->next) {
2002                         if (node->type == NODE_GROUP && node->id) {
2003                                 node->id = (ID *)ntreeLocalize((bNodeTree *)node->id);
2004                         }
2005                 }
2006
2007                 if (adt) {
2008                         AnimData *ladt = BKE_animdata_from_id(&ltree->id);
2009
2010                         adt->action = ladt->action = action_backup;
2011                         adt->tmpact = ladt->tmpact = tmpact_backup;
2012
2013                         if (action_backup)
2014                                 id_us_plus(&action_backup->id);
2015                         if (tmpact_backup)
2016                                 id_us_plus(&tmpact_backup->id);
2017
2018                 }
2019                 /* end animdata uglyness */
2020
2021                 /* ensures only a single output node is enabled */
2022                 ntreeSetOutput(ntree);
2023
2024                 for (node = ntree->nodes.first; node; node = node->next) {
2025                         /* store new_node pointer to original */
2026                         node->new_node->original = node;
2027                 }
2028
2029                 if (ntree->typeinfo->localize)
2030                         ntree->typeinfo->localize(ltree, ntree);
2031
2032                 BLI_mutex_unlock(ntree->duplilock);
2033
2034                 return ltree;
2035         }
2036         else
2037                 return NULL;
2038 }
2039
2040 /* sync local composite with real tree */
2041 /* local tree is supposed to be running, be careful moving previews! */
2042 /* is called by jobs manager, outside threads, so it doesnt happen during draw */
2043 void ntreeLocalSync(bNodeTree *localtree, bNodeTree *ntree)
2044 {
2045         if (localtree && ntree) {
2046                 if (ntree->typeinfo->local_sync)
2047                         ntree->typeinfo->local_sync(localtree, ntree);
2048         }
2049 }
2050
2051 /* merge local tree results back, and free local tree */
2052 /* we have to assume the editor already changed completely */
2053 void ntreeLocalMerge(bNodeTree *localtree, bNodeTree *ntree)
2054 {
2055         if (ntree && localtree) {
2056                 if (ntree->typeinfo->local_merge)
2057                         ntree->typeinfo->local_merge(localtree, ntree);
2058                 
2059                 ntreeFreeTree(localtree);
2060                 MEM_freeN(localtree);
2061         }
2062 }
2063
2064
2065 /* ************ NODE TREE INTERFACE *************** */
2066
2067 static bNodeSocket *make_socket_interface(bNodeTree *ntree, int in_out,
2068                                          const char *idname, const char *name)
2069 {
2070         bNodeSocketType *stype = nodeSocketTypeFind(idname);
2071         bNodeSocket *sock;
2072         int own_index = ntree->cur_index++;
2073
2074         if (stype == NULL) {
2075                 return NULL;
2076         }
2077
2078         sock = MEM_callocN(sizeof(bNodeSocket), "socket template");
2079         BLI_strncpy(sock->idname, stype->idname, sizeof(sock->idname));
2080         node_socket_set_typeinfo(ntree, sock, stype);
2081         sock->in_out = in_out;
2082         sock->type = SOCK_CUSTOM;       /* int type undefined by default */
2083         
2084         /* assign new unique index */
2085         own_index = ntree->cur_index++;
2086         /* use the own_index as socket identifier */
2087         if (in_out == SOCK_IN)
2088                 BLI_snprintf(sock->identifier, MAX_NAME, "Input_%d", own_index);
2089         else
2090                 BLI_snprintf(sock->identifier, MAX_NAME, "Output_%d", own_index);
2091 #ifdef USE_NODE_COMPAT_CUSTOMNODES
2092         /* XXX forward compatibility:
2093          * own_index is deprecated, but needs to be set here.
2094          * Node sockets generally use the identifier string instead now,
2095          * but reconstructing own_index in writefile.c would require parsing the identifier string.
2096          */
2097
2098 #if (defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 406)) || defined(__clang__)
2099 #  pragma GCC diagnostic push
2100 #  pragma GCC diagnostic ignored "-Wdeprecated-declarations"
2101 #endif
2102
2103         sock->own_index = own_index;
2104
2105 #if (defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 406)) || defined(__clang__)
2106 #  pragma GCC diagnostic pop
2107 #endif
2108
2109 #endif  /* USE_NODE_COMPAT_CUSTOMNODES */
2110         
2111         sock->limit = (in_out == SOCK_IN ? 1 : 0xFFF);
2112         
2113         BLI_strncpy(sock->name, name, NODE_MAXSTR);
2114         sock->storage = NULL;
2115         sock->flag |= SOCK_COLLAPSED;
2116         
2117         return sock;
2118 }
2119
2120 bNodeSocket *ntreeFindSocketInterface(bNodeTree *ntree, int in_out, const char *identifier)
2121 {
2122         bNodeSocket *iosock = (in_out == SOCK_IN ? ntree->inputs.first : ntree->outputs.first);
2123         for (; iosock; iosock = iosock->next)
2124                 if (STREQ(iosock->identifier, identifier))
2125                         return iosock;
2126         return NULL;
2127 }
2128
2129 bNodeSocket *ntreeAddSocketInterface(bNodeTree *ntree, int in_out, const char *idname, const char *name)
2130 {
2131         bNodeSocket *iosock;
2132         
2133         iosock = make_socket_interface(ntree, in_out, idname, name);
2134         if (in_out == SOCK_IN) {
2135                 BLI_addtail(&ntree->inputs, iosock);
2136                 ntree->update |= NTREE_UPDATE_GROUP_IN;
2137         }
2138         else if (in_out == SOCK_OUT) {
2139                 BLI_addtail(&ntree->outputs, iosock);
2140                 ntree->update |= NTREE_UPDATE_GROUP_OUT;
2141         }
2142         
2143         return iosock;
2144 }
2145
2146 bNodeSocket *ntreeInsertSocketInterface(bNodeTree *ntree, int in_out, const char *idname,
2147                                bNodeSocket *next_sock, const char *name)
2148 {
2149         bNodeSocket *iosock;
2150         
2151         iosock = make_socket_interface(ntree, in_out, idname, name);
2152         if (in_out == SOCK_IN) {
2153                 BLI_insertlinkbefore(&ntree->inputs, next_sock, iosock);
2154                 ntree->update |= NTREE_UPDATE_GROUP_IN;
2155         }
2156         else if (in_out == SOCK_OUT) {
2157                 BLI_insertlinkbefore(&ntree->outputs, next_sock, iosock);
2158                 ntree->update |= NTREE_UPDATE_GROUP_OUT;
2159         }
2160         
2161         return iosock;
2162 }
2163
2164 struct bNodeSocket *ntreeAddSocketInterfaceFromSocket(bNodeTree *ntree, bNode *from_node, bNodeSocket *from_sock)
2165 {
2166         bNodeSocket *iosock = ntreeAddSocketInterface(ntree, from_sock->in_out, from_sock->idname, from_sock->name);
2167         if (iosock) {
2168                 if (iosock->typeinfo->interface_from_socket)
2169                         iosock->typeinfo->interface_from_socket(ntree, iosock, from_node, from_sock);
2170         }
2171         return iosock;
2172 }
2173
2174 struct bNodeSocket *ntreeInsertSocketInterfaceFromSocket(bNodeTree *ntree, bNodeSocket *next_sock, bNode *from_node, bNodeSocket *from_sock)
2175 {
2176         bNodeSocket *iosock = ntreeInsertSocketInterface(ntree, from_sock->in_out, from_sock->idname, next_sock, from_sock->name);
2177         if (iosock) {
2178                 if (iosock->typeinfo->interface_from_socket)
2179                         iosock->typeinfo->interface_from_socket(ntree, iosock, from_node, from_sock);
2180         }
2181         return iosock;
2182 }
2183
2184 void ntreeRemoveSocketInterface(bNodeTree *ntree, bNodeSocket *sock)
2185 {
2186         /* this is fast, this way we don't need an in_out argument */
2187         BLI_remlink(&ntree->inputs, sock);
2188         BLI_remlink(&ntree->outputs, sock);
2189         
2190         node_socket_interface_free(ntree, sock);
2191         MEM_freeN(sock);
2192         
2193         ntree->update |= NTREE_UPDATE_GROUP;
2194 }
2195
2196 /* generates a valid RNA identifier from the node tree name */
2197 static void ntree_interface_identifier_base(bNodeTree *ntree, char *base)
2198 {
2199         /* generate a valid RNA identifier */
2200         sprintf(base, "NodeTreeInterface_%s", ntree->id.name + 2);
2201         RNA_identifier_sanitize(base, false);
2202 }
2203
2204 /* check if the identifier is already in use */
2205 static bool ntree_interface_unique_identifier_check(void *UNUSED(data), const char *identifier)
2206 {
2207         return (RNA_struct_find(identifier) != NULL);
2208 }
2209
2210 /* generates the actual unique identifier and ui name and description */
2211 static void ntree_interface_identifier(bNodeTree *ntree, const char *base, char *identifier, int maxlen, char *name, char *description)
2212 {
2213         /* There is a possibility that different node tree names get mapped to the same identifier
2214          * after sanitization (e.g. "SomeGroup_A", "SomeGroup.A" both get sanitized to "SomeGroup_A").
2215          * On top of the sanitized id string add a number suffix if necessary to avoid duplicates.
2216          */
2217         identifier[0] = '\0';
2218         BLI_uniquename_cb(ntree_interface_unique_identifier_check, NULL, base, '_', identifier, maxlen);
2219         
2220         sprintf(name, "Node Tree %s Interface", ntree->id.name + 2);
2221         sprintf(description, "Interface properties of node group %s", ntree->id.name + 2);
2222 }
2223
2224 static void ntree_interface_type_create(bNodeTree *ntree)
2225 {
2226         StructRNA *srna;
2227         bNodeSocket *sock;
2228         /* strings are generated from base string + ID name, sizes are sufficient */
2229         char base[MAX_ID_NAME + 64], identifier[MAX_ID_NAME + 64], name[MAX_ID_NAME + 64], description[MAX_ID_NAME + 64];
2230         
2231         /* generate a valid RNA identifier */
2232         ntree_interface_identifier_base(ntree, base);
2233         ntree_interface_identifier(ntree, base, identifier, sizeof(identifier), name, description);
2234         
2235         /* register a subtype of PropertyGroup */
2236         srna = RNA_def_struct_ptr(&BLENDER_RNA, identifier, &RNA_PropertyGroup);
2237         RNA_def_struct_ui_text(srna, name, description);
2238         RNA_def_struct_duplicate_pointers(&BLENDER_RNA, srna);
2239         
2240         /* associate the RNA type with the node tree */
2241         ntree->interface_type = srna;
2242         RNA_struct_blender_type_set(srna, ntree);
2243         
2244         /* add socket properties */
2245         for (sock = ntree->inputs.first; sock; sock = sock->next) {
2246                 bNodeSocketType *stype = sock->typeinfo;
2247                 if (stype && stype->interface_register_properties)
2248                         stype->interface_register_properties(ntree, sock, srna);
2249         }
2250         for (sock = ntree->outputs.first; sock; sock = sock->next) {
2251                 bNodeSocketType *stype = sock->typeinfo;
2252                 if (stype && stype->interface_register_properties)
2253                         stype->interface_register_properties(ntree, sock, srna);
2254         }
2255 }
2256
2257 StructRNA *ntreeInterfaceTypeGet(bNodeTree *ntree, int create)
2258 {
2259         if (ntree->interface_type) {
2260                 /* strings are generated from base string + ID name, sizes are sufficient */
2261                 char base[MAX_ID_NAME + 64], identifier[MAX_ID_NAME + 64], name[MAX_ID_NAME + 64], description[MAX_ID_NAME + 64];
2262                 
2263                 /* A bit of a hack: when changing the ID name, update the RNA type identifier too,
2264                  * so that the names match. This is not strictly necessary to keep it working,
2265                  * but better for identifying associated NodeTree blocks and RNA types.
2266                  */
2267                 StructRNA *srna = ntree->interface_type;
2268                 
2269                 ntree_interface_identifier_base(ntree, base);
2270                 
2271                 /* RNA identifier may have a number suffix, but should start with the idbase string */
2272                 if (!STREQLEN(RNA_struct_identifier(srna), base, sizeof(base))) {
2273                         /* generate new unique RNA identifier from the ID name */
2274                         ntree_interface_identifier(ntree, base, identifier, sizeof(identifier), name, description);
2275                         
2276                         /* rename the RNA type */
2277                         RNA_def_struct_free_pointers(&BLENDER_RNA, srna);
2278                         RNA_def_struct_identifier(&BLENDER_RNA, srna, identifier);
2279                         RNA_def_struct_ui_text(srna, name, description);
2280                         RNA_def_struct_duplicate_pointers(&BLENDER_RNA, srna);
2281                 }
2282         }
2283         else if (create) {
2284                 ntree_interface_type_create(ntree);
2285         }
2286         
2287         return ntree->interface_type;
2288 }
2289
2290 void ntreeInterfaceTypeFree(bNodeTree *ntree)
2291 {
2292         if (ntree->interface_type) {
2293                 RNA_struct_free(&BLENDER_RNA, ntree->interface_type);
2294                 ntree->interface_type = NULL;
2295         }
2296 }
2297
2298 void ntreeInterfaceTypeUpdate(bNodeTree *ntree)
2299 {
2300         /* XXX it would be sufficient to just recreate all properties
2301          * instead of re-registering the whole struct type,
2302          * but there is currently no good way to do this in the RNA functions.
2303          * Overhead should be negligible.
2304          */
2305         ntreeInterfaceTypeFree(ntree);
2306         ntree_interface_type_create(ntree);
2307 }
2308
2309
2310 /* ************ find stuff *************** */
2311
2312 bNode *ntreeFindType(const bNodeTree *ntree, int type)
2313 {
2314         if (ntree) {
2315                 for (bNode * node = ntree->nodes.first; node; node = node->next) {
2316                         if (node->type == type) {
2317                                 return node;
2318                         }
2319                 }
2320         }
2321         return NULL;
2322 }
2323
2324 bool ntreeHasType(const bNodeTree *ntree, int type)
2325 {
2326         return ntreeFindType(ntree, type) != NULL;
2327 }
2328
2329 bool ntreeHasTree(const bNodeTree *ntree, const bNodeTree *lookup)
2330 {
2331         bNode *node;
2332
2333         if (ntree == lookup)
2334                 return true;
2335
2336         for (node = ntree->nodes.first; node; node = node->next)
2337                 if (node->type == NODE_GROUP && node->id)
2338                         if (ntreeHasTree((bNodeTree *)node->id, lookup))
2339                                 return true;
2340
2341         return false;
2342 }
2343
2344 bNodeLink *nodeFindLink(bNodeTree *ntree, bNodeSocket *from, bNodeSocket *to)
2345 {
2346         bNodeLink *link;
2347         
2348         for (link = ntree->links.first; link; link = link->next) {
2349                 if (link->fromsock == from && link->tosock == to)
2350                         return link;
2351                 if (link->fromsock == to && link->tosock == from) /* hrms? */
2352                         return link;
2353         }
2354         return NULL;
2355 }
2356
2357 int nodeCountSocketLinks(bNodeTree *ntree, bNodeSocket *sock)
2358 {
2359         bNodeLink *link;
2360         int tot = 0;
2361         
2362         for (link = ntree->links.first; link; link = link->next) {
2363                 if (link->fromsock == sock || link->tosock == sock)
2364                         tot++;
2365         }
2366         return tot;
2367 }
2368
2369 bNode *nodeGetActive(bNodeTree *ntree)
2370 {
2371         bNode *node;
2372         
2373         if (ntree == NULL) return NULL;
2374         
2375         for (node = ntree->nodes.first; node; node = node->next)
2376                 if (node->flag & NODE_ACTIVE)
2377                         break;
2378         return node;
2379 }
2380
2381 static bNode *node_get_active_id_recursive(bNodeInstanceKey active_key, bNodeInstanceKey parent_key, bNodeTree *ntree, short idtype)
2382 {
2383         if (parent_key.value == active_key.value || active_key.value == 0) {
2384                 bNode *node;
2385                 for (node = ntree->nodes.first; node; node = node->next)
2386                         if (node->id && GS(node->id->name) == idtype)
2387                                 if (node->flag & NODE_ACTIVE_ID)
2388                                         return node;
2389         }
2390         else {
2391                 bNode *node, *tnode;
2392                 /* no node with active ID in this tree, look inside groups */
2393                 for (node = ntree->nodes.first; node; node = node->next) {
2394                         if (node->type == NODE_GROUP) {
2395                                 bNodeTree *group = (bNodeTree *)node->id;
2396                                 if (group) {
2397                                         bNodeInstanceKey group_key = BKE_node_instance_key(parent_key, ntree, node);
2398                                         tnode = node_get_active_id_recursive(active_key, group_key, group, idtype);
2399                                         if (tnode)
2400                                                 return tnode;
2401                                 }
2402                         }
2403                 }
2404         }
2405         
2406         return NULL;
2407 }
2408
2409 /* two active flags, ID nodes have special flag for buttons display */
2410 bNode *nodeGetActiveID(bNodeTree *ntree, short idtype)
2411 {
2412         if (ntree)
2413                 return node_get_active_id_recursive(ntree->active_viewer_key, NODE_INSTANCE_KEY_BASE, ntree, idtype);
2414         else
2415                 return NULL;
2416 }
2417
2418 bool nodeSetActiveID(bNodeTree *ntree, short idtype, ID *id)
2419 {
2420         bNode *node;
2421         bool ok = false;
2422
2423         if (ntree == NULL) return ok;
2424
2425         for (node = ntree->nodes.first; node; node = node->next) {
2426                 if (node->id && GS(node->id->name) == idtype) {
2427                         if (id && ok == false && node->id == id) {
2428                                 node->flag |= NODE_ACTIVE_ID;
2429                                 ok = true;
2430                         }
2431                         else {
2432                                 node->flag &= ~NODE_ACTIVE_ID;
2433                         }
2434                 }
2435         }
2436
2437         /* update all groups linked from here
2438          * if active ID node has been found already,
2439          * just pass NULL so other matching nodes are deactivated.
2440          */
2441         for (node = ntree->nodes.first; node; node = node->next) {
2442                 if (node->type == NODE_GROUP)
2443                         ok |= nodeSetActiveID((bNodeTree *)node->id, idtype, (ok == false ? id : NULL));
2444         }
2445
2446         return ok;
2447 }
2448
2449
2450 /* two active flags, ID nodes have special flag for buttons display */
2451 void nodeClearActiveID(bNodeTree *ntree, short idtype)
2452 {
2453         bNode *node;
2454         
2455         if (ntree == NULL) return;
2456         
2457         for (node = ntree->nodes.first; node; node = node->next)
2458                 if (node->id && GS(node->id->name) == idtype)
2459                         node->flag &= ~NODE_ACTIVE_ID;
2460 }
2461
2462 void nodeSetSelected(bNode *node, bool select)
2463 {
2464         if (select) {
2465                 node->flag |= NODE_SELECT;
2466         }
2467         else {
2468                 bNodeSocket *sock;
2469                 
2470                 node->flag &= ~NODE_SELECT;
2471                 
2472                 /* deselect sockets too */
2473                 for (sock = node->inputs.first; sock; sock = sock->next)
2474                         sock->flag &= ~NODE_SELECT;
2475                 for (sock = node->outputs.first; sock; sock = sock->next)
2476                         sock->flag &= ~NODE_SELECT;
2477         }
2478 }
2479
2480 void nodeClearActive(bNodeTree *ntree)
2481 {
2482         bNode *node;
2483
2484         if (ntree == NULL) return;
2485
2486         for (node = ntree->nodes.first; node; node = node->next)
2487                 node->flag &= ~(NODE_ACTIVE | NODE_ACTIVE_ID);
2488 }
2489
2490 /* two active flags, ID nodes have special flag for buttons display */
2491 void nodeSetActive(bNodeTree *ntree, bNode *node)
2492 {
2493         bNode *tnode;
2494         
2495         /* make sure only one node is active, and only one per ID type */
2496         for (tnode = ntree->nodes.first; tnode; tnode = tnode->next) {
2497                 tnode->flag &= ~NODE_ACTIVE;
2498                 
2499                 if (node->id && tnode->id) {
2500                         if (GS(node->id->name) == GS(tnode->id->name))
2501                                 tnode->flag &= ~NODE_ACTIVE_ID;
2502                 }
2503                 if (node->typeinfo->nclass == NODE_CLASS_TEXTURE)
2504                         tnode->flag &= ~NODE_ACTIVE_TEXTURE;
2505         }
2506         
2507         node->flag |= NODE_ACTIVE;
2508         if (node->id)
2509                 node->flag |= NODE_ACTIVE_ID;
2510         if (node->typeinfo->nclass == NODE_CLASS_TEXTURE)
2511                 node->flag |= NODE_ACTIVE_TEXTURE;
2512 }
2513
2514 int nodeSocketIsHidden(bNodeSocket *sock)
2515 {
2516         return ((sock->flag & (SOCK_HIDDEN | SOCK_UNAVAIL)) != 0);
2517 }
2518
2519 /* ************** Node Clipboard *********** */
2520
2521 #define USE_NODE_CB_VALIDATE
2522
2523 #ifdef USE_NODE_CB_VALIDATE
2524 /**
2525  * This data structure is to validate the node on creation,
2526  * otherwise we may reference missing data.
2527  *
2528  * Currently its only used for ID's, but nodes may one day
2529  * reference other pointers which need validation.
2530  */
2531 typedef struct bNodeClipboardExtraInfo {
2532         struct bNodeClipboardExtraInfo *next, *prev;
2533         ID  *id;
2534         char id_name[MAX_ID_NAME];
2535         char library_name[FILE_MAX];
2536 } bNodeClipboardExtraInfo;
2537 #endif  /* USE_NODE_CB_VALIDATE */
2538
2539
2540 typedef struct bNodeClipboard {
2541         ListBase nodes;
2542
2543 #ifdef USE_NODE_CB_VALIDATE
2544         ListBase nodes_extra_info;
2545 #endif
2546
2547         ListBase links;
2548         int type;
2549 } bNodeClipboard;
2550
2551 static bNodeClipboard node_clipboard = {{NULL}};
2552
2553 void BKE_node_clipboard_init(struct bNodeTree *ntree)
2554 {
2555         node_clipboard.type = ntree->type;
2556 }
2557
2558 void BKE_node_clipboard_clear(void)
2559 {
2560         bNode *node, *node_next;
2561         bNodeLink *link, *link_next;
2562         
2563         for (link = node_clipboard.links.first; link; link = link_next) {
2564                 link_next = link->next;
2565                 nodeRemLink(NULL, link);
2566         }
2567         BLI_listbase_clear(&node_clipboard.links);
2568         
2569         for (node = node_clipboard.nodes.first; node; node = node_next) {
2570                 node_next = node->next;
2571                 node_free_node_ex(NULL, node, false, false);
2572         }
2573         BLI_listbase_clear(&node_clipboard.nodes);
2574
2575 #ifdef USE_NODE_CB_VALIDATE
2576         BLI_freelistN(&node_clipboard.nodes_extra_info);
2577 #endif
2578 }
2579
2580 /* return false when one or more ID's are lost */
2581 bool BKE_node_clipboard_validate(void)
2582 {
2583         bool ok = true;
2584
2585 #ifdef USE_NODE_CB_VALIDATE
2586         bNodeClipboardExtraInfo *node_info;
2587         bNode *node;
2588
2589
2590         /* lists must be aligned */
2591         BLI_assert(BLI_listbase_count(&node_clipboard.nodes) ==
2592                    BLI_listbase_count(&node_clipboard.nodes_extra_info));
2593
2594         for (node = node_clipboard.nodes.first, node_info = node_clipboard.nodes_extra_info.first;
2595              node;
2596              node = node->next, node_info = node_info->next)
2597         {
2598                 /* validate the node against the stored node info */
2599
2600                 /* re-assign each loop since we may clear,
2601                  * open a new file where the ID is valid, and paste again */
2602                 node->id = node_info->id;
2603
2604                 /* currently only validate the ID */
2605                 if (node->id) {
2606                         ListBase *lb = which_libbase(G.main, GS(node_info->id_name));
2607                         BLI_assert(lb != NULL);
2608
2609                         if (BLI_findindex(lb, node_info->id) == -1) {
2610                                 /* may assign NULL */
2611                                 node->id = BLI_findstring(lb, node_info->id_name + 2, offsetof(ID, name) + 2);
2612
2613                                 if (node->id == NULL) {
2614                                         ok = false;
2615                                 }
2616                         }
2617                 }
2618         }
2619 #endif  /* USE_NODE_CB_VALIDATE */
2620
2621         return ok;
2622 }
2623
2624 void BKE_node_clipboard_add_node(bNode *node)
2625 {
2626 #ifdef USE_NODE_CB_VALIDATE
2627         /* add extra info */
2628         bNodeClipboardExtraInfo *node_info = MEM_mallocN(sizeof(bNodeClipboardExtraInfo), "bNodeClipboardExtraInfo");
2629
2630         node_info->id = node->id;
2631         if (node->id) {
2632                 BLI_strncpy(node_info->id_name, node->id->name, sizeof(node_info->id_name));
2633                 if (ID_IS_LINKED(node->id)) {
2634                         BLI_strncpy(node_info->library_name, node->id->lib->filepath, sizeof(node_info->library_name));
2635                 }
2636                 else {
2637                         node_info->library_name[0] = '\0';
2638                 }
2639         }
2640         else {
2641                 node_info->id_name[0] = '\0';
2642                 node_info->library_name[0] = '\0';
2643         }
2644         BLI_addtail(&node_clipboard.nodes_extra_info, node_info);
2645         /* end extra info */
2646 #endif  /* USE_NODE_CB_VALIDATE */
2647
2648         /* add node */
2649         BLI_addtail(&node_clipboard.nodes, node);
2650
2651 }
2652
2653 void BKE_node_clipboard_add_link(bNodeLink *link)
2654 {
2655         BLI_addtail(&node_clipboard.links, link);
2656 }
2657
2658 const ListBase *BKE_node_clipboard_get_nodes(void)
2659 {
2660         return &node_clipboard.nodes;
2661 }
2662
2663 const ListBase *BKE_node_clipboard_get_links(void)
2664 {
2665         return &node_clipboard.links;
2666 }
2667
2668 int BKE_node_clipboard_get_type(void)
2669 {
2670         return node_clipboard.type;
2671 }
2672
2673
2674 /* Node Instance Hash */
2675
2676 /* magic number for initial hash key */
2677 const bNodeInstanceKey NODE_INSTANCE_KEY_BASE = {5381};
2678 const bNodeInstanceKey NODE_INSTANCE_KEY_NONE = {0};
2679
2680 /* Generate a hash key from ntree and node names
2681  * Uses the djb2 algorithm with xor by Bernstein:
2682  * http://www.cse.yorku.ca/~oz/hash.html
2683  */
2684 static bNodeInstanceKey node_hash_int_str(bNodeInstanceKey hash, const char *str)
2685 {
2686         char c;
2687         
2688         while ((c = *str++))
2689                 hash.value = ((hash.value << 5) + hash.value) ^ c; /* (hash * 33) ^ c */
2690         
2691         /* separator '\0' character, to avoid ambiguity from concatenated strings */
2692         hash.value = (hash.value << 5) + hash.value; /* hash * 33 */
2693         
2694         return hash;
2695 }
2696
2697 bNodeInstanceKey BKE_node_instance_key(bNodeInstanceKey parent_key, bNodeTree *ntree, bNode *node)
2698 {
2699         bNodeInstanceKey key;
2700         
2701         key = node_hash_int_str(parent_key, ntree->id.name + 2);
2702         
2703         if (node)
2704                 key = node_hash_int_str(key, node->name);
2705         
2706         return key;
2707 }
2708
2709 static unsigned int node_instance_hash_key(const void *key)
2710 {
2711         return ((const bNodeInstanceKey *)key)->value;
2712 }
2713
2714 static bool node_instance_hash_key_cmp(const void *a, const void *b)
2715 {
2716         unsigned int value_a = ((const bNodeInstanceKey *)a)->value;
2717         unsigned int value_b = ((const bNodeInstanceKey *)b)->value;
2718
2719         return (value_a != value_b);
2720 }
2721
2722 bNodeInstanceHash *BKE_node_instance_hash_new(const char *info)
2723 {
2724         bNodeInstanceHash *hash = MEM_mallocN(sizeof(bNodeInstanceHash), info);
2725         hash->ghash = BLI_ghash_new(node_instance_hash_key, node_instance_hash_key_cmp, "node instance hash ghash");
2726         return hash;
2727 }
2728
2729 void BKE_node_instance_hash_free(bNodeInstanceHash *hash, bNodeInstanceValueFP valfreefp)
2730 {
2731         BLI_ghash_free(hash->ghash, NULL, (GHashValFreeFP)valfreefp);
2732         MEM_freeN(hash);
2733 }
2734
2735 void BKE_node_instance_hash_insert(bNodeInstanceHash *hash, bNodeInstanceKey key, void *value)
2736 {
2737         bNodeInstanceHashEntry *entry = value;
2738         entry->key = key;
2739         entry->tag = 0;
2740         BLI_ghash_insert(hash->ghash, &entry->key, value);
2741 }
2742
2743 void *BKE_node_instance_hash_lookup(bNodeInstanceHash *hash, bNodeInstanceKey key)
2744 {
2745         return BLI_ghash_lookup(hash->ghash, &key);
2746 }
2747
2748 int BKE_node_instance_hash_remove(bNodeInstanceHash *hash, bNodeInstanceKey key, bNodeInstanceValueFP valfreefp)
2749 {
2750         return BLI_ghash_remove(hash->ghash, &key, NULL, (GHashValFreeFP)valfreefp);
2751 }
2752
2753 void BKE_node_instance_hash_clear(bNodeInstanceHash *hash, bNodeInstanceValueFP valfreefp)
2754 {
2755         BLI_ghash_clear(hash->ghash, NULL, (GHashValFreeFP)valfreefp);
2756 }
2757
2758 void *BKE_node_instance_hash_pop(bNodeInstanceHash *hash, bNodeInstanceKey key)
2759 {
2760         return BLI_ghash_popkey(hash->ghash, &key, NULL);
2761 }
2762
2763 int BKE_node_instance_hash_haskey(bNodeInstanceHash *hash, bNodeInstanceKey key)
2764 {
2765         return BLI_ghash_haskey(hash->ghash, &key);
2766 }
2767
2768 int BKE_node_instance_hash_size(bNodeInstanceHash *hash)
2769 {
2770         return BLI_ghash_size(hash->ghash);
2771 }
2772
2773 void BKE_node_instance_hash_clear_tags(bNodeInstanceHash *hash)
2774 {
2775         bNodeInstanceHashIterator iter;
2776         
2777         NODE_INSTANCE_HASH_ITER(iter, hash) {
2778                 bNodeInstanceHashEntry *value = BKE_node_instance_hash_iterator_get_value(&iter);
2779                 
2780                 value->tag = 0;
2781         }
2782 }
2783
2784 void BKE_node_instance_hash_tag(bNodeInstanceHash *UNUSED(hash), void *value)
2785 {
2786         bNodeInstanceHashEntry *entry = value;
2787         entry->tag = 1;
2788 }
2789
2790 bool BKE_node_instance_hash_tag_key(bNodeInstanceHash *hash, bNodeInstanceKey key)
2791 {
2792         bNodeInstanceHashEntry *entry = BKE_node_instance_hash_lookup(hash, key);
2793         
2794         if (entry) {
2795                 entry->tag = 1;
2796                 return true;
2797         }
2798         else
2799                 return false;
2800 }
2801
2802 void BKE_node_instance_hash_remove_untagged(bNodeInstanceHash *hash, bNodeInstanceValueFP valfreefp)
2803 {
2804         /* NOTE: Hash must not be mutated during iterating!
2805          * Store tagged entries in a separate list and remove items afterward.
2806          */
2807         bNodeInstanceKey *untagged = MEM_mallocN(sizeof(bNodeInstanceKey) * BKE_node_instance_hash_size(hash), "temporary node instance key list");
2808         bNodeInstanceHashIterator iter;
2809         int num_untagged, i;
2810         
2811         num_untagged = 0;
2812         NODE_INSTANCE_HASH_ITER(iter, hash) {
2813                 bNodeInstanceHashEntry *value = BKE_node_instance_hash_iterator_get_value(&iter);
2814                 
2815                 if (!value->tag)
2816                         untagged[num_untagged++] = BKE_node_instance_hash_iterator_get_key(&iter);
2817         }
2818         
2819         for (i = 0; i < num_untagged; ++i) {
2820                 BKE_node_instance_hash_remove(hash, untagged[i], valfreefp);
2821         }
2822         
2823         MEM_freeN(untagged);
2824 }
2825
2826
2827 /* ************** dependency stuff *********** */
2828
2829 /* node is guaranteed to be not checked before */
2830 static int node_get_deplist_recurs(bNodeTree *ntree, bNode *node, bNode ***nsort)
2831 {
2832         bNode *fromnode;
2833         bNodeLink *link;
2834         int level = 0xFFF;
2835         
2836         node->done = true;
2837         
2838         /* check linked nodes */
2839         for (link = ntree->links.first; link; link = link->next) {
2840                 if (link->tonode == node) {
2841                         fromnode = link->fromnode;
2842                         if (fromnode->done == 0)
2843                                 fromnode->level = node_get_deplist_recurs(ntree, fromnode, nsort);
2844                         if (fromnode->level <= level)
2845                                 level = fromnode->level - 1;
2846                 }
2847         }
2848         
2849         /* check parent node */
2850         if (node->parent) {
2851                 if (node->parent->done == 0)
2852                         node->parent->level = node_get_deplist_recurs(ntree, node->parent, nsort);
2853                 if (node->parent->level <= level)
2854                         level = node->parent->level - 1;
2855         }
2856         
2857         if (nsort) {
2858                 **nsort = node;
2859                 (*nsort)++;
2860         }
2861         
2862         return level;
2863 }
2864
2865 void ntreeGetDependencyList(struct bNodeTree *ntree, struct bNode ***deplist, int *totnodes)
2866 {
2867         bNode *node, **nsort;
2868         
2869         *totnodes = 0;
2870         
2871         /* first clear data */
2872         for (node = ntree->nodes.first; node; node = node->next) {
2873                 node->done = false;
2874                 (*totnodes)++;
2875         }
2876         if (*totnodes == 0) {
2877                 *deplist = NULL;
2878                 return;
2879         }
2880         
2881         nsort = *deplist = MEM_callocN((*totnodes) * sizeof(bNode *), "sorted node array");
2882         
2883         /* recursive check */
2884         for (node = ntree->nodes.first; node; node = node->next) {
2885                 if (node->done == 0) {
2886                         node->level = node_get_deplist_recurs(ntree, node, &nsort);
2887                 }
2888         }
2889 }
2890
2891 /* only updates node->level for detecting cycles links */
2892 static void ntree_update_node_level(bNodeTree *ntree)
2893 {
2894         bNode *node;
2895         
2896         /* first clear tag */
2897         for (node = ntree->nodes.first; node; node = node->next) {
2898                 node->done = false;
2899         }
2900         
2901         /* recursive check */
2902         for (node = ntree->nodes.first; node; node = node->next) {
2903                 if (node->done == 0) {
2904                         node->level = node_get_deplist_recurs(ntree, node, NULL);
2905                 }
2906         }
2907 }
2908
2909 void ntreeTagUsedSockets(bNodeTree *ntree)
2910 {
2911         bNode *node;
2912         bNodeSocket *sock;
2913         bNodeLink *link;
2914         
2915         /* first clear data */
2916         for (node = ntree->nodes.first; node; node = node->next) {
2917                 for (sock = node->inputs.first; sock; sock = sock->next) {
2918                         sock->flag &= ~SOCK_IN_USE;
2919                 }
2920                 for (sock = node->outputs.first; sock; sock = sock->next) {
2921                         sock->flag &= ~SOCK_IN_USE;
2922                 }
2923         }
2924         
2925         for (link = ntree->links.first; link; link = link->next) {
2926                 /* link is unused if either side is disabled */
2927                 if ((link->fromsock->flag & SOCK_UNAVAIL) || (link->tosock->flag & SOCK_UNAVAIL))
2928                         continue;
2929                 
2930                 link->fromsock->flag |= SOCK_IN_USE;
2931                 link->tosock->flag |= SOCK_IN_USE;
2932         }
2933 }
2934
2935 static void ntree_update_link_pointers(bNodeTree *ntree)
2936 {
2937         bNode *node;
2938         bNodeSocket *sock;
2939         bNodeLink *link;
2940         
2941         /* first clear data */
2942         for (node = ntree->nodes.first; node; node = node->next) {
2943                 for (sock = node->inputs.first; sock; sock = sock->next) {
2944                         sock->link = NULL;
2945                 }
2946         }
2947
2948         for (link = ntree->links.first; link; link = link->next) {
2949                 link->tosock->link = link;
2950         }
2951         
2952         ntreeTagUsedSockets(ntree);
2953 }
2954
2955 static void ntree_validate_links(bNodeTree *ntree)
2956 {
2957         bNodeLink *link;
2958         
2959         for (link = ntree->links.first; link; link = link->next) {
2960                 link->flag |= NODE_LINK_VALID;
2961                 if (link->fromnode && link->tonode && link->fromnode->level <= link->tonode->level)
2962                         link->flag &= ~NODE_LINK_VALID;
2963                 else if (ntree->typeinfo->validate_link) {
2964                         if (!ntree->typeinfo->validate_link(ntree, link))
2965                                 link->flag &= ~NODE_LINK_VALID;
2966                 }
2967         }
2968 }
2969
2970 void ntreeVerifyNodes(struct Main *main, struct ID *id)
2971 {
2972         FOREACH_NODETREE(main, ntree, owner_id) {
2973                 bNode *node;
2974                 
2975                 for (node = ntree->nodes.first; node; node = node->next)
2976                         if (node->typeinfo->verifyfunc)
2977                                 node->typeinfo->verifyfunc(ntree, node, id);
2978         } FOREACH_NODETREE_END
2979 }
2980
2981 void ntreeUpdateTree(Main *bmain, bNodeTree *ntree)
2982 {
2983         bNode *node;
2984         
2985         if (!ntree)
2986                 return;
2987         
2988         /* avoid reentrant updates, can be caused by RNA update callbacks */
2989         if (ntree->is_updating)
2990                 return;
2991         ntree->is_updating = true;
2992         
2993         if (ntree->update & (NTREE_UPDATE_LINKS | NTREE_UPDATE_NODES)) {
2994                 /* set the bNodeSocket->link pointers */
2995                 ntree_update_link_pointers(ntree);
2996         }
2997         
2998         /* update individual nodes */
2999         for (node = ntree->nodes.first; node; node = node->next) {
3000                 /* node tree update tags override individual node update flags */
3001                 if ((node->update & NODE_UPDATE) || (ntree->update & NTREE_UPDATE)) {
3002                         if (node->typeinfo->updatefunc)
3003                                 node->typeinfo->updatefunc(ntree, node);
3004                         
3005                         nodeUpdateInternalLinks(ntree, node);
3006                 }
3007         }
3008         
3009         /* generic tree update callback */
3010         if (ntree->typeinfo->update)
3011                 ntree->typeinfo->update(ntree);
3012         /* XXX this should be moved into the tree type update callback for tree supporting node groups.
3013          * Currently the node tree interface is still a generic feature of the base NodeTree type.
3014          */
3015         if (ntree->update & NTREE_UPDATE_GROUP)
3016                 ntreeInterfaceTypeUpdate(ntree);
3017         
3018         /* XXX hack, should be done by depsgraph!! */
3019         if (bmain)
3020                 ntreeVerifyNodes(bmain, &ntree->id);
3021         
3022         if (ntree->update & (NTREE_UPDATE_LINKS | NTREE_UPDATE_NODES)) {
3023                 /* node updates can change sockets or links, repeat link pointer update afterward */
3024                 ntree_update_link_pointers(ntree);
3025                 
3026                 /* update the node level from link dependencies */
3027                 ntree_update_node_level(ntree);
3028                 
3029                 /* check link validity */
3030                 ntree_validate_links(ntree);
3031         }
3032         
3033         /* clear update flags */
3034         for (node = ntree->nodes.first; node; node = node->next) {
3035                 node->update = 0;
3036         }
3037         ntree->update = 0;
3038         
3039         ntree->is_updating = false;
3040 }
3041
3042 void nodeUpdate(bNodeTree *ntree, bNode *node)
3043 {
3044         /* avoid reentrant updates, can be caused by RNA update callbacks */
3045         if (ntree->is_updating)
3046                 return;
3047         ntree->is_updating = true;
3048         
3049         if (node->typeinfo->updatefunc)
3050                 node->typeinfo->updatefunc(ntree, node);
3051         
3052         nodeUpdateInternalLinks(ntree, node);
3053         
3054         /* clear update flag */
3055         node->update = 0;
3056         
3057         ntree->is_updating = false;
3058 }
3059
3060 bool nodeUpdateID(bNodeTree *ntree, ID *id)
3061 {
3062         bNode *node;
3063         bool changed = false;
3064         
3065         if (ELEM(NULL, id, ntree))
3066                 return changed;
3067         
3068         /* avoid reentrant updates, can be caused by RNA update callbacks */
3069         if (ntree->is_updating)
3070                 return changed;
3071         ntree->is_updating = true;
3072         
3073         for (node = ntree->nodes.first; node; node = node->next) {
3074                 if (node->id == id) {
3075                         changed = true;
3076                         node->update |= NODE_UPDATE_ID;
3077                         if (node->typeinfo->updatefunc)
3078                                 node->typeinfo->updatefunc(ntree, node);
3079                         /* clear update flag */
3080                         node->update = 0;
3081                 }
3082         }
3083         
3084         for (node = ntree->nodes.first; node; node = node->next) {
3085                 nodeUpdateInternalLinks(ntree, node);
3086         }
3087         
3088         ntree->is_updating = false;
3089         return changed;
3090 }
3091
3092 void nodeUpdateInternalLinks(bNodeTree *ntree, bNode *node)
3093 {
3094         BLI_freelistN(&node->internal_links);
3095         
3096         if (node->typeinfo && node->typeinfo->update_internal_links)
3097                 node->typeinfo->update_internal_links(ntree, node);
3098 }
3099
3100
3101 /* nodes that use ID data get synced with local data */
3102 void nodeSynchronizeID(bNode *node, bool copy_to_id)
3103 {
3104         if (node->id == NULL) return;
3105         
3106         if (ELEM(node->type, SH_NODE_MATERIAL, SH_NODE_MATERIAL_EXT)) {
3107                 bNodeSocket *sock;
3108                 Material *ma = (Material *)node->id;
3109                 int a;
3110                 short check_flags = SOCK_UNAVAIL;
3111
3112                 if (!copy_to_id)
3113                         check_flags |= SOCK_HIDDEN;
3114                 
3115                 /* hrmf, case in loop isn't super fast, but we don't edit 100s of material at same time either! */
3116                 for (a = 0, sock = node->inputs.first; sock; sock = sock->next, a++) {
3117                         if (!(sock->flag & check_flags)) {
3118                                 if (copy_to_id) {
3119                                         switch (a) {
3120                                                 case MAT_IN_COLOR:
3121                                                         copy_v3_v3(&ma->r, ((bNodeSocketValueRGBA *)sock->default_value)->value); break;
3122                                                 case MAT_IN_SPEC:
3123                                                         copy_v3_v3(&ma->specr, ((bNodeSocketValueRGBA *)sock->default_value)->value); break;
3124                                                 case MAT_IN_REFL:
3125                                                         ma->ref = ((bNodeSocketValueFloat *)sock->default_value)->value; break;
3126                                                 case MAT_IN_MIR:
3127                                                         copy_v3_v3(&ma->mirr, ((bNodeSocketValueRGBA *)sock->default_value)->value); break;
3128                                                 case MAT_IN_AMB:
3129                                                         ma->amb = ((bNodeSocketValueFloat *)sock->default_value)->value; break;
3130                                                 case MAT_IN_EMIT:
3131                                                         ma->emit = ((bNodeSocketValueFloat *)sock->default_value)->value; break;
3132                                                 case MAT_IN_SPECTRA:
3133                                                         ma->spectra = ((bNodeSocketValueFloat *)sock->default_value)->value; break;
3134                                                 case MAT_IN_RAY_MIRROR:
3135                                                         ma->ray_mirror = ((bNodeSocketValueFloat *)sock->default_value)->value; break;
3136                                                 case MAT_IN_ALPHA:
3137                                                         ma->alpha = ((bNodeSocketValueFloat *)sock->default_value)->value; break;
3138                                                 case MAT_IN_TRANSLUCENCY:
3139                                                         ma->translucency = ((bNodeSocketValueFloat *)sock->default_value)->value; break;
3140                                         }
3141                                 }
3142                                 else {
3143                                         switch (a) {
3144                                                 case MAT_IN_COLOR:
3145                                                         copy_v3_v3(((bNodeSocketValueRGBA *)sock->default_value)->value, &ma->r); break;
3146                                                 case MAT_IN_SPEC:
3147                                                         copy_v3_v3(((bNodeSocketValueRGBA *)sock->default_value)->value, &ma->specr); break;
3148                                                 case MAT_IN_REFL:
3149                                                         ((bNodeSocketValueFloat *)sock->default_value)->value = ma->ref; break;
3150                                                 case MAT_IN_MIR:
3151                                                         copy_v3_v3(((bNodeSocketValueRGBA *)sock->default_value)->value, &ma->mirr); break;
3152                                                 case MAT_IN_AMB:
3153                                                         ((bNodeSocketValueFloat *)sock->default_value)->value = ma->amb; break;
3154                                                 case MAT_IN_EMIT:
3155                                                         ((bNodeSocketValueFloat *)sock->default_value)->value = ma->emit; break;
3156                                                 case MAT_IN_SPECTRA:
3157                                                         ((bNodeSocketValueFloat *)sock->default_value)->value = ma->spectra; break;
3158                                                 case MAT_IN_RAY_MIRROR:
3159                                                         ((bNodeSocketValueFloat *)sock->default_value)->value = ma->ray_mirror; break;
3160                                                 case MAT_IN_ALPHA:
3161                                                         ((bNodeSocketValueFloat *)sock->default_value)->value = ma->alpha; break;
3162                                                 case MAT_IN_TRANSLUCENCY:
3163                                                         ((bNodeSocketValueFloat *)sock->default_value)->value = ma->translucency; break;
3164                                         }
3165                                 }
3166                         }
3167                 }
3168         }
3169 }
3170
3171
3172 /* ************* node type access ********** */
3173
3174 void nodeLabel(bNodeTree *ntree, bNode *node, char *label, int maxlen)
3175 {
3176         label[0] = '\0';
3177
3178         if (node->label[0] != '\0') {
3179                 BLI_strncpy(label, node->label, maxlen);
3180         }
3181         else if (node->typeinfo->labelfunc) {
3182                 node->typeinfo->labelfunc(ntree, node, label, maxlen);
3183         }
3184
3185         /* The previous methods (labelfunc) could not provide an adequate label for the node. */
3186         if (label[0] == '\0') {
3187                 /* Kind of hacky and weak... Ideally would be better to use RNA here. :| */
3188                 const char *tmp = CTX_IFACE_(BLT_I18NCONTEXT_ID_NODETREE, node->typeinfo->ui_name);
3189                 if (tmp == node->typeinfo->ui_name) {
3190                         tmp = IFACE_(node->typeinfo->ui_name);
3191                 }
3192                 BLI_strncpy(label, tmp, maxlen);
3193         }
3194 }
3195
3196 static void node_type_base_defaults(bNodeType *ntype)
3197 {
3198         /* default size values */
3199         node_type_size_preset(ntype, NODE_SIZE_DEFAULT);
3200         ntype->height = 100;
3201         ntype->minheight = 30;
3202         ntype->maxheight = FLT_MAX;
3203 }
3204
3205 /* allow this node for any tree type */
3206 static int node_poll_default(bNodeType *UNUSED(ntype), bNodeTree *UNUSED(ntree))
3207 {
3208         return true;
3209 }
3210
3211 /* use the basic poll function */
3212 static int node_poll_instance_default(bNode *node, bNodeTree *ntree)
3213 {
3214         return node->typeinfo->poll(node->typeinfo, ntree);
3215 }
3216
3217 void node_type_base(bNodeType *ntype, int type, const char *name, short nclass, short flag)
3218 {
3219         /* Use static type info header to map static int type to identifier string and RNA struct type.
3220          * Associate the RNA struct type with the bNodeType.
3221          * Dynamically registered nodes will create an RNA type at runtime
3222          * and call RNA_struct_blender_type_set, so this only needs to be done for old RNA types
3223          * created in makesrna, which can not be associated to a bNodeType immediately,
3224          * since bNodeTypes are registered afterward ...
3225          */
3226 #define DefNode(Category, ID, DefFunc, EnumName, StructName, UIName, UIDesc) \
3227                 case ID: \
3228                         BLI_strncpy(ntype->idname, #Category #StructName, sizeof(ntype->idname)); \
3229                         ntype->ext.srna = RNA_struct_find(#Category #StructName); \
3230                         BLI_assert(ntype->ext.srna != NULL); \
3231                         RNA_struct_blender_type_set(ntype->ext.srna, ntype); \
3232                         break;
3233         
3234         switch (type) {
3235 #include "NOD_static_types.h"
3236         }
3237         
3238         /* make sure we have a valid type (everything registered) */
3239         BLI_assert(ntype->idname[0] != '\0');
3240         
3241         ntype->type = type;
3242         BLI_strncpy(ntype->ui_name, name, sizeof(ntype->ui_name));
3243         ntype->nclass = nclass;
3244         ntype->flag = flag;
3245
3246         node_type_base_defaults(ntype);
3247
3248         ntype->poll = node_poll_default;
3249         ntype->poll_instance = node_poll_instance_default;
3250 }
3251
3252 void node_type_base_custom(bNodeType *ntype, const char *idname, const char *name, short nclass, short flag)
3253 {
3254         BLI_strncpy(ntype->idname, idname, sizeof(ntype->idname));
3255         ntype->type = NODE_CUSTOM;
3256         BLI_strncpy(ntype->ui_name, name, sizeof(ntype->ui_name));
3257         ntype->nclass = nclass;
3258         ntype->flag = flag;
3259
3260         node_type_base_defaults(ntype);
3261 }
3262
3263 static bool unique_socket_template_identifier_check(void *arg, const char *name)
3264 {
3265         bNodeSocketTemplate *ntemp;
3266         struct {bNodeSocketTemplate *list; bNodeSocketTemplate *ntemp;} *data = arg;
3267         
3268         for (ntemp = data->list; ntemp->type >= 0; ++ntemp) {
3269                 if (ntemp != data->ntemp) {
3270                         if (STREQ(ntemp->identifier, name)) {
3271                                 return true;
3272                         }
3273                 }
3274         }
3275         
3276         return false;
3277 }
3278
3279 static void unique_socket_template_identifier(bNodeSocketTemplate *list, bNodeSocketTemplate *ntemp, const char defname[], char delim)
3280 {
3281         struct {bNodeSocketTemplate *list; bNodeSocketTemplate *ntemp;} data;
3282         data.list = list;
3283         data.ntemp = ntemp;
3284
3285         BLI_uniquename_cb(unique_socket_template_identifier_check, &data, defname, delim, ntemp->identifier, sizeof(ntemp->identifier));
3286 }
3287
3288 void node_type_socket_templates(struct bNodeType *ntype, struct bNodeSocketTemplate *inputs, struct bNodeSocketTemplate *outputs)
3289 {
3290         bNodeSocketTemplate *ntemp;
3291         
3292         ntype->inputs = inputs;
3293         ntype->outputs = outputs;
3294         
3295         /* automatically generate unique identifiers */
3296         if (inputs) {