2026.03.0

.clang-format

@@ -0,0 +1,31 @@
+---
+BasedOnStyle: Mozilla
+TabWidth: '4'
+IndentWidth: '4'
+AccessModifierOffset: -4
+ColumnLimit: 100
+AlignAfterOpenBracket: Align
+AlignEscapedNewlines: Left
+MaxEmptyLinesToKeep: 1
+AllowShortBlocksOnASingleLine: Empty
+BreakBeforeBraces: Custom
+BraceWrapping:
+  AfterCaseLabel:  false
+  AfterClass:      true
+  AfterControlStatement: Never
+  AfterEnum:       true
+  AfterFunction:   true
+  AfterNamespace:  false
+  AfterObjCDeclaration: false
+  AfterStruct:     true
+  AfterUnion:      true
+  AfterExternBlock: true
+  BeforeCatch:     false
+  BeforeElse:      false
+  BeforeLambdaBody: false
+  BeforeWhile:     false
+  IndentBraces:    false
+  SplitEmptyFunction: false
+  SplitEmptyRecord: false
+  SplitEmptyNamespace: true
+...

.github/workflows/ci.yml

@@ -180,6 +180,7 @@ jobs:
             FBX_OUTFILE_CORRECTED=$(echo "${{ env.FBX_OUTFILE }}" | sed 's/_mac.pkg/_macos.pkg/')
             sudo installer -pkg $FBX_OUTFILE_CORRECTED -target / -verboseR
             sudo mv "/Applications/Autodesk/FBX SDK/" "/Applications/Autodesk/FBXSDK"
+            sudo sed -i '.bak' 's/mLefttChild/mLeftChild/g' "/Applications/Autodesk/FBXSDK/2020.3.7/include/fbxsdk/core/base/fbxredblacktree.h"
           else  # Linux
             FBX_INSTALL_DIR=${{ github.workspace }}/FBX_SDK_INSTALL
             chmod +r ${{ env.FBX_OUTFILE }}.tar.gz
@@ -205,8 +206,7 @@ jobs:
             "-DUSD_FILEFORMATS_ENABLE_FBX=$([[ "${{ matrix.config }}" == "ALL" || "${{ matrix.config }}" == "FBX" ]] && echo "ON" || echo "OFF")"
             "-DFBXSDK_ROOT=${{ env.FBX_INSTALL_DIR }}"
             "-DUSD_FILEFORMATS_BUILD_TESTS=ON"
-            "-DOpenImageIO_INCLUDE_DIR=${{ github.workspace }}/usd_build/include"
-            "-DOpenImageIO_INCLUDES=${{ github.workspace }}/usd_build/include"
+            "-DOpenImageIO_ROOT=${{ github.workspace }}/usd_build"
             "-DPython3_LIBRARY="
             "-DPython3_INCLUDE_DIR="
             "-DPython3_VERSION=3.10.11"
@@ -218,12 +218,8 @@ jobs:
           else
             libFolder="lib"
           fi
-          platformArgs=(
-            "-DOpenImageIO_DIR=${{ github.workspace }}/usd_build/${libFolder}/cmake/OpenImageIO"
-            "-DOpenImageIO_LIB_DIR=${{ github.workspace }}/usd_build/${libFolder}/cmake/OpenImageIO"
-          )
 
-          fullCmakeArgs="$baseArgs ${commonArgs[@]} ${platformArgs[@]}"
+          fullCmakeArgs="$baseArgs ${commonArgs[@]}"
           cmake $fullCmakeArgs
 
       - name: Build and Display Linker Command

.github/workflows/create-usd-release.yml

@@ -9,7 +9,7 @@ on:
       usd_version:
         description: "USD Version to build"
         required: true
-        default: "2411"
+        default: "2511"
 
 jobs:
   prepare-matrix:
@@ -19,9 +19,9 @@ jobs:
     steps:
       - id: set-matrix
         run: |
-          OS_LIST="[\"windows-2022\",\"macOS-13\""
+          OS_LIST="[\"windows-2022\", \"windows-2025\""
           if [[ "${{ github.event.inputs.usd_version }}" -gt 2400 ]]; then
-            OS_LIST="$OS_LIST,\"macOS-14\""
+            OS_LIST="$OS_LIST,\"macOS-14\", \"macOS-15\", \"macos-26\""
           fi
           OS_LIST="$OS_LIST,\"ubuntu-22.04\"]"
           echo "matrix=$OS_LIST" >> $GITHUB_OUTPUT
@@ -57,7 +57,7 @@ jobs:
             $releaseExists = $false
             "exists=false" | Out-File -FilePath $env:GITHUB_ENV -Append
             Write-Output "Release not found: $releaseName  -- Creating new one"
-            gh release create "$releaseName" --title "$releaseName" --notes "USD built with the following parameters:  --build-shared --openimageio --tools --python --debug-python --usd-imaging --build-variant release --use-cxx11-abi=0 (linux)"
+            gh release create "$releaseName" --title "$releaseName" --notes "USD built with the following parameters:  --build-shared --openimageio --tools --usd-imaging --build-variant release --use-cxx11-abi=0 (linux)"
           } else {
             $releaseExists = $true
           }
@@ -82,6 +82,12 @@ jobs:
           python-version: "3.10.11"
         id: setup-python
 
+      - name: Upgrade pip + setuptools
+        if: contains(matrix.os, 'macos-26-intel')
+        run: |
+          python -m pip install --upgrade pip setuptools
+          python -c "import ssl; print('SSL OK:', ssl.OPENSSL_VERSION)"
+
       - name: Install Ninja (Unix)
         if: env.exists == 'false' && matrix.os != 'windows-2022'
         run: |
@@ -102,13 +108,14 @@ jobs:
           brew cleanup
 
       - name: Install Additional Dependencies (Ubuntu)
-        if: env.exists == 'false' && matrix.os == 'ubuntu-22.04'
+        if: env.exists == 'false' && contains(matrix.os, 'ubuntu')
         run: |
           sudo apt-get update
           sudo apt-get install -y build-essential libgl1-mesa-dev libglew-dev libxi-dev libxrandr-dev
+          sudo apt-get install -y libx11-dev libxinerama-dev libxcursor-dev libxi-dev
 
       - name: Install Additional Dependencies (Windows)
-        if: env.exists == 'false' && matrix.os == 'windows-2022'
+        if: env.exists == 'false' && contains(matrix.os, 'windows')
         run: |
           choco install cmake --installargs 'ADD_CMAKE_TO_PATH=System'
 
@@ -179,18 +186,18 @@ jobs:
           if ("${{runner.os}}" -eq "Linux") {
             $abi_arg = "--use-cxx11-abi 0"
           }
-          $python_cmd = "python $file `${{ github.workspace }}/usd_build` --build-shared --openimageio --tools --python --debug-python --usd-imaging --build-variant release $abi_arg $generator"
+          $python_cmd = "python $file `${{ github.workspace }}/usd_build` --onetbb --no-examples --draco --openimageio --no-materialx --tools --build-variant release $abi_arg $generator"
           Invoke-Expression $python_cmd
 
       - name: Remove Specific Folders Unix
-        if: env.exists == 'false' && matrix.os != 'windows-2022'
+        if: env.exists == 'false' && contains(matrix.os, 'windows') == 'false'
         run: |
           rm -rf ${{ github.workspace }}/usd_build/build
           rm -rf ${{ github.workspace }}/usd_build/share
           rm -rf ${{ github.workspace }}/usd_build/src
 
       - name: Remove Specific Folders Windows
-        if: env.exists == 'false' && matrix.os == 'windows-2022'
+        if: env.exists == 'false' && contains(matrix.os, 'windows')
         run: |
           powershell -Command "& {
             Remove-Item -Path ${{ github.workspace }}\usd_build\build -Recurse -Force
@@ -222,13 +229,13 @@ jobs:
           }
 
       - name: Package Build Artifacts Unix
-        if: env.exists == 'false' && matrix.os != 'windows-2022'
+        if: env.exists == 'false' && contains(matrix.os, 'windows') == 'false'
         run: |
           cd ${{ github.workspace }}/usd_build
           zip -r ../usd-${{ github.event.inputs.usd_version }}-${{ matrix.os }}.zip *
 
       - name: Package Build Artifacts Windows
-        if: env.exists == 'false' && matrix.os == 'windows-2022'
+        if: env.exists == 'false' && contains(matrix.os, 'windows')
         run: |
           powershell -Command "& {
             Set-Location ${{ github.workspace }}\usd_build

.gitignore

@@ -33,6 +33,7 @@
 *.out
 *.app
 
+# Build artifacts
 *build*/
 build-meta
 
@@ -44,17 +45,22 @@ build-meta
 .vscode/*
 .idea
 
+# All python cache directories and bytecode files
+**/__pycache__
+
 # Generated documentation
 docs
 Testing
 bin
-test/__pycache__
 test/output
 test/assets/fbx/*.usd
 test/assets/gltf/*.usd
 test/assets/obj/*/*.usd
 test/assets/ply/*.usd
 test/assets/stl/*.usd
 
-# .DS_Store
+# macOS system files
 .DS_Store
+
+# local cache
+*.cache

CMakeLists.txt

@@ -1,7 +1,9 @@
-cmake_minimum_required(VERSION 3.16.0)
+cmake_minimum_required(VERSION 3.19.0)
+
 project(usdFileFormats)
 
-file(READ "version" VERSION)
+file(READ "version.json" VERSION_JSON)
+string(JSON VERSION GET "${VERSION_JSON}" version)
 string(REGEX MATCH "([0-9]*).([0-9]*).([0-9]*)" _ ${VERSION})
 set(CPACK_PACKAGE_VERSION_MAJOR ${CMAKE_MATCH_1})
 set(CPACK_PACKAGE_VERSION_MINOR ${CMAKE_MATCH_2})
@@ -97,26 +99,44 @@ endif ()
 
 add_subdirectory(utils)
 
+# Add a new file format to the build. This macro will add the relevant subdirectory and set the
+# installation destination needed by that plugin's CMakeLists.txt so it installs into
+# usd-fileformats-plugins/bin/plugin/usd
+#
+# New variables:
+# - USD${FILEFORMAT}_DESTINATION: Where the fileformat libraries will be installed. This will
+#                                 typically be "plugin/usd"
+#                                 Example: USDFBX_DESTINATION
+#
+# @param SUBDIRECTORY_NAME The name of the subdirectory to add. This should be the same name as
+# directory of the plugin, and will typically be all lowercase
+macro(add_usd_fileformat SUBDIRECTORY_NAME)
+    string(TOUPPER ${SUBDIRECTORY_NAME} FILEFORMAT)
+
+    set(USD${FILEFORMAT}_DESTINATION "plugin/usd")
+    add_subdirectory(${SUBDIRECTORY_NAME})
+endmacro()
+
 if (USD_FILEFORMATS_ENABLE_FBX)
-    add_subdirectory(fbx)
+    add_usd_fileformat(fbx)
 endif()
 if (USD_FILEFORMATS_ENABLE_GLTF)
-    add_subdirectory(gltf)
+    add_usd_fileformat(gltf)
 endif()
 if (USD_FILEFORMATS_ENABLE_OBJ)
-    add_subdirectory(obj)
+    add_usd_fileformat(obj)
 endif()
 if (USD_FILEFORMATS_ENABLE_PLY)
-    add_subdirectory(ply)
+    add_usd_fileformat(ply)
 endif()
 if (USD_FILEFORMATS_ENABLE_SBSAR)
-    add_subdirectory(sbsar)
+    add_usd_fileformat(sbsar)
 endif()
 if (USD_FILEFORMATS_ENABLE_SPZ)
-    add_subdirectory(spz)
+    add_usd_fileformat(spz)
 endif()
 if (USD_FILEFORMATS_ENABLE_STL)
-    add_subdirectory(stl)
+    add_usd_fileformat(stl)
 endif()
 
 if (UNIX AND NOT APPLE)

README.md

@@ -42,7 +42,7 @@ The following tools are needed:
 The following dependencies are needed:
 |Dependency|Version|Affects|Optional|
 |--|--|--|--|
-| [Pixar USD](https://github.com/PixarAnimationStudios/USD)               | 23.08       | all             | no  |
+| [Pixar USD](https://github.com/PixarAnimationStudios/USD)               | 23.08-25.11 | all             | no  |
 | [GTest](https://github.com/google/googletest.git)                       | 1.11.0      | all tests       | yes |
 | [Eigen](https://gitlab.com/libeigen/eigen)                              | 3.4.0       | usdply, usdspz  | no  |
 | [FBX SDK](https://aps.autodesk.com/developer/overview/fbx-sdk)          | 2020.3.7    | usdfbx          | no  |
@@ -57,6 +57,13 @@ The following dependencies are needed:
 | [Spz](https://github.com/nianticlabs/spz)                               | fd4e2a5     | usdspz          | no  |
 | [Substance](https://developer.adobe.com/substance3d-sdk/)               | 9.1.2       | usdsbsar        | no  |
 
+
+## Coding Standards
+Linting standards are defined within ./.clang-format. All changes within pull requests are expected to now follow these standards. To ensure this, it is advised setup IDEs with format on save features. Alternatively, formatting can be run on all cpp and header files by running the following bash command:
+```
+find . -iname '*.h' -o -iname '*.cpp' | xargs clang-format -i
+```
+
 ## Build
 
 ### 1. Setup dependencies
@@ -83,6 +90,8 @@ The following dependencies are needed:
     * `<USD_INSTALL_PATH>/lib64` to `LD_LIBRARY_PATH` in linux
     * `<USD_INSTALL_PATH>/lib/python` to `PYTHONPATH`
 
+If USD was built with Python (default behavior with the build script), ensure the environment has access to the Python it was built with. In particular, on Windows, ensure that PATH includes the location of the Python dll used. (Alternatively, the Python dll can also be copied into `<USD_INSTALL_PATH>/bin`).
+
     In linux you may need these other dependencies:
     ```
     sudo apt update
@@ -224,7 +233,7 @@ Our GitHub Actions setup includes two main workflows to support continuous integ
 
 ### 1. CI Build Workflow
 This workflow is triggered by any push or pull request to the main branch and ensures compatibility with Universal Scene Description (USD) versions:
-- **Versions Tested:** Builds against the oldest (23.08) and newest (24.05) supported USD versions regularly.
+- **Versions Tested:** Builds against the oldest (23.08) and newest (25.11) supported USD versions regularly.
 - **Weekly Builds:** The workflow builds against all supported USD versions to confirm ongoing compatibility.
 - **Post-Build Testing:** Following the build, each plugin undergoes sanity testing, including loading a cube to check basic functionality.
 - **Supported Plugins:** Currently supports FBXm GLTF, OBJ, PLY, and STL. Note: SBSAR plugin is not supported due to SDK constraints.

changelog.txt

@@ -1,3 +1,96 @@
+v2026.03.0  March 6th, 2026
+
+Features
+    fbx
+        - add generator metadata to USD
+        - support bitangents/tangents during import/export
+    gltf
+        - support khr_materials_volume_scatter extension
+        - add support for textures with brackets in their file names
+        - support EXT_materials_specular_edge_color & EXT_materials_clearcoat_color
+        - support bitangents/tangents during import/export
+        - add support for KHR_materials_coat extension
+        - Skip invalid IOR values < 1.0
+    obj
+        - allow single value for ke material setting
+    sbsar
+        - expose uv texture repeat controls
+        - panorama support
+        - allow for unlimited cache
+        - relative image path resolution
+    stl
+        - support empty normals on import
+    utils
+        - increase MaterialX OpenPBR support
+
+Fixes
+    fbx
+        - fix mesh import when fbx mesh is a root node
+        - do not require `gtest` if tests are disabled
+        - bind meshes that have materials but no elementmaterials
+        - add 'triangulatemeshes' import option to allow control of whether triangulation should be performed
+        - fix material property mapping for non lambert/phong shader models
+        - fix FBX standard material import
+        - skeleton index validation / avoid default indexes / out of bounds checks
+        - fix skeletal animation for joints that only have curves on individual channels
+        - Handle color spaces correctly according to declared parameters
+        - Armature scale is applied only once through the USD hierarchy
+    gltf
+        - fix material index lookup when material is missing
+        - improved support for gltf scattering extension
+        - add generator metadata to USD
+        - fix various crashes
+        - fix inverted normal maps
+        - add input validation to prevent memory corruption vulnerabilities
+        - update readme to fix param name
+    obj
+        - replace backslash with slash in texture filepath
+        - fix crash on loading a file > 2gb
+        - adding computeNormals to SDF_FORMAT_ARG
+        - cpp 20 compilation fix
+        - Adjust FMT library dependency in the OBJ plugin to solve linker issues
+    ply
+        - fix reading gsplat sh coefficients
+        - fix export issues when not all meshes have uvs or normals
+        - remove clipping to SH0 for Gsplat
+        - fix GSplat import and export and add support to SH4
+    sbsar
+        - switching the default normal format to sbsar
+        - specifying substance engine/framework for arm64
+        - folder/subfolder support when parsing SBSAR files
+        - filter SBSAR by graph type
+        - increase default cache size to 2GB for smooth 4K texture handling
+        - tests fix double free error on Linux by removing getRenderThreadState() in destructor
+        - tag texture attributes with color space information for MaterialX/OpenPBR
+        - Fix conversion of sbsar displacement to OpenPBR
+        - Revamp heuristic fallbacks for procedural input image path resolution
+        - Add inverted uv scale for use with openpbr
+        - Correct normal scale / bias in directx style sbsar files for OpenPBR
+    spz
+        - remove clipping to SH0 for Gsplat
+        - fix GSplat import and export and add support to SH4
+    stl
+        - reverse normals on export
+        - calculate geometric normals on import
+    utils
+        - improve shared file format args
+        - refactor input struct & material processing
+        - fix for crash in smooth normals computation
+        - add asset path to input:file property of UsdPreviewSurface and ASM shaders
+        - switch to `ND_UsdUVTexture_23` for texture reads in OpenPBR/MaterialX networks
+        - add type checking to `setAttributeDefaultValue()` to catch invalid data
+        - check for empty values when setting the default value and forgo the type check
+        - readLayer to correctly processes instancing setups
+        - OpenPBR oriented material reading
+        - add general `preserveExtraMaterialInfo` file format argument
+        - improvements on ASM to OpenPBR conversion
+        - updating third-party dependencies
+
+Build System
+    utils
+        - update test baseline images for 24.11 renderer changes
+        - updated the baselines images for the fbx plugins to match colorspace changes
+
 v1.2.0  October 22nd, 2025
 fbx:
     - fix mesh import when fbx mesh is a root node