deg_node_component.hh

Go to the documentation of this file.

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

 
#pragma once
 
#include "BLI_span.hh"
#include "BLI_string_ref.hh"
#include "BLI_struct_equality_utils.hh"
#include "intern/eval/deg_eval_copy_on_write.h"
#include "intern/node/deg_node.hh"
#include "intern/node/deg_node_id.hh"
#include "intern/node/deg_node_operation.hh"
 
#include "BLI_map.hh"
#include "BLI_vector.hh"
 
struct ID;
struct bPoseChannel;
 
namespace blender::deg {
 
struct Depsgraph;
struct IDNode;
struct OperationNode;
 
/* ID Component - Base type for all components */
struct ComponentNode : public Node {
  /* Key used to look up operations within a component */
  struct OperationIDKey {
    OperationCode opcode = OperationCode::OPERATION;
    int name_tag = -1;
    StringRef name = "";
 
    OperationIDKey() = default;
    OperationIDKey(const OperationCode opcode) : opcode(opcode) {}
    OperationIDKey(const OperationCode opcode, const StringRef name, const int name_tag)
        : opcode(opcode), name_tag(name_tag), name(name)
    {
    }
 
    std::string identifier() const;
    BLI_STRUCT_EQUALITY_OPERATORS_3(OperationIDKey, opcode, name_tag, name);
    uint64_t hash() const
    {
      return get_default_hash(opcode, name_tag, name);
    }
  };
 
  /* Typedef for container of operations */
  ComponentNode();
  ~ComponentNode() override;

  void init(const ID *id, const char *subdata) override;
 
  std::string identifier() const override;
 
  /* Find an existing operation, if requested operation does not exist nullptr will be returned.
   * See #add_operation for the meaning and examples of #name and #name_tag.
   */
  OperationNode *find_operation(OperationIDKey key) const;
  OperationNode *find_operation(OperationCode opcode,
                                StringRef name = "",
                                int name_tag = -1) const;
 
  /* Find an existing operation, will throw an assert() if it does not exist.
   * See #add_operation for the meaning and examples of #name and #name_tag. */
  OperationNode *get_operation(OperationIDKey key) const;
  OperationNode *get_operation(OperationCode opcode, StringRef name = "", int name_tag = -1) const;
 
  /* Check operation exists and return it. */
  bool has_operation(OperationIDKey key) const;
  bool has_operation(OperationCode opcode, StringRef name = "", int name_tag = -1) const;

  OperationNode *add_operation(const DepsEvalOperationCb &op,
                               OperationCode opcode,
                               const StringRef name = "",
                               int name_tag = -1);
 
  /* Entry/exit operations management.
   *
   * Use those instead of direct set since this will perform sanity checks. */
  void set_entry_operation(OperationNode *op_node);
  void set_exit_operation(OperationNode *op_node);
 
  void clear_operations();
 
  void tag_update(Depsgraph *graph, eUpdateSource source) override;
 
  OperationNode *get_entry_operation() override;
  OperationNode *get_exit_operation() override;
 
  void finalize_build(Depsgraph *graph);
 
  IDNode *owner;
 
  /* ** Inner nodes for this component ** */
 
  /* Operations stored as a hash map, for faster build.
   * This hash map will be freed when graph is fully built. */
  Map<ComponentNode::OperationIDKey, OperationNode *> *operations_map;
 
  /* This is a "normal" list of operations, used by evaluation
   * and other routines after construction. */
  Vector<OperationNode *> operations;
 
  OperationNode *entry_operation;
  OperationNode *exit_operation;
 
  virtual bool depends_on_cow()
  {
    return true;
  }
 
  /* Denotes whether copy-on-eval component is to be tagged when this component
   * is tagged for update. */
  virtual bool need_tag_cow_before_update(const IDRecalcFlag /*tag*/)
  {
    return true;
  }
 
  /* The component has (possibly indirect) effect on a data-block whose node has
   * is_visible_on_build set to true.
   *
   * This field is ensured to be up-to-date prior to `IDNode::finalize_build()`. */
  bool possibly_affects_visible_id;
 
  /* Denotes whether this component actually affects (possibly indirectly) on a directly visible
   * object. Includes possibly run-time visibility update of ID nodes.
   *
   * NOTE: Is only reliable after `deg_graph_flush_visibility()`. */
  bool affects_visible_id;
};
 
/* ---------------------------------------- */
 
#define DEG_COMPONENT_NODE_DEFINE_TYPEINFO(NodeType, type_, type_name_, id_recalc_tag) \
  const Node::TypeInfo NodeType::typeinfo = Node::TypeInfo(type_, type_name_, id_recalc_tag)
 
#define DEG_COMPONENT_NODE_DECLARE DEG_DEPSNODE_DECLARE
 
#define DEG_COMPONENT_NODE_DEFINE(name, NAME, id_recalc_tag) \
  DEG_COMPONENT_NODE_DEFINE_TYPEINFO( \
      name##ComponentNode, NodeType::NAME, #name " Component", id_recalc_tag); \
  static DepsNodeFactoryImpl<name##ComponentNode> DNTI_##NAME
 
#define DEG_COMPONENT_NODE_DECLARE_GENERIC(name) \
  struct name##ComponentNode : public ComponentNode { \
    DEG_COMPONENT_NODE_DECLARE; \
  }
 
#define DEG_COMPONENT_NODE_DECLARE_NO_COW_TAG_ON_UPDATE(name) \
  struct name##ComponentNode : public ComponentNode { \
    DEG_COMPONENT_NODE_DECLARE; \
    virtual bool need_tag_cow_before_update(const IDRecalcFlag /*tag*/) \
    { \
      return false; \
    } \
  }
 
#define DEG_COMPONENT_NODE_DECLARE_NO_COW(name) \
  struct name##ComponentNode : public ComponentNode { \
    DEG_COMPONENT_NODE_DECLARE; \
    virtual bool depends_on_cow() \
    { \
      return false; \
    } \
  }
 
DEG_COMPONENT_NODE_DECLARE_GENERIC(Animation);
DEG_COMPONENT_NODE_DECLARE_NO_COW_TAG_ON_UPDATE(BatchCache);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Cache);
DEG_COMPONENT_NODE_DECLARE_GENERIC(CopyOnWrite);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Geometry);
DEG_COMPONENT_NODE_DECLARE_GENERIC(ImageAnimation);
DEG_COMPONENT_NODE_DECLARE_GENERIC(LayerCollections);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Particles);
DEG_COMPONENT_NODE_DECLARE_GENERIC(ParticleSettings);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Pose);
DEG_COMPONENT_NODE_DECLARE_GENERIC(PointCache);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Sequencer);
DEG_COMPONENT_NODE_DECLARE_NO_COW_TAG_ON_UPDATE(Shading);
DEG_COMPONENT_NODE_DECLARE_GENERIC(ShadingParameters);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Transform);
DEG_COMPONENT_NODE_DECLARE_NO_COW_TAG_ON_UPDATE(ObjectFromLayer);
DEG_COMPONENT_NODE_DECLARE_NO_COW_TAG_ON_UPDATE(Hierarchy);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Instancing);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Synchronization);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Armature);
DEG_COMPONENT_NODE_DECLARE_GENERIC(GenericDatablock);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Scene);
DEG_COMPONENT_NODE_DECLARE_NO_COW_TAG_ON_UPDATE(Visibility);
DEG_COMPONENT_NODE_DECLARE_GENERIC(Simulation);
DEG_COMPONENT_NODE_DECLARE_GENERIC(NTreeOutput);
DEG_COMPONENT_NODE_DECLARE_GENERIC(NTreeGeometryPreprocess);
 
/* Bone Component */
struct BoneComponentNode : public ComponentNode {
  void init(const ID *id, const char *subdata) override;
 
  struct bPoseChannel *pchan; /* the bone that this component represents */
 
  DEG_COMPONENT_NODE_DECLARE;
};
 
/* Eventually we would not tag parameters in all cases.
 * Support for this each ID needs to be added on an individual basis. */
struct ParametersComponentNode : public ComponentNode {
  bool need_tag_cow_before_update(const IDRecalcFlag /*tag*/) override
  {
    if (ID_TYPE_SUPPORTS_PARAMS_WITHOUT_COW(owner->id_type)) {
      /* Disabled as this is not true for newly added objects, needs investigation. */
      // BLI_assert(deg_eval_copy_is_expanded(owner->id_cow));
      return false;
    }
    return true;
  }
 
  DEG_COMPONENT_NODE_DECLARE;
};
 
/* Audio component. */
struct AudioComponentNode : public ComponentNode {
  bool need_tag_cow_before_update(const IDRecalcFlag tag) override
  {
    /* Frame change doesn't require a copy of the scene, doing so can be a heavy operation
     * especially when the collection contains many objects, see #104798. */
    return (tag != ID_RECALC_FRAME_CHANGE);
  }
 
  DEG_COMPONENT_NODE_DECLARE;
};
 
void deg_register_component_depsnodes();
 
}  // namespace blender::deg