Classes
struct	TreeGizmoPropagation

Typedefs
using	ForeachGizmoFn

using	ForeachGizmoInModifierFn

Functions
bool	is_builtin_gizmo_node (const bNode &node)

static ie::ElemVariant	get_gizmo_socket_elem (const bNode &node, const bNodeSocket &socket)

static TreeGizmoPropagation	build_tree_gizmo_propagation (bNodeTree &tree)

bool	update_tree_gizmo_propagation (bNodeTree &tree)

static void	foreach_gizmo_for_input (const ie::SocketElem &input_socket, ComputeContextBuilder &compute_context_builder, const bNodeTree &tree, const ForeachGizmoInModifierFn fn)

static void	foreach_gizmo_for_group_input (const bNodeTree &tree, const ie::GroupInputElem &group_input, ComputeContextBuilder &compute_context_builder, const ForeachGizmoInModifierFn fn)

static void	foreach_active_gizmo_in_open_node_editor (const SpaceNode &snode, const Object object_filter, const NodesModifierData nmd_filter, ComputeContextBuilder &compute_context_builder, const ForeachGizmoFn fn)

static void	foreach_active_gizmo_in_open_editors (const wmWindowManager &wm, const Object object_filter, const NodesModifierData nmd_filter, ComputeContextBuilder &compute_context_builder, const ForeachGizmoFn fn)

static void	foreach_active_gizmo_exposed_to_modifier (const NodesModifierData &nmd, ComputeContextBuilder &compute_context_builder, const ForeachGizmoInModifierFn fn)

void	foreach_active_gizmo_in_modifier (const Object &object, const NodesModifierData &nmd, const wmWindowManager &wm, ComputeContextBuilder &compute_context_builder, const ForeachGizmoInModifierFn fn)

void	foreach_active_gizmo (const bContext &C, ComputeContextBuilder &compute_context_builder, const ForeachGizmoFn fn)

void	foreach_compute_context_on_gizmo_path (const ComputeContext &gizmo_context, const bNode &gizmo_node, const bNodeSocket &gizmo_socket, FunctionRef< void(const ComputeContext &context)> fn)

void	foreach_socket_on_gizmo_path (const ComputeContext &gizmo_context, const bNode &gizmo_node, const bNodeSocket &gizmo_socket, FunctionRef< void(const ComputeContext &context, const bNodeSocket &socket, const ie::ElemVariant &elem)> fn)

ie::ElemVariant	get_editable_gizmo_elem (const ComputeContext &gizmo_context, const bNode &gizmo_node, const bNodeSocket &gizmo_socket)

void	apply_gizmo_change (bContext &C, Object &object, NodesModifierData &nmd, geo_eval_log::GeoModifierLog &eval_log, const ComputeContext &gizmo_context, const bNodeSocket &gizmo_socket, const FunctionRef< void(bke::SocketValueVariant &value)> apply_on_gizmo_value_fn)

void	apply_gizmo_change (bContext &C, Object &object, NodesModifierData &nmd, geo_eval_log::GeoModifierLog &eval_log, const ComputeContext &gizmo_context, const bNodeSocket &gizmo_socket, FunctionRef< void(bke::SocketValueVariant &value)> apply_on_gizmo_value_fn)

Typedef Documentation

◆ ForeachGizmoFn

using blender::nodes::gizmos::ForeachGizmoFn

Initial value:

 FunctionRef<void(const Object &object,
                                        const NodesModifierData &nmd,
                                        const ComputeContext &compute_context,
                                        const bNode &gizmo_node,
                                        const bNodeSocket &gizmo_socket)>

Definition at line 54 of file NOD_geometry_nodes_gizmos.hh.

◆ ForeachGizmoInModifierFn

using blender::nodes::gizmos::ForeachGizmoInModifierFn

Initial value:

 FunctionRef<void(const ComputeContext &compute_context,
                                                  const bNode &gizmo_node,
                                                  const bNodeSocket &gizmo_socket)>

Definition at line 68 of file NOD_geometry_nodes_gizmos.hh.

Function Documentation

◆ apply_gizmo_change() [1/2]

void blender::nodes::gizmos::apply_gizmo_change	(	bContext &	C,
		Object &	object,
		NodesModifierData &	nmd,
		geo_eval_log::GeoModifierLog &	eval_log,
		const ComputeContext &	gizmo_context,
		const bNodeSocket &	gizmo_socket,
		const FunctionRef< void(bke::SocketValueVariant &value)>	apply_on_gizmo_value_fn )

Definition at line 487 of file geometry_nodes_gizmos.cc.

References blender::Vector< T, InlineBufferCapacity, Allocator >::append(), blender::nodes::inverse_eval::backpropagate_socket_values(), blender::nodes::inverse_eval::convert_single_socket_value(), blender::nodes::inverse_eval::get_logged_socket_value(), blender::nodes::geo_eval_log::GeoModifierLog::get_tree_log(), and blender::ComputeContext::hash().

Referenced by blender::ed::view3d::geometry_nodes_gizmos::WIDGETGROUP_geometry_nodes_refresh().

◆ apply_gizmo_change() [2/2]

void blender::nodes::gizmos::apply_gizmo_change	(	bContext &	C,
		Object &	object,
		NodesModifierData &	nmd,
		geo_eval_log::GeoModifierLog &	eval_log,
		const ComputeContext &	gizmo_context,
		const bNodeSocket &	gizmo_socket,
		FunctionRef< void(bke::SocketValueVariant &value)>	apply_on_gizmo_value_fn )

Should be called when a gizmo is moved and the change should be propagated back to the right place.

Parameters

C	The context the gizmo is changed in. Required for propagating updates correctly.
object	The object with the modifier that the gizmo belongs to.
nmd	The modifier that the gizmo belongs to.
eval_log	The logged evaluation data that should be used to compute the backpropagated value. This may not be the most recent logged data, because generally the same logged data is used while interacting with a gizmo.
gizmo_context	The compute context of the gizmo node whose gizmo is modified.
gizmo_socket	The gizmo socket whose gizmo is modified.
apply_on_gizmo_value_fn	Applies the change done to the gizmo to the value in the gizmo node. For example, if an arrow gizmo is moved, the distance it's moved is added to the socket value. This is a callback because gizmo sockets are multi-inputs and thus multiple values need to change.

◆ build_tree_gizmo_propagation()

static TreeGizmoPropagation blender::nodes::gizmos::build_tree_gizmo_propagation ( bNodeTree & tree )

static

Definition at line 70 of file geometry_nodes_gizmos.cc.

References blender::Set< Key, InlineBufferCapacity, ProbingStrategy, Hash, IsEqual, Slot, Allocator >::add(), blender::Vector< T, InlineBufferCapacity, Allocator >::append(), BLI_assert, blender::nodes::value_elem::convert_socket_elem(), blender::nodes::value_elem::SocketElem::elem, blender::nodes::inverse_eval::find_local_inverse_eval_targets(), get_gizmo_socket_elem(), blender::nodes::gizmos::TreeGizmoPropagation::gizmo_endpoint_sockets, blender::nodes::gizmos::TreeGizmoPropagation::gizmo_inputs_by_group_inputs, blender::nodes::gizmos::TreeGizmoPropagation::gizmo_inputs_by_node_inputs, blender::nodes::gizmos::TreeGizmoPropagation::gizmo_inputs_by_value_nodes, blender::nodes::gizmos::TreeGizmoPropagation::gizmo_nodes, blender::nodes::inverse_eval::LocalInverseEvalTargets::group_inputs, blender::nodes::inverse_eval::LocalInverseEvalTargets::input_sockets, is_builtin_gizmo_node(), tree, and blender::nodes::inverse_eval::LocalInverseEvalTargets::value_nodes.

Referenced by update_tree_gizmo_propagation().

◆ foreach_active_gizmo()

void blender::nodes::gizmos::foreach_active_gizmo	(	const bContext &	C,
		ComputeContextBuilder &	compute_context_builder,
		ForeachGizmoFn	fn )

Calls the given function for each gizmo that is active. It scans open node editors for selected or pinned gizmos and also finds the gizmos for the active object.

Definition at line 411 of file geometry_nodes_gizmos.cc.

References BASE_SELECTED, BKE_object_active_modifier(), CTX_data_active_base(), CTX_wm_manager(), eModifierMode_Realtime, eModifierType_Nodes, foreach_active_gizmo_exposed_to_modifier(), and foreach_active_gizmo_in_open_editors().

Referenced by blender::ed::space_node::find_sockets_on_active_gizmo_paths(), and blender::ed::view3d::geometry_nodes_gizmos::WIDGETGROUP_geometry_nodes_refresh().

◆ foreach_active_gizmo_exposed_to_modifier()

static void blender::nodes::gizmos::foreach_active_gizmo_exposed_to_modifier	(	const NodesModifierData &	nmd,
		ComputeContextBuilder &	compute_context_builder,
		const ForeachGizmoInModifierFn	fn )

static

Definition at line 361 of file geometry_nodes_gizmos.cc.

References BLI_SCOPED_DEFER, foreach_gizmo_for_input(), NodesModifierData::modifier, ModifierData::name, NodesModifierData::node_group, blender::ComputeContextBuilder::pop(), blender::ComputeContextBuilder::push(), and tree.

Referenced by foreach_active_gizmo(), and foreach_active_gizmo_in_modifier().

◆ foreach_active_gizmo_in_modifier()

void blender::nodes::gizmos::foreach_active_gizmo_in_modifier	(	const Object &	object,
		const NodesModifierData &	nmd,
		const wmWindowManager &	wm,
		ComputeContextBuilder &	compute_context_builder,
		ForeachGizmoInModifierFn	fn )

Similar to foreach_active_gizmo but filters the list of gizmos to those that are relevant for a specific modifier evaluation.

Definition at line 383 of file geometry_nodes_gizmos.cc.

References BLI_assert, foreach_active_gizmo_exposed_to_modifier(), foreach_active_gizmo_in_open_editors(), NodesModifierData::node_group, and UNUSED_VARS_NDEBUG.

Referenced by blender::find_side_effect_nodes_for_active_gizmos().

◆ foreach_active_gizmo_in_open_editors()

static void blender::nodes::gizmos::foreach_active_gizmo_in_open_editors	(	const wmWindowManager &	wm,
		const Object *	object_filter,
		const NodesModifierData *	nmd_filter,
		ComputeContextBuilder &	compute_context_builder,
		const ForeachGizmoFn	fn )

static

Definition at line 331 of file geometry_nodes_gizmos.cc.

References blender::Vector< T, InlineBufferCapacity, Allocator >::append(), bScreen::areabase, BKE_workspace_active_screen_get(), ELEM, ListBase::first, foreach_active_gizmo_in_open_node_editor(), LISTBASE_FOREACH, SCREENFULL, SCREENMAXIMIZED, SPACE_NODE, SpaceLink::spacetype, bScreen::state, and wmWindowManager::windows.

Referenced by foreach_active_gizmo(), and foreach_active_gizmo_in_modifier().

◆ foreach_active_gizmo_in_open_node_editor()

static void blender::nodes::gizmos::foreach_active_gizmo_in_open_node_editor	(	const SpaceNode &	snode,
		const Object *	object_filter,
		const NodesModifierData *	nmd_filter,
		ComputeContextBuilder &	compute_context_builder,
		const ForeachGizmoFn	fn )

static

Definition at line 231 of file geometry_nodes_gizmos.cc.

References blender::Set< Key, InlineBufferCapacity, ProbingStrategy, Hash, IsEqual, Slot, Allocator >::add(), blender::Set< Key, InlineBufferCapacity, ProbingStrategy, Hash, IsEqual, Slot, Allocator >::add_multiple(), BLI_SCOPED_DEFER, blender::ComputeContextBuilder::current(), SpaceNode::edittree, eModifierMode_Realtime, bNodeSocket::flag, foreach_gizmo_for_input(), blender::nodes::value_elem::get_elem_variant_for_socket_type(), blender::ed::space_node::get_modifier_for_node_editor(), blender::nodes::gizmos::TreeGizmoPropagation::gizmo_inputs_by_node_inputs, blender::nodes::gizmos::TreeGizmoPropagation::gizmo_inputs_by_value_nodes, blender::nodes::gizmos::TreeGizmoPropagation::gizmo_nodes, ModifierData::mode, NodesModifierData::modifier, ModifierData::name, NODE_SELECT, SpaceNode::nodetree, blender::ComputeContextBuilder::pop_until(), blender::ComputeContextBuilder::push(), blender::ed::space_node::push_compute_context_for_tree_path(), bNodeTree::runtime, SOCK_GIZMO_PIN, and bNodeSocket::type.

Referenced by foreach_active_gizmo_in_open_editors().

◆ foreach_compute_context_on_gizmo_path()

void blender::nodes::gizmos::foreach_compute_context_on_gizmo_path	(	const ComputeContext &	gizmo_context,
		const bNode &	gizmo_node,
		const bNodeSocket &	gizmo_socket,
		FunctionRef< void(const ComputeContext &context)>	fn )

Iterates over all compute contexts that are touched by a specific gizmo back-propagation path. This is used to make sure that all sockets on the path are logged.

Definition at line 446 of file geometry_nodes_gizmos.cc.

References blender::nodes::inverse_eval::foreach_element_on_inverse_eval_path(), and get_gizmo_socket_elem().

Referenced by blender::find_side_effect_nodes_for_active_gizmos().

◆ foreach_gizmo_for_group_input()

static void blender::nodes::gizmos::foreach_gizmo_for_group_input	(	const bNodeTree &	tree,
		const ie::GroupInputElem &	group_input,
		ComputeContextBuilder &	compute_context_builder,
		const ForeachGizmoInModifierFn	fn )

static

Definition at line 182 of file geometry_nodes_gizmos.cc.

References foreach_gizmo_for_input(), blender::nodes::gizmos::TreeGizmoPropagation::gizmo_inputs_by_group_inputs, and tree.

Referenced by foreach_gizmo_for_input().

◆ foreach_gizmo_for_input()

static void blender::nodes::gizmos::foreach_gizmo_for_input	(	const ie::SocketElem &	input_socket,
		ComputeContextBuilder &	compute_context_builder,
		const bNodeTree &	tree,
		const ForeachGizmoInModifierFn	fn )

static

Definition at line 195 of file geometry_nodes_gizmos.cc.

References blender::ComputeContextBuilder::current(), blender::nodes::value_elem::SocketElem::elem, foreach_gizmo_for_group_input(), blender::bke::bNodeTreeZones::get_zone_by_node(), is_builtin_gizmo_node(), node, blender::ComputeContextBuilder::pop(), blender::ComputeContextBuilder::push(), blender::nodes::value_elem::SocketElem::socket, tree, and blender::bke::bNodeTreeZones::zones.

Referenced by foreach_active_gizmo_exposed_to_modifier(), foreach_active_gizmo_in_open_node_editor(), and foreach_gizmo_for_group_input().

◆ foreach_socket_on_gizmo_path()

void blender::nodes::gizmos::foreach_socket_on_gizmo_path	(	const ComputeContext &	gizmo_context,
		const bNode &	gizmo_node,
		const bNodeSocket &	gizmo_socket,
		FunctionRef< void(const ComputeContext &context, const bNodeSocket &socket, const ie::ElemVariant &elem)>	fn )

Iterates over all sockets that propagate values modified by gizmos backwards. This is used to draw the links between those sockets in a special way.

Definition at line 455 of file geometry_nodes_gizmos.cc.

References blender::nodes::inverse_eval::foreach_element_on_inverse_eval_path(), and get_gizmo_socket_elem().

Referenced by blender::ed::space_node::find_sockets_on_active_gizmo_paths().

◆ get_editable_gizmo_elem()

ie::ElemVariant blender::nodes::gizmos::get_editable_gizmo_elem	(	const ComputeContext &	gizmo_context,
		const bNode &	gizmo_node,
		const bNodeSocket &	gizmo_socket )

Get the value element of a gizmo socket that can be affected by a gizmo. E.g. for the Transform Gizmo node this may report that only the rotation component can be controlled with the gizmo.

Definition at line 466 of file geometry_nodes_gizmos.cc.

References BLI_assert, blender::nodes::inverse_eval::foreach_element_on_inverse_eval_path(), blender::nodes::value_elem::get_elem_variant_for_socket_type(), get_gizmo_socket_elem(), blender::ComputeContext::hash(), blender::nodes::value_elem::ElemVariant::merge(), and bNodeSocket::type.

Referenced by blender::ed::view3d::geometry_nodes_gizmos::WIDGETGROUP_geometry_nodes_refresh().

◆ get_gizmo_socket_elem()

static ie::ElemVariant blender::nodes::gizmos::get_gizmo_socket_elem	(	const bNode &	node,
		const bNodeSocket &	socket )

static

Get the part of a socket value that may be edited with gizmos.

Definition at line 37 of file geometry_nodes_gizmos.cc.

References BLI_assert_unreachable, GEO_NODE_GIZMO_DIAL, GEO_NODE_GIZMO_LINEAR, GEO_NODE_GIZMO_TRANSFORM, GEO_NODE_TRANSFORM_GIZMO_USE_ROTATION_ALL, GEO_NODE_TRANSFORM_GIZMO_USE_SCALE_ALL, GEO_NODE_TRANSFORM_GIZMO_USE_TRANSLATION_ALL, blender::nodes::value_elem::get_elem_variant_for_socket_type(), blender::nodes::value_elem::MatrixElem::rotation, blender::nodes::value_elem::MatrixElem::scale, blender::nodes::value_elem::MatrixElem::translation, and bNodeSocket::type.

Referenced by build_tree_gizmo_propagation(), foreach_compute_context_on_gizmo_path(), foreach_socket_on_gizmo_path(), and get_editable_gizmo_elem().

◆ is_builtin_gizmo_node()

bool blender::nodes::gizmos::is_builtin_gizmo_node ( const bNode & node )

Definition at line 29 of file geometry_nodes_gizmos.cc.

References ELEM.

Referenced by build_tree_gizmo_propagation(), foreach_gizmo_for_input(), and blender::ed::space_node::std_node_socket_draw().

◆ update_tree_gizmo_propagation()

bool blender::nodes::gizmos::update_tree_gizmo_propagation ( bNodeTree & tree )

Updates the #TreeGizmoPropagation cached on the node-tree.

Returns: False, if the propagation changed.

Definition at line 158 of file geometry_nodes_gizmos.cc.

References build_tree_gizmo_propagation(), and tree.

Classes

Typedefs

Functions

Typedef Documentation

◆ ForeachGizmoFn

◆ ForeachGizmoInModifierFn

Function Documentation

◆ apply_gizmo_change() [1/2]

◆ apply_gizmo_change() [2/2]

◆ build_tree_gizmo_propagation()

◆ foreach_active_gizmo()

◆ foreach_active_gizmo_exposed_to_modifier()

◆ foreach_active_gizmo_in_modifier()

◆ foreach_active_gizmo_in_open_editors()

◆ foreach_active_gizmo_in_open_node_editor()

◆ foreach_compute_context_on_gizmo_path()

◆ foreach_gizmo_for_group_input()

◆ foreach_gizmo_for_input()

◆ foreach_socket_on_gizmo_path()

◆ get_editable_gizmo_elem()

◆ get_gizmo_socket_elem()

◆ is_builtin_gizmo_node()

◆ update_tree_gizmo_propagation()