#include <functional>
#include <optional>
#include "BLI_span.hh"

Classes
struct	NodeTreeUpdateExtraParams

Functions
void	BKE_ntree_update_tag_all (bNodeTree *ntree)
void	BKE_ntree_update_tag_node_property (bNodeTree ntree, bNode node)
void	BKE_ntree_update_tag_node_new (bNodeTree ntree, bNode node)
void	BKE_ntree_update_tag_node_removed (bNodeTree *ntree)
void	BKE_ntree_update_tag_node_mute (bNodeTree ntree, bNode node)
void	BKE_ntree_update_tag_node_internal_link (bNodeTree ntree, bNode node)
void	BKE_ntree_update_tag_node_type (bNodeTree ntree, bNode node)
void	BKE_ntree_update_tag_socket_property (bNodeTree ntree, bNodeSocket socket)
void	BKE_ntree_update_tag_socket_new (bNodeTree ntree, bNodeSocket socket)
void	BKE_ntree_update_tag_socket_type (bNodeTree ntree, bNodeSocket socket)
void	BKE_ntree_update_tag_socket_availability (bNodeTree ntree, bNodeSocket socket)
void	BKE_ntree_update_tag_socket_removed (bNodeTree *ntree)
void	BKE_ntree_update_tag_link_changed (bNodeTree *ntree)
void	BKE_ntree_update_tag_link_removed (bNodeTree *ntree)
void	BKE_ntree_update_tag_link_added (bNodeTree ntree, bNodeLink link)
void	BKE_ntree_update_tag_link_mute (bNodeTree ntree, bNodeLink link)
void	BKE_ntree_update_tag_active_output_changed (bNodeTree *ntree)
void	BKE_ntree_update_tag_missing_runtime_data (bNodeTree *ntree)
void	BKE_ntree_update_tag_parent_change (bNodeTree ntree, bNode node)
void	BKE_ntree_update_tag_id_changed (Main bmain, ID id)
void	BKE_ntree_update_tag_image_user_changed (bNodeTree ntree, ImageUser iuser)
void	BKE_ntree_update (Main &bmain, std::optional< blender::Span< bNodeTree * > > modified_trees=std::nullopt, const NodeTreeUpdateExtraParams &params={})
void	BKE_ntree_update_after_single_tree_change (Main &bmain, bNodeTree &modified_tree, const NodeTreeUpdateExtraParams &params={})
void	BKE_ntree_update_without_main (bNodeTree &tree)

Function Documentation

◆ BKE_ntree_update()

void BKE_ntree_update	(	Main &	bmain,
		std::optional< blender::Span< bNodeTree * > >	modified_trees = std::nullopt,
		const NodeTreeUpdateExtraParams &	params = {} )

Updates the given bmain to ensure invariants related to node trees (for example that group nodes have sockets that correspond to the referenced node tree).

Parameters

bmain	Used to e.g. find node trees that depend on a modified node tree and thus have to be modified too.
modified_trees	Optional filter for node trees that have been modified. Passing this in may make the update faster by avoiding having to iterate over all node trees.
params	Additional parameters that allow the caller to properly tag the depsgraph and sent notifiers.

References params.

Referenced by BKE_image_signal(), blender::bke::node_tree_update_all_new(), blender::bke::node_tree_update_all_users(), ntreeCompositTagRender(), propagate_node_tree_changes(), render_endjob(), blender::ed::transform::special_aftertrans_update__movieclip(), and blender::ed::transform::special_aftertrans_update__movieclip_for_curves().

◆ BKE_ntree_update_after_single_tree_change()

void BKE_ntree_update_after_single_tree_change	(	Main &	bmain,
		bNodeTree &	modified_tree,
		const NodeTreeUpdateExtraParams &	params = {} )

Same as BKE_ntree_update but with a simpler API for the case when only a single tree has been modified.

Definition at line 2058 of file node_tree_update.cc.

References BKE_ntree_update(), and params.

Referenced by blender::bke::add_auto_smooth_node_tree(), BKE_linestyle_default_shader(), blender::ed::space_node::connect_nested_node_to_node(), blender::ed::space_node::connect_node_to_surface_output(), blender::ed::space_node::connect_nodes_to_aovs(), blender::io::usd::dome_light_to_world_material(), ED_node_composit_default(), ED_node_shader_default(), ED_node_texture_default(), blender::io::obj::get_or_create_material(), Freestyle::BlenderStrokeRenderer::GetStrokeShader(), blender::io::fbx::import_material(), blender::io::usd::USDMaterialReader::import_usd_preview_nodes(), ntree_exec_begin(), ntree_shader_groups_expand_inputs(), ntree_shader_groups_flatten(), ntree_shader_implicit_closure_cast(), ntree_shader_pruned_unused(), ntree_shader_shader_to_rgba_branches(), ntree_shader_unlink_hidden_value_sockets(), ntree_shader_weight_tree_invert(), blender::io::usd::USDPointInstancerReader::read_object_data(), blender::io::usd::USDPointInstancerReader::set_collection(), and MaterialNode::update_material_nodetree().

◆ BKE_ntree_update_tag_active_output_changed()

void BKE_ntree_update_tag_active_output_changed ( bNodeTree * ntree )

Used when the a new output node becomes active and therefore changes the output.

Definition at line 1986 of file node_tree_update.cc.

References add_tree_tag(), and NTREE_CHANGED_ANY.

Referenced by ED_node_set_active(), blender::ed::space_node::viewer_linking::finalize_viewer_link(), and blender::ed::space_node::node_activate_viewer_exec().

◆ BKE_ntree_update_tag_all()

void BKE_ntree_update_tag_all ( bNodeTree * ntree )

Tag tree as changed without providing any more information about what has changed exactly. The update process has to assume that everything may have changed.

Using one of the methods below to tag the tree after changes is preferred when possible.

Definition at line 1906 of file node_tree_update.cc.

References add_tree_tag(), and NTREE_CHANGED_ANY.

Referenced by blo_do_versions_250(), flatten_group_do(), foreach_libblock_remap_callback_apply(), blender::ed::space_node::node_group_separate_selected(), blender::bke::node_tree_update_all_new(), blender::bke::ntree_set_typeinfo(), and paste_material_exec().