blender::nodes::socket_items Namespace Reference

Namespaces
namespace	detail
namespace	ops

Classes
struct	SocketItemsRef

Functions
template<typename Accessor >
bNode *	find_node_by_item (bNodeTree &ntree, const typename Accessor::ItemT &item)
template<typename Accessor >
void	destruct_array (bNode &node)
template<typename Accessor >
void	copy_array (const bNode &src_node, bNode &dst_node)
template<typename Accessor >
void	set_item_name_and_make_unique (bNode &node, typename Accessor::ItemT &item, const char *value)
template<typename Accessor >
Accessor::ItemT *	add_item_with_socket_type_and_name (bNode &node, const eNodeSocketDatatype socket_type, const char *name)
template<typename Accessor >
Accessor::ItemT *	add_item_with_name (bNode &node, const char *name)
template<typename Accessor >
Accessor::ItemT *	add_item (bNode &node)
template<typename Accessor >
std::string	get_socket_identifier (const typename Accessor::ItemT &item, const eNodeSocketInOut in_out)
template<typename Accessor >
bool	try_add_item_via_extend_socket (bNodeTree &ntree, bNode &extend_node, bNodeSocket &extend_socket, bNode &storage_node, bNodeLink &link)
template<typename Accessor >
bool	try_add_item_via_any_extend_socket (bNodeTree &ntree, bNode &extend_node, bNode &storage_node, bNodeLink &link, const std::optional< StringRef > socket_identifier=std::nullopt)

Detailed Description

Some nodes have a dynamic number of sockets (e.g. simulation input/output). These nodes store an array of items in their bNode->storage (e.g. NodeSimulationItem). Different nodes have slightly different storage requirements, but a lot of the logic is still the same between nodes. This file implements various shared functionality that can be used by different nodes to deal with these item arrays.

In order to use the functions, one has to implement an "accessor" which tells the shared code how to deal with specific item arrays. Different functions have different requirements for the accessor. It's easiest to just look at existing accessors like #SimulationItemsAccessor and #RepeatItemsAccessor and to implement the same methods.

Function Documentation

add_item()

template<typename Accessor >

Accessor::ItemT * blender::nodes::socket_items::add_item ( bNode & node )

inline

Add a new item at the end.

Definition at line 189 of file NOD_socket_items.hh.

References blender::nodes::socket_items::detail::add_item_to_array().

Referenced by blender::nodes::socket_items::ops::add_item(), and try_add_item_via_extend_socket().

add_item_with_name()

template<typename Accessor >

Accessor::ItemT * blender::nodes::socket_items::add_item_with_name ( bNode & node, const char * name )

inline

Add a new item at the end with the given name.

Definition at line 178 of file NOD_socket_items.hh.

References blender::nodes::socket_items::detail::add_item_to_array().

Referenced by blender::nodes::socket_items::ops::add_item(), blender::nodes::node_geo_menu_switch_cc::node_init(), and try_add_item_via_extend_socket().

add_item_with_socket_type_and_name()

template<typename Accessor >

Accessor::ItemT * blender::nodes::socket_items::add_item_with_socket_type_and_name ( bNode & node, const eNodeSocketDatatype socket_type, const char * name )

inline

Add a new item at the end with the given socket type and name.

Definition at line 164 of file NOD_socket_items.hh.

References blender::nodes::socket_items::detail::add_item_to_array(), and BLI_assert.

Referenced by blender::nodes::socket_items::ops::add_item(), blender::nodes::node_geo_attribute_capture_cc::node_gather_link_searches(), and try_add_item_via_extend_socket().

copy_array()

template<typename Accessor >

void blender::nodes::socket_items::copy_array ( const bNode & src_node, bNode & dst_node )

inline

Copy the items from the storage of the source node to the storage of the destination node.

Definition at line 75 of file NOD_socket_items.hh.

References blender::nodes::socket_items::SocketItemsRef< T >::items, and blender::nodes::socket_items::SocketItemsRef< T >::items_num.

Referenced by blender::nodes::node_geo_attribute_capture_cc::node_copy_storage(), blender::nodes::node_geo_bake_cc::node_copy_storage(), blender::nodes::node_geo_foreach_geometry_element_cc::output_node::node_copy_storage(), blender::nodes::node_geo_index_switch_cc::node_copy_storage(), blender::nodes::node_geo_menu_switch_cc::node_copy_storage(), blender::nodes::node_geo_repeat_cc::repeat_output_node::node_copy_storage(), and blender::nodes::node_geo_simulation_cc::sim_output_node::node_copy_storage().

destruct_array()

template<typename Accessor >

void blender::nodes::socket_items::destruct_array ( bNode & node )

inline

Destruct all the items and the free the array itself.

Definition at line 61 of file NOD_socket_items.hh.

References blender::nodes::socket_items::SocketItemsRef< T >::items, blender::nodes::socket_items::SocketItemsRef< T >::items_num, and MEM_SAFE_FREE.

Referenced by blender::nodes::node_geo_attribute_capture_cc::node_free_storage(), blender::nodes::node_geo_bake_cc::node_free_storage(), blender::nodes::node_geo_foreach_geometry_element_cc::output_node::node_free_storage(), blender::nodes::node_geo_index_switch_cc::node_free_storage(), blender::nodes::node_geo_menu_switch_cc::node_free_storage(), blender::nodes::node_geo_repeat_cc::repeat_output_node::node_free_storage(), and blender::nodes::node_geo_simulation_cc::sim_output_node::node_free_storage().

find_node_by_item()

template<typename Accessor >

bNode * blender::nodes::socket_items::find_node_by_item ( bNodeTree & ntree, const typename Accessor::ItemT & item )

inline

Iterates over the node tree to find the node that this item belongs to.

Definition at line 46 of file NOD_socket_items.hh.

References node.

get_socket_identifier()

template<typename Accessor >

std::string blender::nodes::socket_items::get_socket_identifier ( const typename Accessor::ItemT & item, const eNodeSocketInOut in_out )

inline

Definition at line 198 of file NOD_socket_items.hh.

References SOCK_IN.

Referenced by try_add_item_via_extend_socket().

set_item_name_and_make_unique()

template<typename Accessor >

void blender::nodes::socket_items::set_item_name_and_make_unique ( bNode & node, typename Accessor::ItemT & item, const char * value )

inline

Changes the name of an existing item and makes sure that the name is unique among other the other items in the same array.

Definition at line 92 of file NOD_socket_items.hh.

References ARRAY_SIZE, BLI_strdup(), BLI_uniquename_cb(), MAX_NAME, MEM_SAFE_FREE, blender::bke::node_static_socket_label(), STREQ, STRNCPY, and unique_name().

Referenced by blender::nodes::MenuSwitchItemsAccessor::init_with_name(), blender::nodes::BakeItemsAccessor::init_with_socket_type_and_name(), blender::nodes::CaptureAttributeItemsAccessor::init_with_socket_type_and_name(), blender::nodes::ForeachGeometryElementGenerationItemsAccessor::init_with_socket_type_and_name(), blender::nodes::ForeachGeometryElementInputItemsAccessor::init_with_socket_type_and_name(), blender::nodes::ForeachGeometryElementMainItemsAccessor::init_with_socket_type_and_name(), blender::nodes::RepeatItemsAccessor::init_with_socket_type_and_name(), and blender::nodes::SimulationItemsAccessor::init_with_socket_type_and_name().

try_add_item_via_any_extend_socket()

template<typename Accessor >

bool blender::nodes::socket_items::try_add_item_via_any_extend_socket ( bNodeTree & ntree, bNode & extend_node, bNode & storage_node, bNodeLink & link, const std::optional< StringRef > socket_identifier = std::nullopt )

inlinenodiscard

Allow the item array to be extended from any extend-socket in the node.

Returns

False if the link should be removed.

Definition at line 278 of file NOD_socket_items.hh.

References bNodeLink::fromnode, bNodeLink::fromsock, bNodeSocket::identifier, bNodeSocket::idname, STREQ, bNodeLink::tonode, bNodeLink::tosock, and try_add_item_via_extend_socket().

Referenced by blender::nodes::node_geo_attribute_capture_cc::node_insert_link(), blender::nodes::node_geo_bake_cc::node_insert_link(), blender::nodes::node_geo_foreach_geometry_element_cc::input_node::node_insert_link(), blender::nodes::node_geo_foreach_geometry_element_cc::output_node::node_insert_link(), blender::nodes::node_geo_index_switch_cc::node_insert_link(), blender::nodes::node_geo_menu_switch_cc::node_insert_link(), blender::nodes::node_geo_repeat_cc::repeat_input_node::node_insert_link(), blender::nodes::node_geo_repeat_cc::repeat_output_node::node_insert_link(), blender::nodes::node_geo_simulation_cc::sim_input_node::node_insert_link(), and blender::nodes::node_geo_simulation_cc::sim_output_node::node_insert_link().

try_add_item_via_extend_socket()

template<typename Accessor >

bool blender::nodes::socket_items::try_add_item_via_extend_socket ( bNodeTree & ntree, bNode & extend_node, bNodeSocket & extend_socket, bNode & storage_node, bNodeLink & link )

inlinenodiscard

Check if the link connects to the extend_socket. If yes, create a new item for the linked socket, update the node and then change the link to point to the new socket.

Returns

False if the link should be removed.

Definition at line 220 of file NOD_socket_items.hh.

References add_item(), add_item_with_name(), add_item_with_socket_type_and_name(), bNodeLink::fromsock, get_socket_identifier(), bNodeSocket::name, blender::bke::node_find_socket(), SOCK_IN, SOCK_OUT, bNodeLink::tosock, bNodeSocket::type, and blender::nodes::update_node_declaration_and_sockets().

Referenced by try_add_item_via_any_extend_socket().