diff options
Diffstat (limited to 'source/blender/depsgraph/DEG_depsgraph_build.h')
-rw-r--r-- | source/blender/depsgraph/DEG_depsgraph_build.h | 53 |
1 files changed, 32 insertions, 21 deletions
diff --git a/source/blender/depsgraph/DEG_depsgraph_build.h b/source/blender/depsgraph/DEG_depsgraph_build.h index c029d203574..0461d8b63fd 100644 --- a/source/blender/depsgraph/DEG_depsgraph_build.h +++ b/source/blender/depsgraph/DEG_depsgraph_build.h @@ -50,37 +50,43 @@ extern "C" { /* Graph Building -------------------------------- */ -/* Build depsgraph for the given scene, and dump results in given graph container. */ +/** Build depsgraph for the given scene layer, and dump results in given graph container. */ void DEG_graph_build_from_view_layer(struct Depsgraph *graph); -/* Build depsgraph for all objects (so also invisible ones) in the given view layer. */ +/** + * Build depsgraph for all objects (so also invisible ones) in the given view layer. + */ void DEG_graph_build_for_all_objects(struct Depsgraph *graph); -/* Special version of builder which produces dependency graph suitable for the render pipeline. - * It will contain sequencer and compositor (if needed) and all their dependencies. */ +/** + * Special version of builder which produces dependency graph suitable for the render pipeline. + * It will contain sequencer and compositor (if needed) and all their dependencies. + */ void DEG_graph_build_for_render_pipeline(struct Depsgraph *graph); -/* Builds minimal dependency graph for compositor preview. +/** + * Builds minimal dependency graph for compositor preview. * * Note that compositor editor might have pinned node tree, which is different from scene's node * tree. */ void DEG_graph_build_for_compositor_preview(struct Depsgraph *graph, struct bNodeTree *nodetree); -void DEG_graph_build_from_ids(struct Depsgraph *graph, struct ID **ids, const int num_ids); +void DEG_graph_build_from_ids(struct Depsgraph *graph, struct ID **ids, int num_ids); -/* Tag relations from the given graph for update. */ +/** Tag relations from the given graph for update. */ void DEG_graph_tag_relations_update(struct Depsgraph *graph); -/* Create or update relations in the specified graph. */ +/** Create or update relations in the specified graph. */ void DEG_graph_relations_update(struct Depsgraph *graph); -/* Tag all relations in the database for update. */ +/** Tag all relations in the database for update. */ void DEG_relations_tag_update(struct Main *bmain); /* Add Dependencies ----------------------------- */ -/* Handle for components to define their dependencies from callbacks. +/** + * Handle for components to define their dependencies from callbacks. * This is generated by the depsgraph and passed to dependency callbacks * as a symbolic reference to the current DepsNode. * All relations will be defined in reference to that node. @@ -114,7 +120,7 @@ typedef enum eDepsObjectComponentType { DEG_OB_COMP_ANIMATION, /* Transform Component (Parenting/Constraints) */ DEG_OB_COMP_TRANSFORM, - /* Geometry Component (Mesh/Displist) */ + /* Geometry Component (#Mesh / #DispList). */ DEG_OB_COMP_GEOMETRY, /* Evaluation-Related Outer Types (with Sub-data) */ @@ -147,9 +153,9 @@ void DEG_add_collection_geometry_customdata_mask(struct DepsNodeHandle *node_han void DEG_add_simulation_relation(struct DepsNodeHandle *node_handle, struct Simulation *simulation, const char *description); -void DEG_add_node_tree_relation(struct DepsNodeHandle *node_handle, - struct bNodeTree *node_tree, - const char *description); +void DEG_add_node_tree_output_relation(struct DepsNodeHandle *node_handle, + struct bNodeTree *node_tree, + const char *description); void DEG_add_bone_relation(struct DepsNodeHandle *handle, struct Object *object, const char *bone_name, @@ -159,23 +165,28 @@ void DEG_add_object_cache_relation(struct DepsNodeHandle *handle, struct CacheFile *cache_file, eDepsObjectComponentType component, const char *description); -/* Adds relation from DEG_OPCODE_GENERIC_DATABLOCK_UPDATE of a given ID. - * Is used for such entities as textures and images. */ +/** + * Adds relation from #DEG_OPCODE_GENERIC_DATABLOCK_UPDATE of a given ID. + * Is used for such entities as textures and images. + */ void DEG_add_generic_id_relation(struct DepsNodeHandle *node_handle, struct ID *id, const char *description); -/* Special function which is used from modifiers' updateDepsgraph() callback +/** + * Special function which is used from modifiers' #updateDepsgraph() callback * to indicate that the modifier needs to know transformation of the object * which that modifier belongs to. * This function will take care of checking which operation is required to - * have transformation for the modifier, taking into account possible simulation - * solvers. */ + * have transformation for the modifier, taking into account possible simulation solvers. + */ void DEG_add_modifier_to_transform_relation(struct DepsNodeHandle *node_handle, const char *description); -/* Adds relations from the given component of a given object to the given node - * handle AND the component to the point cache component of the node's ID. */ +/** + * Adds relations from the given component of a given object to the given node + * handle AND the component to the point cache component of the node's ID. + */ void DEG_add_object_pointcache_relation(struct DepsNodeHandle *node_handle, struct Object *object, eDepsObjectComponentType component, |