[Bf-blender-cvs] [1c6d9c02ca3] temp-sybren-usd-patch-01: USD: expanded explanation of `HierarchyContext::weak_export`

Sybren A. Stüvel noreply at git.blender.org
Tue Nov 26 18:21:49 CET 2019


Commit: 1c6d9c02ca39102a6d5880fbb9e03fc1123297a1
Author: Sybren A. Stüvel
Date:   Tue Nov 26 11:53:43 2019 +0100
Branches: temp-sybren-usd-patch-01
https://developer.blender.org/rB1c6d9c02ca39102a6d5880fbb9e03fc1123297a1

USD: expanded explanation of `HierarchyContext::weak_export`

===================================================================

M	source/blender/usd/intern/abstract_hierarchy_iterator.h

===================================================================

diff --git a/source/blender/usd/intern/abstract_hierarchy_iterator.h b/source/blender/usd/intern/abstract_hierarchy_iterator.h
index 3c7e219448c..844a00a2357 100644
--- a/source/blender/usd/intern/abstract_hierarchy_iterator.h
+++ b/source/blender/usd/intern/abstract_hierarchy_iterator.h
@@ -60,9 +60,18 @@ struct HierarchyContext {
   float matrix_world[4][4];
   std::string export_name;
 
-  /* When weak_export is true, the object will be exported only as transform, and only if is an
-   * ancestor of a non-weak child. This happens with objects that are part of a holdout collection
-   * (which prevents them from being exported) but also parent of an exported object. */
+  /* When weak_export=true, the object will be exported only as transform, and only if is an
+   * ancestor of an object with weak_export=false.
+   *
+   * In other words: when weak_export=true but this object has no children, or all decendants also
+   * have weak_export=true, this object (and by recursive reasoning all its decendants) will be
+   * excluded from the export.
+   *
+   * The export hierarchy is kept as close to the the hierarchy in Blender as possible. As such, an
+   * object that serves as a parent for another object, but which should NOT be exported itself, is
+   * exported only as transform (i.e. as empty). This happens with objects that are part of a
+   * holdout collection (which prevents them from being exported) but also parent of an exported
+   * object. */
   bool weak_export;
 
   /* When true, this object should check its parents for animation data when determining whether



More information about the Bf-blender-cvs mailing list