/* SPDX-License-Identifier: GPL-2.0-or-later * Copyright 2007 Blender Foundation. All rights reserved. */ /** \file * \ingroup nodes */ #include #include #include "DNA_node_types.h" #include "BLI_listbase.h" #include "BLI_map.hh" #include "BLI_multi_value_map.hh" #include "BLI_set.hh" #include "BLI_stack.hh" #include "BLI_string.h" #include "BLI_string_ref.hh" #include "BLI_utildefines.h" #include "BLT_translation.h" #include "BKE_node.h" #include "BKE_node_tree_update.h" #include "RNA_types.h" #include "MEM_guardedalloc.h" #include "NOD_common.h" #include "node_common.h" #include "node_util.h" using blender::Map; using blender::MultiValueMap; using blender::Set; using blender::Stack; using blender::StringRef; using blender::Vector; /* -------------------------------------------------------------------- */ /** \name Node Group * \{ */ static bNodeSocket *find_matching_socket(ListBase &sockets, StringRef identifier) { LISTBASE_FOREACH (bNodeSocket *, socket, &sockets) { if (socket->identifier == identifier) { return socket; } } return nullptr; } bNodeSocket *node_group_find_input_socket(bNode *groupnode, const char *identifier) { return find_matching_socket(groupnode->inputs, identifier); } bNodeSocket *node_group_find_output_socket(bNode *groupnode, const char *identifier) { return find_matching_socket(groupnode->outputs, identifier); } void node_group_label(const bNodeTree * /*ntree*/, const bNode *node, char *label, int maxlen) { BLI_strncpy(label, (node->id) ? node->id->name + 2 : IFACE_("Missing Data-Block"), maxlen); } bool node_group_poll_instance(bNode *node, bNodeTree *nodetree, const char **disabled_hint) { if (node->typeinfo->poll(node->typeinfo, nodetree, disabled_hint)) { bNodeTree *grouptree = (bNodeTree *)node->id; if (grouptree) { return nodeGroupPoll(nodetree, grouptree, disabled_hint); } return true; /* without a linked node tree, group node is always ok */ } return false; } bool nodeGroupPoll(const bNodeTree *nodetree, const bNodeTree *grouptree, const char **r_disabled_hint) { bool valid = true; /* unspecified node group, generally allowed * (if anything, should be avoided on operator level) */ if (grouptree == nullptr) { return true; } if (nodetree == grouptree) { if (r_disabled_hint) { *r_disabled_hint = TIP_("Nesting a node group inside of itself is not allowed"); } return false; } LISTBASE_FOREACH (const bNode *, node, &grouptree->nodes) { if (node->typeinfo->poll_instance && !node->typeinfo->poll_instance( const_cast(node), const_cast(nodetree), r_disabled_hint)) { valid = false; break; } } return valid; } static void add_new_socket_from_interface(bNodeTree &node_tree, bNode &node, const bNodeSocket &interface_socket, const eNodeSocketInOut in_out) { bNodeSocket *socket = nodeAddSocket(&node_tree, &node, in_out, interface_socket.idname, interface_socket.identifier, interface_socket.name); if (interface_socket.typeinfo->interface_init_socket) { interface_socket.typeinfo->interface_init_socket( &node_tree, &interface_socket, &node, socket, "interface"); } } static void update_socket_to_match_interface(bNodeTree &node_tree, bNode &node, bNodeSocket &socket_to_update, const bNodeSocket &interface_socket) { strcpy(socket_to_update.name, interface_socket.name); const int mask = SOCK_HIDE_VALUE; socket_to_update.flag = (socket_to_update.flag & ~mask) | (interface_socket.flag & mask); /* Update socket type if necessary */ if (socket_to_update.typeinfo != interface_socket.typeinfo) { nodeModifySocketType(&node_tree, &node, &socket_to_update, interface_socket.idname); } if (interface_socket.typeinfo->interface_verify_socket) { interface_socket.typeinfo->interface_verify_socket( &node_tree, &interface_socket, &node, &socket_to_update, "interface"); } } /** * Used for group nodes and group input/output nodes to update the list of input or output sockets * on a node to match the provided interface. Assumes that \a verify_lb is the node's matching * input or output socket list, depending on whether the node is a group input/output or a group * node. */ static void group_verify_socket_list(bNodeTree &node_tree, bNode &node, const ListBase &interface_sockets, ListBase &verify_lb, const eNodeSocketInOut in_out, const bool ensure_extend_socket_exists) { ListBase old_sockets = verify_lb; Vector ordered_old_sockets = old_sockets; BLI_listbase_clear(&verify_lb); LISTBASE_FOREACH (const bNodeSocket *, interface_socket, &interface_sockets) { bNodeSocket *matching_socket = find_matching_socket(old_sockets, interface_socket->identifier); if (matching_socket) { /* If a socket with the same identifier exists in the previous socket list, update it * with the correct name, type, etc. Then move it from the old list to the new one. */ update_socket_to_match_interface(node_tree, node, *matching_socket, *interface_socket); BLI_remlink(&old_sockets, matching_socket); BLI_addtail(&verify_lb, matching_socket); } else { /* If there was no socket with the same identifier already, simply create a new socket * based on the interface socket, which will already add it to the new list. */ add_new_socket_from_interface(node_tree, node, *interface_socket, in_out); } } if (ensure_extend_socket_exists) { bNodeSocket *last_socket = static_cast(old_sockets.last); if (last_socket != nullptr && STREQ(last_socket->identifier, "__extend__")) { BLI_remlink(&old_sockets, last_socket); BLI_addtail(&verify_lb, last_socket); } else { nodeAddSocket(&node_tree, &node, in_out, "NodeSocketVirtual", "__extend__", ""); } } /* Remove leftover sockets that didn't match the node group's interface. */ LISTBASE_FOREACH_MUTABLE (bNodeSocket *, unused_socket, &old_sockets) { nodeRemoveSocket(&node_tree, &node, unused_socket); } { /* Check if new sockets match the old sockets. */ int index; LISTBASE_FOREACH_INDEX (bNodeSocket *, new_socket, &verify_lb, index) { if (index < ordered_old_sockets.size()) { if (ordered_old_sockets[index] != new_socket) { BKE_ntree_update_tag_interface(&node_tree); break; } } } } } void node_group_update(struct bNodeTree *ntree, struct bNode *node) { /* check inputs and outputs, and remove or insert them */ if (node->id == nullptr) { nodeRemoveAllSockets(ntree, node); } else if (ID_IS_LINKED(node->id) && (node->id->tag & LIB_TAG_MISSING)) { /* Missing data-block, leave sockets unchanged so that when it comes back * the links remain valid. */ } else { bNodeTree *ngroup = (bNodeTree *)node->id; group_verify_socket_list(*ntree, *node, ngroup->inputs, node->inputs, SOCK_IN, false); group_verify_socket_list(*ntree, *node, ngroup->outputs, node->outputs, SOCK_OUT, false); } } /** \} */ /* -------------------------------------------------------------------- */ /** \name Node Frame * \{ */ static void node_frame_init(bNodeTree * /*ntree*/, bNode *node) { NodeFrame *data = MEM_cnew("frame node storage"); node->storage = data; data->flag |= NODE_FRAME_SHRINK; data->label_size = 20; } void register_node_type_frame() { /* frame type is used for all tree types, needs dynamic allocation */ bNodeType *ntype = MEM_cnew("frame node type"); ntype->free_self = (void (*)(bNodeType *))MEM_freeN; node_type_base(ntype, NODE_FRAME, "Frame", NODE_CLASS_LAYOUT); node_type_init(ntype, node_frame_init); node_type_storage(ntype, "NodeFrame", node_free_standard_storage, node_copy_standard_storage); node_type_size(ntype, 150, 100, 0); ntype->flag |= NODE_BACKGROUND; nodeRegisterType(ntype); } /** \} */ /* -------------------------------------------------------------------- */ /** \name Node Re-Route * \{ */ static void node_reroute_init(bNodeTree *ntree, bNode *node) { /* NOTE: Cannot use socket templates for this, since it would reset the socket type * on each file read via the template verification procedure. */ nodeAddStaticSocket(ntree, node, SOCK_IN, SOCK_RGBA, PROP_NONE, "Input", "Input"); nodeAddStaticSocket(ntree, node, SOCK_OUT, SOCK_RGBA, PROP_NONE, "Output", "Output"); } void register_node_type_reroute() { /* frame type is used for all tree types, needs dynamic allocation */ bNodeType *ntype = MEM_cnew("frame node type"); ntype->free_self = (void (*)(bNodeType *))MEM_freeN; node_type_base(ntype, NODE_REROUTE, "Reroute", NODE_CLASS_LAYOUT); node_type_init(ntype, node_reroute_init); nodeRegisterType(ntype); } static void propagate_reroute_type_from_start_socket( bNodeSocket *start_socket, const MultiValueMap &links_map, Map &r_reroute_types) { Stack nodes_to_check; for (bNodeLink *link : links_map.lookup(start_socket)) { if (link->tonode->type == NODE_REROUTE) { nodes_to_check.push(link->tonode); } if (link->fromnode->type == NODE_REROUTE) { nodes_to_check.push(link->fromnode); } } const bNodeSocketType *current_type = start_socket->typeinfo; while (!nodes_to_check.is_empty()) { bNode *reroute_node = nodes_to_check.pop(); BLI_assert(reroute_node->type == NODE_REROUTE); if (r_reroute_types.add(reroute_node, current_type)) { for (bNodeLink *link : links_map.lookup((bNodeSocket *)reroute_node->inputs.first)) { if (link->fromnode->type == NODE_REROUTE) { nodes_to_check.push(link->fromnode); } } for (bNodeLink *link : links_map.lookup((bNodeSocket *)reroute_node->outputs.first)) { if (link->tonode->type == NODE_REROUTE) { nodes_to_check.push(link->tonode); } } } } } void ntree_update_reroute_nodes(bNodeTree *ntree) { /* Contains nodes that are linked to at least one reroute node. */ Set nodes_linked_with_reroutes; /* Contains all links that are linked to at least one reroute node. */ MultiValueMap links_map; /* Build acceleration data structures for the algorithm below. */ LISTBASE_FOREACH (bNodeLink *, link, &ntree->links) { if (link->fromsock == nullptr || link->tosock == nullptr) { continue; } if (link->fromnode->type != NODE_REROUTE && link->tonode->type != NODE_REROUTE) { continue; } if (link->fromnode->type != NODE_REROUTE) { nodes_linked_with_reroutes.add(link->fromnode); } if (link->tonode->type != NODE_REROUTE) { nodes_linked_with_reroutes.add(link->tonode); } links_map.add(link->fromsock, link); links_map.add(link->tosock, link); } /* Will contain the socket type for every linked reroute node. */ Map reroute_types; /* Propagate socket types from left to right. */ for (bNode *start_node : nodes_linked_with_reroutes) { LISTBASE_FOREACH (bNodeSocket *, output_socket, &start_node->outputs) { propagate_reroute_type_from_start_socket(output_socket, links_map, reroute_types); } } /* Propagate socket types from right to left. This affects reroute nodes that haven't been * changed in the loop above. */ for (bNode *start_node : nodes_linked_with_reroutes) { LISTBASE_FOREACH (bNodeSocket *, input_socket, &start_node->inputs) { propagate_reroute_type_from_start_socket(input_socket, links_map, reroute_types); } } /* Actually update reroute nodes with changed types. */ for (const auto item : reroute_types.items()) { bNode *reroute_node = item.key; const bNodeSocketType *socket_type = item.value; bNodeSocket *input_socket = (bNodeSocket *)reroute_node->inputs.first; bNodeSocket *output_socket = (bNodeSocket *)reroute_node->outputs.first; if (input_socket->typeinfo != socket_type) { nodeModifySocketType(ntree, reroute_node, input_socket, socket_type->idname); } if (output_socket->typeinfo != socket_type) { nodeModifySocketType(ntree, reroute_node, output_socket, socket_type->idname); } } } static bool node_is_connected_to_output_recursive(bNodeTree *ntree, bNode *node) { bNodeLink *link; /* avoid redundant checks, and infinite loops in case of cyclic node links */ if (node->done) { return false; } node->done = 1; /* main test, done before child loop so it catches output nodes themselves as well */ if (node->typeinfo->nclass == NODE_CLASS_OUTPUT && node->flag & NODE_DO_OUTPUT) { return true; } /* test all connected nodes, first positive find is sufficient to return true */ for (link = (bNodeLink *)ntree->links.first; link; link = link->next) { if (link->fromnode == node) { if (node_is_connected_to_output_recursive(ntree, link->tonode)) { return true; } } } return false; } bool BKE_node_is_connected_to_output(bNodeTree *ntree, bNode *node) { bNode *tnode; /* clear flags */ for (tnode = (bNode *)ntree->nodes.first; tnode; tnode = tnode->next) { tnode->done = 0; } return node_is_connected_to_output_recursive(ntree, node); } void BKE_node_tree_unlink_id(ID *id, struct bNodeTree *ntree) { bNode *node; for (node = (bNode *)ntree->nodes.first; node; node = node->next) { if (node->id == id) { node->id = nullptr; } } } /** \} */ /* -------------------------------------------------------------------- */ /** \name Node #GROUP_INPUT / #GROUP_OUTPUT * \{ */ static bool is_group_extension_socket(const bNode *node, const bNodeSocket *socket) { return socket->type == SOCK_CUSTOM && ELEM(node->type, NODE_GROUP_OUTPUT, NODE_GROUP_INPUT); } static void node_group_input_init(bNodeTree *ntree, bNode *node) { node_group_input_update(ntree, node); } bNodeSocket *node_group_input_find_socket(bNode *node, const char *identifier) { bNodeSocket *sock; for (sock = (bNodeSocket *)node->outputs.first; sock; sock = sock->next) { if (STREQ(sock->identifier, identifier)) { return sock; } } return nullptr; } void node_group_input_update(bNodeTree *ntree, bNode *node) { bNodeSocket *extsock = (bNodeSocket *)node->outputs.last; bNodeLink *link, *linknext, *exposelink; /* Adding a tree socket and verifying will remove the extension socket! * This list caches the existing links from the extension socket * so they can be recreated after verification. */ ListBase tmplinks; /* find links from the extension socket and store them */ BLI_listbase_clear(&tmplinks); for (link = (bNodeLink *)ntree->links.first; link; link = linknext) { linknext = link->next; if (nodeLinkIsHidden(link)) { continue; } if (link->fromsock == extsock) { bNodeLink *tlink = MEM_cnew("temporary link"); *tlink = *link; BLI_addtail(&tmplinks, tlink); nodeRemLink(ntree, link); } } /* find valid link to expose */ exposelink = nullptr; for (link = (bNodeLink *)tmplinks.first; link; link = link->next) { /* XXX Multiple sockets can be connected to the extension socket at once, * in that case the arbitrary first link determines name and type. * This could be improved by choosing the "best" type among all links, * whatever that means. */ if (!is_group_extension_socket(link->tonode, link->tosock)) { exposelink = link; break; } } if (exposelink) { bNodeSocket *gsock, *newsock; gsock = ntreeAddSocketInterfaceFromSocket(ntree, exposelink->tonode, exposelink->tosock); node_group_input_update(ntree, node); newsock = node_group_input_find_socket(node, gsock->identifier); /* redirect links from the extension socket */ for (link = (bNodeLink *)tmplinks.first; link; link = link->next) { bNodeLink *newlink = nodeAddLink(ntree, node, newsock, link->tonode, link->tosock); if (newlink->tosock->flag & SOCK_MULTI_INPUT) { newlink->multi_input_socket_index = link->multi_input_socket_index; } } } BLI_freelistN(&tmplinks); group_verify_socket_list(*ntree, *node, ntree->inputs, node->outputs, SOCK_OUT, true); } void register_node_type_group_input() { /* used for all tree types, needs dynamic allocation */ bNodeType *ntype = MEM_cnew("node type"); ntype->free_self = (void (*)(bNodeType *))MEM_freeN; node_type_base(ntype, NODE_GROUP_INPUT, "Group Input", NODE_CLASS_INTERFACE); node_type_size(ntype, 140, 80, 400); node_type_init(ntype, node_group_input_init); node_type_update(ntype, node_group_input_update); nodeRegisterType(ntype); } static void node_group_output_init(bNodeTree *ntree, bNode *node) { node_group_output_update(ntree, node); } bNodeSocket *node_group_output_find_socket(bNode *node, const char *identifier) { bNodeSocket *sock; for (sock = (bNodeSocket *)node->inputs.first; sock; sock = sock->next) { if (STREQ(sock->identifier, identifier)) { return sock; } } return nullptr; } void node_group_output_update(bNodeTree *ntree, bNode *node) { bNodeSocket *extsock = (bNodeSocket *)node->inputs.last; bNodeLink *link, *linknext, *exposelink; /* Adding a tree socket and verifying will remove the extension socket! * This list caches the existing links to the extension socket * so they can be recreated after verification. */ ListBase tmplinks; /* find links to the extension socket and store them */ BLI_listbase_clear(&tmplinks); for (link = (bNodeLink *)ntree->links.first; link; link = linknext) { linknext = link->next; if (nodeLinkIsHidden(link)) { continue; } if (link->tosock == extsock) { bNodeLink *tlink = MEM_cnew("temporary link"); *tlink = *link; BLI_addtail(&tmplinks, tlink); nodeRemLink(ntree, link); } } /* find valid link to expose */ exposelink = nullptr; for (link = (bNodeLink *)tmplinks.first; link; link = link->next) { /* XXX Multiple sockets can be connected to the extension socket at once, * in that case the arbitrary first link determines name and type. * This could be improved by choosing the "best" type among all links, * whatever that means. */ if (!is_group_extension_socket(link->fromnode, link->fromsock)) { exposelink = link; break; } } if (exposelink) { bNodeSocket *gsock, *newsock; /* XXX what if connecting virtual to virtual socket?? */ gsock = ntreeAddSocketInterfaceFromSocket(ntree, exposelink->fromnode, exposelink->fromsock); node_group_output_update(ntree, node); newsock = node_group_output_find_socket(node, gsock->identifier); /* redirect links to the extension socket */ for (link = (bNodeLink *)tmplinks.first; link; link = link->next) { nodeAddLink(ntree, link->fromnode, link->fromsock, node, newsock); } } BLI_freelistN(&tmplinks); group_verify_socket_list(*ntree, *node, ntree->outputs, node->inputs, SOCK_IN, true); } void register_node_type_group_output() { /* used for all tree types, needs dynamic allocation */ bNodeType *ntype = MEM_cnew("node type"); ntype->free_self = (void (*)(bNodeType *))MEM_freeN; node_type_base(ntype, NODE_GROUP_OUTPUT, "Group Output", NODE_CLASS_INTERFACE); node_type_size(ntype, 140, 80, 400); node_type_init(ntype, node_group_output_init); node_type_update(ntype, node_group_output_update); ntype->no_muting = true; nodeRegisterType(ntype); } /** \} */