Merge pull request #39 from adobe/v1.0.9

v1.0.9

Author: Keith Blackstone

changelog.txt

@@ -1,3 +1,31 @@
+v1.0.9  October 29th, 2024
+fbx:
+    - import dependent filenames now added to metadata
+    - metallic workflow was too aggressive
+    - use texture name instead of uri, and remove duplicate "direct-" in uri
+    - material name and warnings
+    - address a few skeleton export issues
+    - null pointer child and attribute checks
+    - add fbxoriginalcolorspace to pluginfo.json
+    - address skeleton parenting, sharing issues
+    - Support animation tracks
+gltf:
+    - support metallic without roughness, fix emissive white export
+    - don't export empty anisotropy; or crash when empty anisotropy is present
+    - set default scene
+    - fix mismatch between usd index and gltf index
+    - address skeleton parenting, sharing issues
+    - Support animation tracks
+obj:
+    - import check for invalid material index before use
+    - added objOriginalColorSpace to plugInfo.json
+ply:
+    - added plyGsplatsWithZup to plugInfo.json
+sbsar:
+    - new input for selecting uv sets
+utility:
+    - splitAnimationTrakcks return fix
+
 v1.0.8  October 1st, 2024
 fbx:
     - fix embedded image export

fbx/README.md

@@ -103,6 +103,18 @@ displacement → phongSurface::DisplacementColor
     UsdStageRefPtr stage = UsdStage::Open("cube.fbx:SDF_FORMAT_ARGS:fbxOriginalColorSpace=sRGB")
     ```
 
+* `fbxAnimationTracks`: Import multiple animation stacks. Default is `false`
+    The default is that only the first animation stack is imported.
+    It is only recommended to use this parameter in order to convert from FBX to another format, such as fbx.
+    It is not recommended to export a .usd file after importing a file with this parameter set.
+    ```
+    The following allows additional animation stacks to be imported, and adds metadata to USD to encode where
+    each stack begins and ends. The exporter can then read this metadata to export the stacks properly.
+    ```
+    UsdStageRefPtr stage = UsdStage::Open("cube.fbx:SDF_FORMAT_ARGS:fbxAnimationStacks=true")
+    stage->Export("myPath/cube.fbx")
+    ```
+
 **Export:**
 
 * `embedImages` Embed images in the exported fbx file instead of as separate files. Default is `false`.

fbx/src/fbx.cpp

@@ -158,7 +158,14 @@ printFbx(Fbx& fbx)
 
             indent += indentSize;
             for (int j = 0; j < node->GetChildCount(); j++) {
-                printNode(node->GetChild(j), indent);
+                FbxNode* childNode = node->GetChild(j);
+                if (childNode == nullptr) {
+                    TF_WARN("Child node at index %d is null for node '%s'. Skipping.",
+                            j,
+                            node->GetName());
+                    continue;
+                }
+                printNode(childNode, indent);
             }
         }
     };