Commit: 68e37ce1e71f94e6315d46d8271a97430ed9b710
Author: Sybren A. Stüvel
Date: Tue Nov 26 11:53:43 2019 +0100
Branches: temp-sybren-usd-patch-02
https://developer.blender.org/rB68e37ce1e71f94e6315d46d8271a97430ed9b710
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
_______________________________________________
Bf-blender-cvs mailing list
[email protected]
https://lists.blender.org/mailman/listinfo/bf-blender-cvs
