changelog.txt

v2026.3  March 6th, 2026

General Changes:
    - Fixed compatibility with USD 25.x
    - Our version numbering is changing format to YYYY.0M (Year/Month) with an added patch if applicable
    - Our clang-format configuration is now updated and formatting is now a requirement
    - Include/header files have been cleaned up

Features
    gltf
        - add support for KHR_materials_coat extension
        - Skip invalid IOR values < 1.0
    sbsar
        - relative image path resolution

Fixes
    fbx
        - 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
        - add input validation to prevent memory corruption vulnerabilities
        - update readme to fix param name
    obj
        - adding computeNormals to SDF_FORMAT_ARG
        - cpp 20 compilation fix
        - Adjust FMT library dependency in the OBJ plugin to solve linker issues
    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
    utils
        - 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
        - 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
    - 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
    - add generator metadata to USD
    - support bitangents/tangents during import/emport
    - fix material property mapping for non lambert/phong shader models
gltf:
    - fix material index lookup when material is missing
    - support khr_materials_volume_scatter extension
    - improved support for gltf scattering extension
    - add support for textures with brackets in their file names
    - support EXT_materials_specular_edge_color & EXT_materials_clearcoat_color
    - add generator metadata to USD
    - fix various crashes
    - support bitangents/tangents during import/export
    - fix inverted normal maps
obj:
    - replace backslash with slash in texture filepath
    - fix crash on loading a file > 2gb
    - allow single value for ke material setting
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
spz:
    - remove clipping to SH0 for Gsplat
    - fix GSplat import and export and add support to SH4
sbsar:
    - expose uv texture repeat controls
    - panorama support
    - refactor of sbsar for MaterialX support
    - allow for unlimited cache
    - switching the default normal format to sbsar
stl:
    - reverse normals on export
    - support empty normals on import
    - calculate geometric normals on import
utility:
    - increase MaterialX OpenPBR support
    - improve shared file format args
    - refactor input struct & material processing
    - fix for crash in smooth normals computation
    - update test baseline images for 24.11 renderer changes
cmake:
    - switch from cmake FetchContent to CPM
    - updating openimageio cmake
usd:
    - adding support for usd 25.05.01

v1.1.1  March 10th, 2025
fbx:
    - added null and index checks
    - properly write images when import images arg is invoked
    - add support for invisibility
gltf:
    - export normal scale
    - ignore invisible nodes on export
obj:
    - fix parser
    - ignore invisible nodes on export
ply:
    - ignore invisible nodes on export
sbsar:
    - fix for isImageFileSupported() [fixes nested sbsarimages]
spz:
    - ignore invisible nodes on export
    - initial
stl:
    - ignore invisible nodes on export
utility:
    - don't create subdivisionRule attribute with value none
    - fix for isImageFileSupported() [fixes nested usdz images]
    - prevent bad access in utils

v1.1.0  January 31st, 2025
fbx:
    - add display name to USD to save imported names for export
    - import specular roughness from autodesk standard surface
    - interpolate diffuse color on export for intermediate metallic values
    - avoid creating extra root nodes during import & export
    - adjust mesh and mesh instancing setup
gltf:
    - add display name to USD to save imported names for export
    - ignore invalid indices on export
    - adjust mesh and mesh instancing setup
ply:
    - add spherical harmonics support
    - detect nan values for gsplat opacity and convert to 0
    - fix for loading ply files with non-ascii characters in filename
sbsar
    - updated the list of sbsar engines for mac x64 to include metal
    - add emissive intensity of 1 when we find emissive color
    - set scale and bias correctly for normal map reader nodes
utility:
    - update required env vars for Mac in Readme
    - print OIIO error on failure
    - restrict XForm collapsing to DefaultPrim
    - usd v24.11 cleanup
    - refactor utility exporting, cmake cleanup, rename files, remove extra logs


v1.0.10  November 19th, 2024
fbx:
    - small fbx spot light fixes
    - missing file warning
    - file names added to metadata now avoid dupes
gltf:
    - ensure consistent light with usd
stl:
    - fix up axis rotation, default is assumed to be z-up
utility:
    - more robust handling of the no texture coordinate warning
    - add mesh name in generated sub mesh

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
    - improved metallic workflow
    - fix camera import orientation
gltf:
    - export fix - token2channel default rgb tokens to use r channel
    - export alphablendmodetest test asset without causing missing texture error
    - propagate one animation track through import/export
    - anisotropy import and export
ply:
    - fix gsplat bounding box for framing into the asset
utility:
    - Write a USDRenderSettings prim in the Sdf layer & do not finalize the layer in writeLayer()

v1.0.7  August 30th, 2024
fbx:
    - improved error handling in readFbx
    - add light export support
    - always make opacity a single value for usd on import
    - mesh and node error checking
    - export non-skeletal node animations
gltf:
    - add support for importing lights
    - update tinygltf version
    - glb export avoid assert when there is a missing image file
obj:
    - handle tabs before mtl name, and support .tif extension
    - fix for converting with multiple materials
ply:
    - add support to uint16 ply and allow gsplat without high-order shs
sbsar
    - plugin add 8k resolution
stl
    - calculate normals from geometry
utility:
    - adjust interface material attributes to be closer to ASM
    - fanTriangulate now fails when we have a malformed file

v1.0.6  July 31st, 2024
fbx:
    - update FBXSDK to 2020.3.7
gltf:
    - add support for importing triangle strips and fans
    - export basic point, spot and directional lights
obj:
    - export no longer modifies the scale to account for units
    - create a list of unique material names to be used for export
sbsar:
    - device initialization fixes and increased logging
    - fix parsing of float2 arguments
    - add asm scatteringColor to map bindings
    - add ASM absorptionColor usage

v1.0.5  June 26th, 2024
fbx:
    - import/export linear/srgb option
    - import animations for non-skeletal nodes
gltf:
    - documentation added khronos latest extensions to readme
obj:
    - group name and material index propagation
    - import/export linear/srgb option
sbsar:
    - if $outputsize is voluntary un-exposed we must skip resolution variant creation
    - support all output values
    - delayed substance engine initialization
    - set default resolution using a global class prim in USD for materials
utility:
    - static analysis cleanup
    - move info from comment to doc

v1.0.4  May 31st, 2024
gltf:
    - ability to open gltf file from within usd archive
    - scaling fix for normal map data and mipmap support for texture nodes
ply:
    - clipping and axis adjusting for ply assets
sbsar:
    - Add SbsarConfig plugin to allow to control cache size in an APP
utility:
    - asset resolver fix for uppercase extensions
    - trim extensions when parsing for file format
    - tftoken cleanup
    - refactor GetConnectedSources into GetValueProducingAttributes

v1.0.3  April 29th, 2024
fbx:
	- fix for setting image filename path
	- more robust find fbx sdk
	- support for autodesk standard surface materials
gltf:
	- ensure names of images are unique when importing gltf files
	- fix for geometry export issue when needing to triangulate meshes with varying and facevarying primvars
	- fail to import gltf files older than 2.0
	- clamp output color values to valid range
	- fix parenting of `skelroot` schema in `usddata`
ply:
	- making sure color and opacity is set per vertex
    - add support to importing/exporting .PLY of point clouds and Gaussian splats
sbsar:
    - add 'writeXXX' arguments to SDF args metadata in pluginInfo
    - add fileformat argument to write ASM and UsdPreviewSurface
    - fix color space for input colors
    - fix for incorrect order of min-max pair initialization
    - remove texture copy between substance engine and hydra.
utility:
    - add DoF members to UsdData Camera
    - Add support for writing lights in Sdf layer

v1.0.2  March 18th, 2024
fbx:
    - allow option to export fbx with images embedded in fbx file
gltf:
    - tinygltf to 2.8.21
	- avoid including data uris as filenames metadata
    - use gltf mesh instancing for single usd meshes
    - use default time argument of 0 when retrieving primvar values
sbsar:
    - Open source the sbsar plugin, off by default and requires the user to install the substance SDK
utility:
    - refactor usd_fileformats_enable_mtlx into an option
    - Fixes for issues with remapping normals and colors for triangulated meshes on export
    - testing fixes

v1.0.1  February 20th, 2024
fbx:
	- handle invalid channel tokens and extract textures referencing a single channel on fbx export
gltf:
	- detect whether transparency is present with specular-gloss conversion to avoid opacity map creation
utility:
	- update plugin display names
	- asset resolver cleanup

v1.0.0  January 25th, 2024
fbx:
	- perform lineartosrgb coversion for diffuse and emissive colors on export
gltf:
	- collect filenames of files read on import and add as 'filenames' usd metadata
stl:
	- improve detection of binary stl files
utility:
	- fix for issue with two sibling prim-specs created with same name

v0.9.2  January 3rd, 2024
gltf:
	- fix for missing radian-to-degree conversion for 2d texture transform rotation

v0.9.1  December 14th, 2023
fbx:
    - fix skeletal animation import with multiple roots
    - fix translate factor
    - fix indexing bug
    - fix emissiveFactor import bug
    - convert timecodes to seconds on export
    - pre-triangulate mesh before converting to usd
    - skip empty meshes and make instaceable if used as an instance
gltf:
    - convert non-gltf supported images to png on export
    - set default metersPerUnit to 1
    - import/export NeRF
    - export fix for 2d transform correction
    - convert specularGlossiness shading model to metallicRoughness
    - import/export, allow more then 4 mesh joint indices/weights per vertex
obj:
    - fix import glow and MTL parsing
utility:
    - add MaterialX support
    - asset resolver fix

v0.9.0  November 10, 2023
- Initial release of fbx, gltf, obj, ply and stl USD fileformat plugins.