90 lines
2.6 KiB
C++
90 lines
2.6 KiB
C++
/* SPDX-FileCopyrightText: 2024 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
#include "BLI_map.hh"
|
|
|
|
namespace blender {
|
|
|
|
struct ID;
|
|
struct Object;
|
|
struct bNodeTree;
|
|
|
|
namespace nodes {
|
|
|
|
/**
|
|
* Gathers dependencies that the node tree requires before it can be evaluated.
|
|
*/
|
|
struct EvalDependencies {
|
|
/**
|
|
* Stores additional dependency information for objects. It can be more efficient to only depend
|
|
* on an object partially.
|
|
*/
|
|
struct ObjectDependencyInfo {
|
|
bool transform = false;
|
|
bool geometry = false;
|
|
bool camera_parameters = false;
|
|
bool pose = false;
|
|
|
|
friend bool operator==(const ObjectDependencyInfo &a, const ObjectDependencyInfo &b) = default;
|
|
};
|
|
static constexpr ObjectDependencyInfo all_object_deps{true, true, true, true};
|
|
|
|
/**
|
|
* Maps `session_uid` to the corresponding data-block.
|
|
* The data-block pointer is not used as key in this map, so that it can be modified in
|
|
* #node_foreach_id.
|
|
*/
|
|
Map<uint32_t, ID *> ids;
|
|
|
|
/** Additional information for object dependencies. */
|
|
Map<uint32_t, ObjectDependencyInfo> objects_info;
|
|
|
|
bool needs_own_transform = false;
|
|
bool needs_active_camera = false;
|
|
bool needs_scene_render_params = false;
|
|
bool time_dependent = false;
|
|
|
|
/**
|
|
* Adds a generic data-block dependency. Note that this does not add a dependency to e.g. the
|
|
* transform or geometry of an object. If that is desired, use #add_object or
|
|
* #add_generic_id_full instead.
|
|
*/
|
|
void add_generic_id(ID *id);
|
|
|
|
/**
|
|
* Adds a data-block as dependency. For objects, it also adds a dependency to the transform and
|
|
* geometry.
|
|
*/
|
|
void add_generic_id_full(ID *id);
|
|
|
|
/**
|
|
* Add an object as dependency. It's customizable whether e.g. the transform and/or geometry is
|
|
* required.
|
|
*/
|
|
void add_object(Object *object, const ObjectDependencyInfo &object_deps = all_object_deps);
|
|
|
|
/**
|
|
* Add all the given dependencies to this one.
|
|
*/
|
|
void merge(const EvalDependencies &other);
|
|
|
|
friend bool operator==(const EvalDependencies &a, const EvalDependencies &b) = default;
|
|
};
|
|
|
|
/**
|
|
* Finds all evaluation dependencies for the given node. This does not include dependencies that
|
|
* are passed into the node group. It also may not contain all data-blocks referenced by the node
|
|
* tree if some of them can statically be detected to not be used by the evaluation.
|
|
*/
|
|
EvalDependencies gather_eval_dependencies_recursive(const bNodeTree &ntree);
|
|
/**
|
|
* Same as above, but assumes that dependencies are already cached on the referenced node groups.
|
|
*/
|
|
EvalDependencies gather_eval_dependencies_with_cache(const bNodeTree &ntree);
|
|
|
|
} // namespace nodes
|
|
} // namespace blender
|