BKE_node_runtime.hh

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2023 Blender Authors
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */

 
#pragma once
 
#include <memory>
 
#include "BLI_cache_mutex.hh"
#include "BLI_math_vector_types.hh"
#include "BLI_multi_value_map.hh"
#include "BLI_mutex.hh"
#include "BLI_set.hh"
#include "BLI_struct_equality_utils.hh"
#include "BLI_utility_mixins.hh"
#include "BLI_vector.hh"
#include "BLI_vector_set.hh"
 
#include "DNA_node_types.h"
 
#include "BKE_node.hh"
#include "BKE_node_tree_interface.hh"
 
#include "NOD_socket_usage_inference_fwd.hh"
 
struct bNode;
struct bNodeSocket;
struct bNodeTree;
 
namespace blender::nodes {
struct FieldInferencingInterface;
struct GeometryNodesEvalDependencies;
class NodeDeclaration;
struct GeometryNodesLazyFunctionGraphInfo;
struct StructureTypeInterface;
namespace anonymous_attribute_lifetime {
}
namespace aal = anonymous_attribute_lifetime;
namespace gizmos {
struct TreeGizmoPropagation;
}
}  // namespace blender::nodes
namespace blender::bke {
struct bNodeType;
class bNodeTreeZones;
}  // namespace blender::bke
 
namespace blender::bke::node_tree_reference_lifetimes {
struct ReferenceLifetimesInfo;
}
 
namespace blender::bke {
 
enum class FieldSocketState : int8_t {
  RequiresSingle,
  CanBeField,
  IsField,
};
 
struct NodeIDGetter {
  int32_t operator()(const bNode *value) const
  {
    return value->identifier;
  }
};
using NodeIDVectorSet = CustomIDVectorSet<bNode *, NodeIDGetter>;
 
struct NodeLinkError {
  std::string tooltip;
};

struct NodeLinkKey {
 private:
  int to_node_id_;
  int input_socket_index_;
  int input_link_index_;
 
 public:
  explicit NodeLinkKey(const bNodeLink &link);
 
  bNodeLink *try_find(bNodeTree &ntree) const;
  const bNodeLink *try_find(const bNodeTree &ntree) const;
 
  uint64_t hash() const
  {
    return get_default_hash(this->to_node_id_, this->input_socket_index_, this->input_link_index_);
  }
 
  BLI_STRUCT_EQUALITY_OPERATORS_3(NodeLinkKey,
                                  to_node_id_,
                                  input_socket_index_,
                                  input_link_index_);
};
 
struct LoggedZoneGraphs {
  Mutex mutex;
  Map<int, std::string> graph_by_zone_id;
};

class bNodeTreeRuntime : NonCopyable, NonMovable {
 public:
  uint32_t changed_flag = 0;
  uint32_t output_topology_hash = 0;

  uint8_t runtime_flag = 0;

  uint32_t previews_refresh_state = 0;

  std::unique_ptr<LoggedZoneGraphs> logged_zone_graphs;

  NodeIDVectorSet nodes_by_id;

  bNodeTreeExec *execdata = nullptr;
  void (*progress)(void *, float progress) = nullptr;
  void (*stats_draw)(void *, const char *str) = nullptr;
  bool (*test_break)(void *) = nullptr;
  void (*update_draw)(void *) = nullptr;
  void *tbh = nullptr, *prh = nullptr, *sdh = nullptr, *udh = nullptr;
 
  /* End legacy execution data. */

  std::unique_ptr<nodes::FieldInferencingInterface> field_inferencing_interface;
  Array<FieldSocketState> field_states;
  std::unique_ptr<node_tree_reference_lifetimes::ReferenceLifetimesInfo> reference_lifetimes_info;
  std::unique_ptr<nodes::gizmos::TreeGizmoPropagation> gizmo_propagation;
  std::unique_ptr<nodes::StructureTypeInterface> structure_type_interface;

  blender::Array<nodes::socket_usage_inference::SocketUsage> inferenced_socket_usage;
  CacheMutex inferenced_input_socket_usage_mutex;

  CacheMutex geometry_nodes_lazy_function_graph_info_mutex;
  std::unique_ptr<nodes::GeometryNodesLazyFunctionGraphInfo>
      geometry_nodes_lazy_function_graph_info;

  MultiValueMap<NodeLinkKey, NodeLinkError> link_errors;

  Map<int32_t, VectorSet<std::string>> shader_node_errors;
  Mutex shader_node_errors_mutex;

  CacheMutex topology_cache_mutex;
  std::atomic<bool> topology_cache_exists = false;
  mutable std::atomic<int> allow_use_dirty_topology_cache = 0;
 
  CacheMutex tree_zones_cache_mutex;
  std::shared_ptr<bNodeTreeZones> tree_zones;

  std::shared_ptr<bNodeTreeZones> last_valid_zones;
  Set<int> invalid_zone_output_node_ids;

  Set<const bNodeSocket *> sockets_on_active_gizmo_paths;

  std::unique_ptr<nodes::GeometryNodesEvalDependencies> geometry_nodes_eval_dependencies;

  Map<bNodeInstanceKey, bNodePreview> previews;

  Vector<bNodeLink *> links;
  Vector<bNodeSocket *> sockets;
  Vector<bNodeSocket *> input_sockets;
  Vector<bNodeSocket *> output_sockets;
  MultiValueMap<const bNodeType *, bNode *> nodes_by_type;
  Vector<bNode *> toposort_left_to_right;
  Vector<bNode *> toposort_right_to_left;
  Vector<bNode *> group_nodes;
  bool has_available_link_cycle = false;
  bool has_undefined_nodes_or_sockets = false;
  bNode *group_output_node = nullptr;
  Vector<bNode *> root_frames;
};

class bNodeSocketRuntime : NonCopyable, NonMovable {
 public:
  const nodes::SocketDeclaration *declaration = nullptr;

  uint32_t changed_flag = 0;

  short total_inputs = 0;

  nodes::StructureType inferred_structure_type = nodes::StructureType::Dynamic;

  float2 location;

  Vector<bNodeLink *> directly_linked_links;
  Vector<bNodeSocket *> directly_linked_sockets;
  Vector<bNodeSocket *> logically_linked_sockets;
  Vector<bNodeSocket *> logically_linked_skipped_sockets;
  bNode *owner_node = nullptr;
  bNodeSocket *internal_link_input = nullptr;
  int index_in_node = -1;
  int index_in_all_sockets = -1;
  int index_in_inout_sockets = -1;
};
 
struct bNodePanelExtent {
  float min_y;
  float max_y;
  bool fill_node_end = false;
};
 
class bNodePanelRuntime : NonCopyable, NonMovable {
 public:
  std::optional<float> header_center_y;
  std::optional<bNodePanelExtent> content_extent;
  bNodeSocket *input_socket = nullptr;
};

class bNodeRuntime : NonCopyable, NonMovable {
 public:
  nodes::NodeDeclaration *declaration = nullptr;

  uint32_t changed_flag = 0;

  uint8_t need_exec = 0;

  bNode *original = nullptr;

  rctf draw_bounds{};

  short tmp_flag = 0;

  char iter_flag = 0;

  int update = 0;

  float anim_ofsx;

  Vector<bNodeLink> internal_links;

  int index_in_tree = -1;

  bool forward_compatible_versioning_done = false;

  bool is_dangling_reroute = false;

  Vector<bNodeSocket *> inputs;
  Vector<bNodeSocket *> outputs;
  Map<StringRefNull, bNodeSocket *> inputs_by_identifier;
  Map<StringRefNull, bNodeSocket *> outputs_by_identifier;
  bool has_available_linked_inputs = false;
  bool has_available_linked_outputs = false;
  Vector<bNode *> direct_children_in_frame;
  bNodeTree *owner_tree = nullptr;
  int toposort_left_to_right_index = -1;
  int toposort_right_to_left_index = -1;

  Array<bNodePanelRuntime> panels;
};
 
namespace node_tree_runtime {

void preprocess_geometry_node_tree_for_evaluation(bNodeTree &tree_cow);
 
class AllowUsingOutdatedInfo : NonCopyable, NonMovable {
 private:
  const bNodeTree &tree_;
 
 public:
  AllowUsingOutdatedInfo(const bNodeTree &tree) : tree_(tree)
  {
    tree_.runtime->allow_use_dirty_topology_cache.fetch_add(1);
  }
 
  ~AllowUsingOutdatedInfo()
  {
    tree_.runtime->allow_use_dirty_topology_cache.fetch_sub(1);
  }
};
 
/* If result is not true then this means that the last node tree editing operation was not covered
 * by the topology cache update ensure call. All derivative information about topology is not
 * available. You should call "tree.ensure_topology_cache();" first.
 */
inline bool topology_cache_is_available(const bNodeTree &tree)
{
  if (!tree.runtime->topology_cache_exists) {
    return false;
  }
  if (tree.runtime->allow_use_dirty_topology_cache.load() > 0) {
    return true;
  }
  if (tree.runtime->topology_cache_mutex.is_dirty()) {
    return false;
  }
  return true;
}
 
inline bool topology_cache_is_available(const bNode &node)
{
  const bNodeTree *ntree = node.runtime->owner_tree;
  if (ntree == nullptr) {
    return false;
  }
  return topology_cache_is_available(*ntree);
}
 
inline bool topology_cache_is_available(const bNodeSocket &socket)
{
  const bNode *node = socket.runtime->owner_node;
  if (node == nullptr) {
    return false;
  }
  return topology_cache_is_available(*node);
}
 
}  // namespace node_tree_runtime
 
namespace node_field_inferencing {
bool update_field_inferencing(const bNodeTree &tree);
}
 
namespace node_structure_type_inferencing {
bool update_structure_type_interface(bNodeTree &tree);
}
 
}  // namespace blender::bke
 
/* -------------------------------------------------------------------- */
 
inline blender::Span<const bNode *> bNodeTree::all_nodes() const
{
  return this->runtime->nodes_by_id.as_span();
}
 
inline blender::Span<bNode *> bNodeTree::all_nodes()
{
  return this->runtime->nodes_by_id;
}
 
inline bNode *bNodeTree::node_by_id(const int32_t identifier)
{
  BLI_assert(identifier >= 0);
  bNode *const *node = this->runtime->nodes_by_id.lookup_key_ptr_as(identifier);
  return node ? *node : nullptr;
}
 
inline const bNode *bNodeTree::node_by_id(const int32_t identifier) const
{
  BLI_assert(identifier >= 0);
  const bNode *const *node = this->runtime->nodes_by_id.lookup_key_ptr_as(identifier);
  return node ? *node : nullptr;
}
 
inline blender::Span<bNode *> bNodeTree::nodes_by_type(const blender::StringRefNull type_idname)
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->nodes_by_type.lookup(blender::bke::node_type_find(type_idname.c_str()));
}
 
inline blender::Span<const bNode *> bNodeTree::nodes_by_type(
    const blender::StringRefNull type_idname) const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->nodes_by_type.lookup(blender::bke::node_type_find(type_idname.c_str()));
}
 
inline blender::Span<const bNode *> bNodeTree::toposort_left_to_right() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->toposort_left_to_right;
}
 
inline blender::Span<const bNode *> bNodeTree::toposort_right_to_left() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->toposort_right_to_left;
}
 
inline blender::Span<bNode *> bNodeTree::toposort_left_to_right()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->toposort_left_to_right;
}
 
inline blender::Span<bNode *> bNodeTree::toposort_right_to_left()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->toposort_right_to_left;
}
 
inline blender::Span<const bNode *> bNodeTree::group_nodes() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->group_nodes;
}
 
inline blender::Span<bNode *> bNodeTree::group_nodes()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->group_nodes;
}
 
inline bool bNodeTree::has_available_link_cycle() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->has_available_link_cycle;
}
 
inline bool bNodeTree::has_undefined_nodes_or_sockets() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->has_undefined_nodes_or_sockets;
}
 
inline bNode *bNodeTree::group_output_node()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->group_output_node;
}
 
inline const bNode *bNodeTree::group_output_node() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->group_output_node;
}
 
inline blender::Span<bNode *> bNodeTree::group_input_nodes()
{
  return this->nodes_by_type("NodeGroupInput");
}
 
inline blender::Span<const bNode *> bNodeTree::group_input_nodes() const
{
  return this->nodes_by_type("NodeGroupInput");
}
 
inline blender::Span<const bNodeSocket *> bNodeTree::all_input_sockets() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->input_sockets;
}
 
inline blender::Span<bNodeSocket *> bNodeTree::all_input_sockets()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->input_sockets;
}
 
inline blender::Span<const bNodeSocket *> bNodeTree::all_output_sockets() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->output_sockets;
}
 
inline blender::Span<bNodeSocket *> bNodeTree::all_output_sockets()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->output_sockets;
}
 
inline blender::Span<const bNodeSocket *> bNodeTree::all_sockets() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->sockets;
}
 
inline blender::Span<bNodeSocket *> bNodeTree::all_sockets()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->sockets;
}
 
inline blender::Span<bNode *> bNodeTree::root_frames() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->root_frames;
}
 
inline blender::Span<bNodeLink *> bNodeTree::all_links()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->links;
}
 
inline blender::Span<const bNodeLink *> bNodeTree::all_links() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->links;
}
 
inline blender::MutableSpan<bNestedNodeRef> bNodeTree::nested_node_refs_span()
{
  return {this->nested_node_refs, this->nested_node_refs_num};
}
 
inline blender::Span<bNestedNodeRef> bNodeTree::nested_node_refs_span() const
{
  return {this->nested_node_refs, this->nested_node_refs_num};
}
 
inline void bNodeTree::ensure_interface_cache() const
{
  this->tree_interface.ensure_items_cache();
}
 
inline blender::Span<bNodeTreeInterfaceSocket *> bNodeTree::interface_inputs()
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->inputs_;
}
 
inline blender::Span<const bNodeTreeInterfaceSocket *> bNodeTree::interface_inputs() const
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->inputs_.as_span();
}
 
inline blender::Span<bNodeTreeInterfaceSocket *> bNodeTree::interface_outputs()
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->outputs_;
}
 
inline blender::Span<const bNodeTreeInterfaceSocket *> bNodeTree::interface_outputs() const
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->outputs_.as_span();
}
 
inline blender::Span<bNodeTreeInterfaceItem *> bNodeTree::interface_items()
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->items_;
}
 
inline blender::Span<const bNodeTreeInterfaceItem *> bNodeTree::interface_items() const
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->items_.as_span();
}
 
inline int bNodeTree::interface_input_index(const bNodeTreeInterfaceSocket &io_socket) const
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->inputs_.index_of_as(&io_socket);
}
 
inline int bNodeTree::interface_output_index(const bNodeTreeInterfaceSocket &io_socket) const
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->outputs_.index_of_as(&io_socket);
}
 
inline int bNodeTree::interface_item_index(const bNodeTreeInterfaceItem &io_item) const
{
  BLI_assert(this->tree_interface.items_cache_is_available());
  return this->tree_interface.runtime->items_.index_of_as(&io_item);
}

 
/* -------------------------------------------------------------------- */
 
inline int bNode::index() const
{
  const int index = this->runtime->index_in_tree;
  /* The order of nodes should always be consistent with the `nodes_by_id` vector. */
  BLI_assert(index ==
             this->runtime->owner_tree->runtime->nodes_by_id.index_of_as(this->identifier));
  return index;
}
 
inline blender::Span<bNodeSocket *> bNode::input_sockets()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->inputs;
}
 
inline blender::Span<bNodeSocket *> bNode::output_sockets()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->outputs;
}
 
inline blender::Span<const bNodeSocket *> bNode::input_sockets() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->inputs;
}
 
inline blender::Span<const bNodeSocket *> bNode::output_sockets() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->outputs;
}
 
inline blender::IndexRange bNode::input_socket_indices_in_tree() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  const int num_inputs = this->runtime->inputs.size();
  if (num_inputs == 0) {
    return {};
  }
  return blender::IndexRange::from_begin_size(this->input_socket(0).index_in_tree(), num_inputs);
}
 
inline blender::IndexRange bNode::output_socket_indices_in_tree() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  const int num_outputs = this->runtime->outputs.size();
  if (num_outputs == 0) {
    return {};
  }
  return blender::IndexRange::from_begin_size(this->output_socket(0).index_in_tree(), num_outputs);
}
 
inline blender::IndexRange bNode::input_socket_indices_in_all_inputs() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  const int num_inputs = this->runtime->inputs.size();
  if (num_inputs == 0) {
    return {};
  }
  return blender::IndexRange::from_begin_size(this->input_socket(0).index_in_all_inputs(),
                                              num_inputs);
}
 
inline blender::IndexRange bNode::output_socket_indices_in_all_outputs() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  const int num_outputs = this->runtime->outputs.size();
  if (num_outputs == 0) {
    return {};
  }
  return blender::IndexRange::from_begin_size(this->output_socket(0).index_in_all_outputs(),
                                              num_outputs);
}
 
inline bNodeSocket &bNode::input_socket(int index)
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->inputs[index];
}
 
inline bNodeSocket &bNode::output_socket(int index)
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->outputs[index];
}
 
inline const bNodeSocket &bNode::input_socket(int index) const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->inputs[index];
}
 
inline const bNodeSocket &bNode::output_socket(int index) const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->outputs[index];
}
 
inline const bNodeSocket *bNode::input_by_identifier(blender::StringRef identifier) const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->inputs_by_identifier.lookup_default_as(identifier, nullptr);
}
 
inline const bNodeSocket *bNode::output_by_identifier(blender::StringRef identifier) const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->outputs_by_identifier.lookup_default_as(identifier, nullptr);
}
 
inline bNodeSocket *bNode::input_by_identifier(blender::StringRef identifier)
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->inputs_by_identifier.lookup_default_as(identifier, nullptr);
}
 
inline bNodeSocket *bNode::output_by_identifier(blender::StringRef identifier)
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->outputs_by_identifier.lookup_default_as(identifier, nullptr);
}
 
inline const bNodeTree &bNode::owner_tree() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->owner_tree;
}
 
inline bNodeTree &bNode::owner_tree()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->owner_tree;
}
 
inline blender::StringRefNull bNode::label_or_name() const
{
  if (this->label[0] == '\0') {
    return this->name;
  }
  return this->label;
}
 
inline bool bNode::is_muted() const
{
  return this->flag & NODE_MUTED;
}
 
inline bool bNode::is_reroute() const
{
  return this->type_legacy == NODE_REROUTE;
}
 
inline bool bNode::is_frame() const
{
  return this->type_legacy == NODE_FRAME;
}
 
inline bool bNode::is_group() const
{
  return ELEM(this->type_legacy, NODE_GROUP, NODE_CUSTOM_GROUP);
}
 
inline bool bNode::is_custom_group() const
{
  return this->type_legacy == NODE_CUSTOM_GROUP;
}
 
inline bool bNode::is_group_input() const
{
  return this->type_legacy == NODE_GROUP_INPUT;
}
 
inline bool bNode::is_group_output() const
{
  return this->type_legacy == NODE_GROUP_OUTPUT;
}
 
inline bool bNode::is_undefined() const
{
  return this->typeinfo == &blender::bke::NodeTypeUndefined;
}
 
inline bool bNode::is_type(const blender::StringRef query_idname) const
{
  return this->typeinfo->is_type(query_idname);
}
 
inline blender::Span<bNodeLink> bNode::internal_links() const
{
  return this->runtime->internal_links;
}
 
inline bool bNode::is_dangling_reroute() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->is_dangling_reroute;
}
 
inline blender::Span<bNode *> bNode::direct_children_in_frame() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  BLI_assert(this->is_frame());
  return this->runtime->direct_children_in_frame;
}
 
inline const blender::nodes::NodeDeclaration *bNode::declaration() const
{
  return this->runtime->declaration;
}
 
inline blender::Span<bNodePanelState> bNode::panel_states() const
{
  return {panel_states_array, num_panel_states};
}
 
inline blender::MutableSpan<bNodePanelState> bNode::panel_states()
{
  return {panel_states_array, num_panel_states};
}

 
/* -------------------------------------------------------------------- */
 
inline bool bNodeLink::is_muted() const
{
  return this->flag & NODE_LINK_MUTED;
}
 
inline bool bNodeLink::is_available() const
{
  return this->fromsock->is_available() && this->tosock->is_available();
}
 
inline bool bNodeLink::is_used() const
{
  return !this->is_muted() && this->is_available();
}

 
/* -------------------------------------------------------------------- */
 
inline int bNodeSocket::index() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->index_in_node;
}
 
inline int bNodeSocket::index_in_tree() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->index_in_all_sockets;
}
 
inline int bNodeSocket::index_in_all_inputs() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  BLI_assert(this->is_input());
  return this->runtime->index_in_inout_sockets;
}
 
inline int bNodeSocket::index_in_all_outputs() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  BLI_assert(this->is_output());
  return this->runtime->index_in_inout_sockets;
}
 
inline bool bNodeSocket::is_user_hidden() const
{
  return (this->flag & SOCK_HIDDEN) != 0;
}
 
inline bool bNodeSocket::is_inactive() const
{
  /* Gray out inputs that do not affect the output of the node currently.
   * Don't gray out any inputs if the node has no outputs (in which case no input can affect the
   * output). Otherwise, viewer node inputs would be inactive. */
  return this->is_input() && !this->affects_node_output() &&
         !this->owner_node().output_sockets().is_empty();
}
 
inline bool bNodeSocket::is_available() const
{
  return (this->flag & SOCK_UNAVAIL) == 0;
}
 
inline bool bNodeSocket::is_panel_collapsed() const
{
  return (this->flag & SOCK_PANEL_COLLAPSED) != 0;
}
 
inline bool bNodeSocket::is_visible() const
{
  return !this->is_user_hidden() && this->is_available() && this->inferred_socket_visibility();
}
 
inline bool bNodeSocket::is_icon_visible() const
{
  return this->is_visible() &&
         (this->owner_node().flag & NODE_COLLAPSED || !this->is_panel_collapsed());
}
 
inline bool bNodeSocket::may_be_field() const
{
  return ELEM(this->runtime->inferred_structure_type,
              blender::nodes::StructureType::Field,
              blender::nodes::StructureType::Dynamic);
}
 
inline bNode &bNodeSocket::owner_node()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->owner_node;
}
 
inline const bNodeTree &bNodeSocket::owner_tree() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->owner_node->runtime->owner_tree;
}
 
inline bNodeTree &bNodeSocket::owner_tree()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->owner_node->runtime->owner_tree;
}
 
inline blender::Span<const bNodeSocket *> bNodeSocket::logically_linked_sockets() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->logically_linked_sockets;
}
 
inline blender::Span<const bNodeLink *> bNodeSocket::directly_linked_links() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->directly_linked_links;
}
 
inline blender::Span<bNodeLink *> bNodeSocket::directly_linked_links()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->directly_linked_links;
}
 
inline blender::Span<const bNodeSocket *> bNodeSocket::directly_linked_sockets() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->directly_linked_sockets;
}
 
inline blender::Span<bNodeSocket *> bNodeSocket::directly_linked_sockets()
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return this->runtime->directly_linked_sockets;
}
 
inline bool bNodeSocket::is_directly_linked() const
{
  return !this->directly_linked_links().is_empty();
}
 
inline bool bNodeSocket::is_logically_linked() const
{
  return !this->logically_linked_sockets().is_empty();
}
 
inline const bNodeSocket *bNodeSocket::internal_link_input() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  BLI_assert(this->in_out == SOCK_OUT);
  return this->runtime->internal_link_input;
}
 
template<typename T> T *bNodeSocket::default_value_typed()
{
  return static_cast<T *>(this->default_value);
}
 
template<typename T> const T *bNodeSocket::default_value_typed() const
{
  return static_cast<const T *>(this->default_value);
}
 
inline bool bNodeSocket::is_input() const
{
  return this->in_out == SOCK_IN;
}
 
inline bool bNodeSocket::is_output() const
{
  return this->in_out == SOCK_OUT;
}
 
inline bool bNodeSocket::is_multi_input() const
{
  return this->flag & SOCK_MULTI_INPUT;
}
 
inline const bNode &bNodeSocket::owner_node() const
{
  BLI_assert(blender::bke::node_tree_runtime::topology_cache_is_available(*this));
  return *this->runtime->owner_node;
}

 
/* -------------------------------------------------------------------- */
 
inline bool bNodePanelState::is_collapsed() const
{
  return flag & NODE_PANEL_COLLAPSED;
}
 
inline bool bNodePanelState::is_parent_collapsed() const
{
  return flag & NODE_PANEL_PARENT_COLLAPSED;
}
 
inline bool bNodePanelState::has_visible_content() const
{
  return flag & NODE_PANEL_CONTENT_VISIBLE;
}