|
Blender V5.3
|
#include <BKE_node_socket_value.hh>
Public Member Functions | |
| SocketValueVariant ()=default | |
| template<typename T> requires (std::is_trivial_v<std::decay_t<T>> || is_same_any_v<std::decay_t<T>, std::string>) | |
| SocketValueVariant (T &&value) | |
| template<typename T, typename... Args> | |
| T & | emplace (Args &&...args) |
| template<typename T> | |
| T * | try_convert () |
| void * | try_convert (const CPPType &type) |
| template<typename T> | |
| T & | ensure_type () |
| void * | ensure_type (const CPPType &type) |
| template<typename T> | |
| T | copy_as () const |
| template<typename T> | |
| T | extract () |
| template<typename T> | |
| const T * | get_if () const |
| template<typename T> | |
| T * | get_if () |
| const void * | get_if (const CPPType &type) const |
| void * | get_if (const CPPType &type) |
| GPointer | get () const |
| GMutablePointer | get () |
| bool | is_context_dependent_field () const |
| bool | is_field () const |
| bool | is_volume_grid () const |
| bool | is_single () const |
| bool | is_list () const |
| void | ensure_owns_direct_data () |
| bool | owns_direct_data () const |
| void * | allocate_single (const CPPType &type) |
| void | count_memory (MemoryCounter &memory) const |
Static Public Member Functions | |
| template<typename T> | |
| static SocketValueVariant & | construct_in (void *ptr, T &&value) |
| template<typename T> | |
| static SocketValueVariant | from (T &&value) |
| template<typename T> | |
| static T & | init_default (detail::SocketValueVariantAny &value) |
| static void * | init_default (const CPPType &type, detail::SocketValueVariantAny &value) |
| static void * | allocate (const CPPType &type, detail::SocketValueVariantAny &value) |
SocketValueVariant is used to pass data between nodes, e.g. by geometry nodes in the lazy function evaluator. Specifically, it is the container type for the following socket types: bool, float, integer, vector, rotation, color and string.
The data passed through e.g. an integer socket can be a single value, a field or a grid (and in the lists and images). Each of those is stored differently, but this container can store them all.
A key requirement for this container is that it is type-erased, i.e. not all code that uses it has to include all the headers required to process the other storage types. This is achieved by using the Any type and by providing templated accessors that are implemented outside of a header.
This container is also able to do implicit conversions between the different types, with the ensure_type() methods.
Definition at line 83 of file BKE_node_socket_value.hh.
|
default |
Create an empty variant. This is not valid for any socket type yet.
References allocate(), allocate_single(), construct_in(), copy_as(), count_memory(), emplace(), ensure_owns_direct_data(), ensure_type(), extract(), from(), get(), get_if(), is_context_dependent_field(), is_field(), is_list(), blender::is_same_any_v, is_single(), is_volume_grid(), owns_direct_data(), SocketValueVariant(), T, and try_convert().
Referenced by construct_in(), copy_as(), from(), and SocketValueVariant().
|
inlineexplicit |
Create a variant based on the given value. This works for primitive types. For more complex types, one can use the from or construct_in utilities.
Definition at line 206 of file BKE_node_socket_value.hh.
References emplace(), blender::is_same_any_v, and T.
|
static |
Definition at line 476 of file node_socket_value.cc.
References blender::Any< ExtraInfo, InlineBufferCapacity, Alignment, ExtraData >::allocate(), BLI_assert_unreachable, blender::CPPType::is(), and SOCKET_VALUE_SINGLE_TYPES.
Referenced by allocate_single(), SocketValueVariant(), and blender::bke::detail::SocketValueVariantTypeInfo::try_convert_fn().
| void * blender::bke::SocketValueVariant::allocate_single | ( | const CPPType & | type | ) |
Replaces the stored value with a new uninitialized single value for the given socket type. The caller is responsible to construct the value in the returned memory before it is used.
Definition at line 500 of file node_socket_value.cc.
References allocate().
Referenced by blender::nodes::inverse_eval::convert_single_socket_value(), blender::nodes::execute_multi_function_on_value_variant__list_individual(), blender::nodes::execute_multi_function_on_value_variant__single(), blender::nodes::node_geo_list_get_item_cc::get_single_item(), blender::nodes::node_geo_sample_index_cc::node_geo_exec(), blender::nodes::LazyFunctionForForeachGeometryElementZone::prepare_components(), and SocketValueVariant().
|
inlinestatic |
Construct a SocketValueVariant at the given pointer from the given value.
Definition at line 213 of file BKE_node_socket_value.hh.
References emplace(), SocketValueVariant(), and T.
Referenced by blender::nodes::implicit_field_inputs::handle_left(), blender::nodes::implicit_field_inputs::handle_right(), blender::nodes::implicit_field_inputs::id_or_index(), blender::nodes::implicit_field_inputs::index(), blender::nodes::implicit_field_inputs::instance_transform(), blender::nodes::implicit_field_inputs::normal(), blender::nodes::implicit_field_inputs::position(), and SocketValueVariant().
Equivalent to calling extract<T>() on a copy of this value.
Definition at line 287 of file BKE_node_socket_value.hh.
References SocketValueVariant(), and T.
Referenced by blender::nodes::LazyFunctionForEnableOutputSocketUsage::execute_impl(), blender::nodes::LazyFunctionForIndexSwitchSocketUsage::execute_impl(), blender::nodes::LazyFunctionForSwitchSocketUsage::execute_impl(), blender::nodes::node_geo_enable_output_cc::LazyFunctionForEnableOutputNode::execute_impl(), blender::nodes::node_geo_menu_switch_cc::LazyFunctionForMenuSwitchSocketUsage::execute_impl(), blender::nodes::node_geo_warning_cc::LazyFunctionForWarningNode::execute_impl(), blender::nodes::execute_multi_function_on_value_variant__list_individual(), blender::nodes::node_geo_viewer_cc::log_viewer_attribute(), blender::nodes::inverse_eval::set_modifier_value(), blender::nodes::inverse_eval::set_socket_value(), blender::nodes::inverse_eval::set_value_node_value(), SocketValueVariant(), and blender::nodes::node_geo_simulation_cc::sim_output_node::LazyFunctionForSimulationOutputNode::store_new_state().
| void blender::bke::SocketValueVariant::count_memory | ( | MemoryCounter & | memory | ) | const |
Definition at line 591 of file node_socket_value.cc.
References blender::memory_counter::MemoryCounter::add(), count_memory(), get(), blender::GPointer::get(), blender::CPPType::is(), blender::CPPType::size, and blender::GPointer::type().
Referenced by count_memory(), and SocketValueVariant().
|
inline |
Replace the stored value by constructing the given type in the storage.
Definition at line 227 of file BKE_node_socket_value.hh.
References T.
Referenced by construct_in(), blender::bke::socket_value_visitor::RecursiveVisitor::edit_SocketValueVariant(), blender::nodes::execute_multi_function_on_value_variant__list(), from(), SocketValueVariant(), and SocketValueVariant().
| void blender::bke::SocketValueVariant::ensure_owns_direct_data | ( | ) |
Also see GeomtrySet::ensure_owns_direct_data.
Definition at line 547 of file node_socket_value.cc.
References blender::BLI_assert(), blender::nodes::Bundle::ensure_owns_direct_data(), get(), blender::nodes::GListPtr::get(), is_list(), and owns_direct_data().
Referenced by blender::nodes::GList::ensure_owns_direct_data(), blender::nodes::LazyFunctionForClosureZone::execute_impl(), blender::nodes::node_geo_viewer_cc::geo_viewer_node_log_impl(), SocketValueVariant(), and blender::bke::socket_value_visitor::tests::TEST_F().
Try to convert the stored value to the given type, creating the type's default value if the conversion does not exist.
Definition at line 271 of file BKE_node_socket_value.hh.
References get_if(), T, and try_convert().
Referenced by blender::nodes::node_geo_switch_cc::LazyFunctionForSwitchNode::execute_field(), blender::nodes::node_geo_index_switch_cc::LazyFunctionForIndexSwitchNode::execute_impl(), blender::nodes::node_geo_menu_switch_cc::LazyFunctionForMenuSwitchNode::execute_impl(), blender::nodes::node_geo_menu_switch_cc::LazyFunctionMenuSwitchBooleanOutputs::execute_impl(), blender::nodes::node_geo_switch_cc::LazyFunctionForSwitchNode::execute_impl(), blender::nodes::execute_multi_function_on_value_variant__single(), extract(), blender::nodes::GeoNodeExecParams::extract_input(), blender::nodes::find_output_attributes_to_store(), blender::nodes::GeoNodeExecParams::get_input(), blender::nodes::inverse_eval::InverseEvalParams::get_input(), blender::nodes::inverse_eval::InverseEvalParams::get_output(), blender::nodes::LazyFunctionForReduceForeachGeometryElement::handle_main_items_and_geometry(), blender::nodes::LazyFunctionForRepeatZone::initialize_execution_graph(), blender::geometry::mix_socket_values(), blender::nodes::node_geo_set_grid_background::node_geo_exec(), SocketValueVariant(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::ed::view3d::geometry_nodes_gizmos::TransformGizmos::update_rotate_transform_and_target_property(), blender::ed::view3d::geometry_nodes_gizmos::TransformGizmos::update_scale_transform_and_target_property(), blender::ed::view3d::geometry_nodes_gizmos::DialGizmo::update_target_property(), blender::ed::view3d::geometry_nodes_gizmos::LinearGizmo::update_target_property(), and blender::ed::view3d::geometry_nodes_gizmos::TransformGizmos::update_translate_transform_and_target_property().
|
inline |
Definition at line 279 of file BKE_node_socket_value.hh.
References try_convert().
Get the stored value as a specific type. For convenience this allows accessing the stored type as a different type, using implicit conversions as possible.
This method may leave the variant empty, in a moved from state or unchanged. Therefore, this should only be called once.
Definition at line 368 of file BKE_node_socket_value.hh.
References ensure_type(), and T.
Referenced by blender::bke::socket_value_visitor::RecursiveVisitor::edit_SocketValueVariant(), blender::nodes::node_geo_warning_cc::LazyFunctionForWarningNode::execute_impl(), blender::nodes::node_geo_sort_list_cc::get_varray_or_evaluate(), blender::nodes::eval_log::NodeTreeLogger::log_value(), blender::geometry::mix_socket_values_same_type(), blender::nodes::node_geo_tag_filter_cc::node_geo_exec(), and SocketValueVariant().
|
inlinestatic |
Create a new SocketValueVariant from the given value.
Definition at line 220 of file BKE_node_socket_value.hh.
References emplace(), SocketValueVariant(), and T.
Referenced by blender::nodes::create_nested_bundle_item(), blender::bke::bake::deserialize_bake_item(), blender::bke::bake::deserialize_value_list(), blender::nodes::execute_geometry_nodes_on_geometry(), blender::nodes::LazyFunctionForClosureZone::execute_impl(), blender::nodes::execute_multi_function_on_value_variant__field(), blender::nodes::init_socket_cpp_value(), blender::nodes::load_attribute_field_input(), blender::nodes::load_data_block_input(), blender::ed::spreadsheet::lookup_bundle_path(), blender::geometry::mix_socket_values_same_type(), blender::compositor::BundleItem::new_bundle_item_value(), blender::nodes::node_geo_closure_to_list_cc::node_geo_exec(), blender::nodes::node_geo_curve_sample_cc::node_geo_exec(), blender::nodes::node_geo_sample_index_cc::node_geo_exec(), blender::ed::spreadsheet::root_display_data_get(), blender::nodes::inverse_eval::InverseEvalParams::set_input(), SocketValueVariant(), blender::bke::bake::tests::TEST_F(), blender::bke::socket_value_visitor::tests::TEST_F(), blender::bke::socket_value_visitor::tests::TEST_F(), and blender::nodes::to_stored_type().
|
inline |
Definition at line 349 of file BKE_node_socket_value.hh.
References blender::CPPType::get(), and blender::bke::detail::SocketValueVariantTypeInfo::type.
|
inline |
Get the stored value as a GPointer.
Definition at line 340 of file BKE_node_socket_value.hh.
References blender::CPPType::get(), and blender::bke::detail::SocketValueVariantTypeInfo::type.
Referenced by blender::nodes::BundleItemValue::as(), blender::nodes::BundleItemValue::as_pointer(), blender::ed::spreadsheet::GeometryDataSetTreeView::build_socket_value(), blender::ed::spreadsheet::ViewerDataTreeView::build_value(), blender::bke::socket_value_visitor::RecursiveVisitor::check_SocketValueVariant(), count_memory(), blender::ed::spreadsheet::data_source_from_geometry(), blender::ed::spreadsheet::data_source_from_socket_value(), blender::ed::spreadsheet::SpreadsheetLayoutDrawer::draw_content_cell_value(), blender::nodes::node_geo_viewer_cc::draw_from_viewer_log_value(), blender::bke::socket_value_visitor::RecursiveVisitor::edit_SocketValueVariant(), ensure_owns_direct_data(), blender::nodes::execute_multi_function_on_value_variant__list(), blender::nodes::get_geometry_nodes_input_inference_values(), is_field(), is_list(), is_single(), is_volume_grid(), blender::nodes::eval_log::NodeTreeLogger::log_value(), blender::nodes::node_geo_viewer_cc::log_viewer_attribute(), blender::geometry::mix_socket_values(), blender::geometry::mix_socket_values_same_type(), owns_direct_data(), blender::ed::spreadsheet::root_display_data_get(), blender::ed::spreadsheet::root_geometry_set_get(), blender::bke::bake::serialize_socket_value_variant(), blender::nodes::socket_type_for_value_variant(), SocketValueVariant(), and blender::bke::bake::value_variant_valid_for_socket().
Definition at line 315 of file BKE_node_socket_value.hh.
References T.
Return a pointer to the stored value if it is of the given type. Otherwise return null.
Definition at line 293 of file BKE_node_socket_value.hh.
References blender::CPPType::get(), blender::bke::detail::SocketValueVariantTypeInfo::is_interpretable_as, T, and blender::bke::detail::SocketValueVariantTypeInfo::type.
Referenced by blender::bke::socket_value_visitor::RecursiveVisitor::check_SocketValueVariant(), blender::nodes::inverse_eval::convert_single_socket_value(), ensure_type(), blender::nodes::execute_multi_function_on_value_variant__list(), blender::nodes::execute_multi_function_on_value_variant__list_individual(), is_context_dependent_field(), blender::nodes::eval_log::NodeTreeLogger::log_value(), blender::geometry::mix_socket_values(), blender::geometry::mix_socket_values_same_type(), blender::ed::spreadsheet::root_geometry_set_get(), blender::bke::bake::serialize_socket_value_variant(), blender::nodes::socket_type_for_value_variant(), SocketValueVariant(), blender::bke::bake::tests::TEST_F(), blender::bke::tests::TEST_F(), blender::bke::tests::TEST_F(), and blender::bke::bake::value_variant_valid_for_socket().
|
inline |
Definition at line 335 of file BKE_node_socket_value.hh.
|
inline |
Definition at line 320 of file BKE_node_socket_value.hh.
References blender::bke::detail::SocketValueVariantTypeInfo::is_interpretable_as, and blender::bke::detail::SocketValueVariantTypeInfo::type.
|
static |
Definition at line 431 of file node_socket_value.cc.
References blender::CPPType::is(), SOCKET_VALUE_FIELD_AND_LIST_TYPES, and SOCKET_VALUE_SINGLE_TYPES.
|
inlinestatic |
Definition at line 373 of file node_socket_value.cc.
References blender::Any< ExtraInfo, InlineBufferCapacity, Alignment, ExtraData >::emplace(), blender::CPPType::get(), and T.
| bool blender::bke::SocketValueVariant::is_context_dependent_field | ( | ) | const |
If true, the stored value cannot be converted to a single value without loss of information.
Definition at line 538 of file node_socket_value.cc.
References blender::fn::GField::depends_on_input(), and get_if().
Referenced by blender::ed::spreadsheet::data_source_from_socket_value(), blender::nodes::LazyFunctionForIndexSwitchSocketUsage::execute_impl(), blender::nodes::LazyFunctionForSwitchSocketUsage::execute_impl(), blender::nodes::node_geo_index_switch_cc::LazyFunctionForIndexSwitchNode::execute_impl(), blender::nodes::node_geo_menu_switch_cc::LazyFunctionForMenuSwitchNode::execute_impl(), blender::nodes::node_geo_menu_switch_cc::LazyFunctionForMenuSwitchSocketUsage::execute_impl(), blender::nodes::node_geo_switch_cc::LazyFunctionForSwitchNode::execute_impl(), blender::nodes::execute_multi_function_on_value_variant(), blender::nodes::execute_multi_function_on_value_variant__list(), blender::nodes::execute_multi_function_on_value_variant__list_individual(), blender::nodes::node_geo_sort_list_cc::get_varray_or_evaluate(), blender::nodes::eval_log::NodeTreeLogger::log_value(), blender::ed::spreadsheet::root_display_data_get(), blender::bke::bake::serialize_socket_value_variant(), and SocketValueVariant().
| bool blender::bke::SocketValueVariant::is_field | ( | ) | const |
If true, the value is stored as a GField.
Definition at line 520 of file node_socket_value.cc.
References get(), blender::CPPType::is(), and blender::GPointer::type().
Referenced by blender::bke::socket_value_visitor::RecursiveVisitor::check_SocketValueVariant(), blender::bke::socket_value_visitor::RecursiveVisitor::edit_SocketValueVariant(), blender::nodes::node_geo_viewer_cc::log_viewer_attribute(), blender::nodes::socket_type_for_value_variant(), SocketValueVariant(), and blender::bke::bake::value_variant_valid_for_socket().
| bool blender::bke::SocketValueVariant::is_list | ( | ) | const |
The stored value is a list.
Definition at line 525 of file node_socket_value.cc.
References get(), blender::CPPType::is(), and blender::GPointer::type().
Referenced by blender::bke::socket_value_visitor::RecursiveVisitor::check_SocketValueVariant(), blender::ed::spreadsheet::data_source_from_socket_value(), blender::bke::socket_value_visitor::RecursiveVisitor::edit_SocketValueVariant(), ensure_owns_direct_data(), blender::nodes::execute_multi_function_on_value_variant(), blender::nodes::execute_multi_function_on_value_variant__list(), blender::nodes::execute_multi_function_on_value_variant__list_individual(), blender::nodes::node_geo_sort_list_cc::get_varray_or_evaluate(), blender::nodes::eval_log::NodeTreeLogger::log_value(), blender::geometry::mix_socket_values(), blender::geometry::mix_socket_values_same_type(), blender::nodes::node_geo_tag_filter_cc::node_geo_exec(), owns_direct_data(), blender::ed::spreadsheet::root_display_data_get(), blender::bke::bake::serialize_socket_value_variant(), blender::nodes::socket_type_for_value_variant(), SocketValueVariant(), and blender::bke::bake::value_variant_valid_for_socket().
| bool blender::bke::SocketValueVariant::is_single | ( | ) | const |
The stored value is a single value.
Definition at line 505 of file node_socket_value.cc.
References get(), SOCKET_VALUE_SINGLE_TYPES, and blender::GPointer::type().
Referenced by blender::ed::spreadsheet::GeometryDataSetTreeView::build_socket_value(), blender::ed::spreadsheet::ViewerDataTreeView::build_value(), blender::bke::socket_value_visitor::RecursiveVisitor::check_SocketValueVariant(), blender::ed::spreadsheet::data_source_from_geometry(), blender::ed::spreadsheet::data_source_from_socket_value(), blender::ed::spreadsheet::SpreadsheetLayoutDrawer::draw_content_cell_value(), blender::nodes::node_geo_viewer_cc::draw_from_viewer_log_value(), blender::bke::socket_value_visitor::RecursiveVisitor::edit_SocketValueVariant(), blender::nodes::LazyFunctionForEnableOutputSocketUsage::execute_impl(), blender::nodes::node_geo_enable_output_cc::LazyFunctionForEnableOutputNode::execute_impl(), blender::nodes::node_geo_menu_switch_cc::LazyFunctionMenuSwitchBooleanOutputs::execute_impl(), blender::nodes::execute_multi_function_on_value_variant__list(), blender::nodes::execute_multi_function_on_value_variant__list_individual(), blender::nodes::get_geometry_nodes_input_inference_values(), blender::nodes::node_geo_viewer_cc::log_viewer_attribute(), blender::geometry::mix_socket_values_same_type(), blender::ed::spreadsheet::root_display_data_get(), blender::ed::spreadsheet::root_geometry_set_get(), blender::bke::bake::serialize_socket_value_variant(), SocketValueVariant(), and blender::bke::bake::value_variant_valid_for_socket().
| bool blender::bke::SocketValueVariant::is_volume_grid | ( | ) | const |
The stored value is a volume grid.
Definition at line 529 of file node_socket_value.cc.
References get(), blender::CPPType::is(), and blender::GPointer::type().
Referenced by blender::ed::spreadsheet::data_source_from_socket_value(), blender::nodes::execute_multi_function_on_value_variant(), blender::nodes::eval_log::NodeTreeLogger::log_value(), blender::ed::spreadsheet::root_display_data_get(), blender::bke::bake::serialize_socket_value_variant(), SocketValueVariant(), and blender::bke::bake::value_variant_valid_for_socket().
| bool blender::bke::SocketValueVariant::owns_direct_data | ( | ) | const |
Definition at line 572 of file node_socket_value.cc.
References get(), blender::nodes::GListPtr::get(), and is_list().
Referenced by ensure_owns_direct_data(), SocketValueVariant(), and blender::bke::socket_value_visitor::tests::TEST_F().
Try to convert the stored value to the given type, returning null if the implicit conversion does not exist.
Definition at line 235 of file BKE_node_socket_value.hh.
References blender::BLI_assert(), blender::bke::detail::SocketValueVariantTypeInfo::convert_to, blender::CPPType::get(), blender::bke::detail::SocketValueVariantTypeInfo::is_interpretable_as, T, and blender::bke::detail::SocketValueVariantTypeInfo::type.
Referenced by ensure_type(), ensure_type(), and SocketValueVariant().
|
inline |
Definition at line 256 of file BKE_node_socket_value.hh.
References blender::bke::detail::SocketValueVariantTypeInfo::convert_to, and blender::bke::detail::SocketValueVariantTypeInfo::type.