Release v25.08 Beta

* Add Metal backend support for macOS.
* Update dependency and build system to support cross-platform development.
* Fix usdview crash [Part2]: update slang.
* Fix crash when loading AutodeskTelescope using usdview [Part1].
  * Fix out-of-bound crashes
  * Fix normal_image MaterialX definitions.
  * Fix warning when getting data from no empty VtValues.
* Fix build error on latest VS2022.
* Fix runtime folder plugin files.
* Fix Loading Large Size Image Crash with HgiRenderer.
* Fix Image Resolver Plugin.

Author: adskWangl

.gitignore

@@ -1,4 +1,5 @@
 # Ignore build directories.
+build/
 Build/
 Build.*/
 _build/
@@ -8,6 +9,9 @@ _externals/
 # Ignore script generated files
 Scripts/cmake/externalsConfig.cmake
 __pycache__
+.DS_Store
+.venv
+plugInfo.json
 
 # Ignore IDE cache folders
 .vs/

Applications/Plasma/AppDelegate.h

@@ -0,0 +1,8 @@
+
+#import <Cocoa/Cocoa.h>
+
+@interface AppDelegate : NSObject <NSApplicationDelegate>
+
+@property (assign) IBOutlet NSWindow *window;
+
+@end

Applications/Plasma/AppDelegate.m

@@ -0,0 +1,22 @@
+
+#import "AppDelegate.h"
+
+@interface AppDelegate ()
+
+@end
+
+@implementation AppDelegate
+
+- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
+    // Insert code here to initialize your application
+}
+
+- (void)applicationWillTerminate:(NSNotification *)aNotification {
+    // Insert code here to tear down your application
+}
+
+- (BOOL)applicationShouldTerminateAfterLastWindowClosed:(NSApplication *)sender {
+    return YES;
+}
+
+@end

Applications/Plasma/CMakeLists.txt

@@ -1,6 +1,6 @@
 project(Plasma)
 
-if(WIN32)
+if((WIN32 AND NOT ENABLE_HGI_BACKEND) OR APPLE)
     option(ENABLE_INTERACTIVE_PLASMA "Build Plasma as an interactive viewer." ON)
 else()
     set(ENABLE_INTERACTIVE_PLASMA OFF)
@@ -12,23 +12,108 @@ find_package(cxxopts REQUIRED)
 find_package(stb REQUIRED)
 find_package(TinyGLTF REQUIRED)
 find_package(tinyobjloader REQUIRED)
+set(optionalLibraries "")
 
-# Add test executable with all source files.
-add_executable(${PROJECT_NAME}
-    "Camera.cpp"
-    "Camera.h"
-    "Plasma.cpp"
-    "Plasma.h"
-    "glTFLoader.cpp"
-    "Libraries.cpp"
-    "Loaders.h"
-    "OBJLoader.cpp"
-    "pch.h"
-    "PerformanceMonitor.h"
-    "resource.h"
-    "SceneContents.cpp"
-    "SceneContents.h"
-)
+if (APPLE)
+    # Find and link the Metal framework
+    find_library(METAL_FRAMEWORK Metal)
+    find_library(METAL_KIT MetalKit)
+    find_library(APP_KIT AppKit)
+    find_library(GAME_CONTROLLER GameController)
+    find_library(UNIFORM_TYPE_IDENTIFIERS UniformTypeIdentifiers)
+
+    list(APPEND optionalLibraries ${METAL_FRAMEWORK} ${METAL_KIT} ${APP_KIT} ${GAME_CONTROLLER} ${UNIFORM_TYPE_IDENTIFIERS})
+
+    set(APP_BUNDLE_IDENTIFIER "com.autodesk.${PROJECT_NAME}") 
+    set(DEPLOYMENT_TARGET 14.0)
+
+    set(PRODUCT_NAME ${PROJECT_NAME})
+    set(EXECUTABLE_NAME ${PROJECT_NAME})
+    set(MACOSX_BUNDLE_EXECUTABLE_NAME ${PROJECT_NAME})
+    set(MACOSX_BUNDLE_INFO_STRING ${APP_BUNDLE_IDENTIFIER})
+    set(MACOSX_BUNDLE_GUI_IDENTIFIER ${APP_BUNDLE_IDENTIFIER})
+    set(MACOSX_BUNDLE_BUNDLE_NAME ${APP_BUNDLE_IDENTIFIER})
+    set(MACOSX_BUNDLE_ICON_FILE "")
+    set(MACOSX_BUNDLE_LONG_VERSION_STRING "1.0")
+    set(MACOSX_BUNDLE_SHORT_VERSION_STRING "1.0")
+    set(MACOSX_BUNDLE_BUNDLE_VERSION "1.0")
+    set(MACOSX_BUNDLE_COPYRIGHT "Copyright")
+    set(MACOSX_DEPLOYMENT_TARGET ${DEPLOYMENT_TARGET})
+
+    set(CMAKE_XCODE_GENERATE_SCHEME YES)
+    set(CMAKE_XCODE_SCHEME_ENVIRONMENT
+        HGIMETAL_DEBUG=1
+        CACHE STRING "" FORCE)
+
+    # Add test executable with all source files.
+    add_executable(${PROJECT_NAME} MACOSX_BUNDLE
+        "Camera.cpp"
+        "Camera.h"
+        "Plasma.cpp"
+        "Plasma.h"
+        "glTFLoader.cpp"
+        "Libraries.cpp"
+        "Loaders.h"
+        "OBJLoader.cpp"
+        "pch.h"
+        "PerformanceMonitor.h"
+        "resource.h"
+        "SceneContents.cpp"
+        "SceneContents.h"
+        "AppDelegate.h"
+        "AppDelegate.m"
+        "Renderer.h"
+        "Renderer.mm"
+        "PlasmaViewController.h"
+        "PlasmaViewController.mm"
+        "PlasmaView.h"
+        "PlasmaView.mm"
+        "Shaders.metal"
+        "ShaderTypes.h"
+    )
+
+    set_source_files_properties(Plasma.cpp PROPERTIES LANGUAGE OBJCXX)
+
+    # Add the .storyboard file and set its properties
+    set(UI_STORYBOARD Main.storyboard)
+    set_source_files_properties(${UI_STORYBOARD} PROPERTIES MACOSX_PACKAGE_LOCATION "Resources")
+    #set(ENTITLEMENTS_FILE Plasma_Interactive.entitlements)
+    #set_source_files_properties(${ENTITLEMENTS_FILE} PROPERTIES MACOSX_PACKAGE_LOCATION "Resources")
+
+    set_source_files_properties(Shaders.metal PROPERTIES LANGUAGE METAL)
+
+    target_include_directories(${PROJECT_NAME}
+        PRIVATE
+        "${TinyGLTF_INCLUDE_DIR}"
+    )
+
+    # Add the .storyboard file to the target
+    target_sources(${PROJECT_NAME} PRIVATE ${UI_STORYBOARD})
+
+    #set_target_properties(${PROJECT_NAME} PROPERTIES XCODE_ATTRIBUTE_CODE_SIGN_ENTITLEMENTS "${CMAKE_CURRENT_SOURCE_DIR}/${ENTITLEMENTS_FILE}")
+
+    set_target_properties(${PROJECT_NAME} PROPERTIES
+        BUNDLE True
+        MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/info.plist.in
+    )
+else()
+    # Add test executable with all source files.
+    add_executable(${PROJECT_NAME}
+        "Camera.cpp"
+        "Camera.h"
+        "Plasma.cpp"
+        "Plasma.h"
+        "glTFLoader.cpp"
+        "Libraries.cpp"
+        "Loaders.h"
+        "OBJLoader.cpp"
+        "pch.h"
+        "PerformanceMonitor.h"
+        "resource.h"
+        "SceneContents.cpp"
+        "SceneContents.h"
+    )
+endif()
 
 # Set custom output properties.
 set_target_properties(${PROJECT_NAME} PROPERTIES
@@ -57,6 +142,7 @@ PRIVATE
     Aurora
     ${WINSDK_LIB}
     ${CMAKE_DL_LIBS}
+    ${optionalLibraries}
 )
 
 if(WIN32 AND ENABLE_INTERACTIVE_PLASMA)

Applications/Plasma/Camera.cpp

@@ -1,4 +1,4 @@
-// Copyright 2023 Autodesk, Inc.
+// Copyright 2025 Autodesk, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -15,6 +15,9 @@
 
 #include "Camera.h"
 
+#include <glm/gtx/matrix_decompose.hpp>
+#include <glm/gtx/quaternion.hpp>
+
 // The canonical direction vectors.
 static constexpr vec3 kForward = vec3(0.0f, 0.0f, -1.0f);
 static constexpr vec3 kRight   = vec3(1.0f, 0.0f, 0.0f);
@@ -106,12 +109,21 @@ void Camera::setProjection(float fov, float nearClip, float farClip)
 {
     assert(fov > 0.0f && nearClip > 0.0f && farClip > 0.0f);
 
-    // Set the projection properties.
-    _fov  = fov;
-    _near = nearClip;
-    _far  = farClip;
+    _fromFov = _fov;
+    _destFov = fov;
+    
+    _fromNear = _near;
+    _destNear = nearClip;
+    
+    _fromFar = _far;
+    _destFar = farClip;
+//  APPLE TODO:   _moveT = 0.0f;
+}
 
-    _isProjDirty = true;
+void Camera::setAspect(float aspect) {
+    _fromAspect = _aspectRatio;
+    _destAspect = aspect;
+// APPLE TODO:    _moveT = 0.0f;
 }
 
 void Camera::setDimensions(const ivec2& dimensions)
@@ -120,6 +132,7 @@ void Camera::setDimensions(const ivec2& dimensions)
 
     // Set the dimensions.
     _dimensions = dimensions;
+    _aspectRatio = static_cast<float>(_dimensions.x) / _dimensions.y;
 
     _isProjDirty = true;
 }
@@ -273,4 +286,55 @@ void Camera::dolly(const vec2& delta)
     // NOTE: The projection matrix is dirty because the target distance may have changed here.
     _isViewDirty = true;
     _isProjDirty = true;
-}
+}
+
+void Camera::moveTo(const mat4& destViewMatrix) {
+    _fromView = _viewMatrix;
+    _destView = destViewMatrix;
+    _moveT = 0.0f;
+}
+
+void Camera::update(float delta) {
+    if (isMoving()) {
+        _moveT += delta;
+        float easedT = easeInOutCubic(_moveT);
+        _viewMatrix = tweenCameraViewMatrix(_fromView, _destView, easedT);
+        _fov = mix(_fromFov, _destFov, easedT);
+        _near = mix(_fromNear, _destNear, easedT);
+        _far = mix(_fromFar, _destFar, easedT);
+        _aspectRatio = mix(_fromAspect, _destAspect, easedT);
+        _isProjDirty = true;
+    }
+}
+
+mat4 Camera::tweenCameraViewMatrix(const mat4& from, const mat4& to, float t) {
+    // Extract translation directly from matrix
+    vec3 translationA = vec3(from[3]);
+    vec3 translationB = vec3(to[3]);
+    
+    // Extract rotation assuming no scale/skew (orthonormal matrix)
+    quat rotationA = quat_cast(mat3(from));
+    quat rotationB = quat_cast(mat3(to));
+    
+    // Interpolate
+    vec3 interpTranslation = mix(translationA, translationB, t);
+    quat interpRotation = slerp(rotationA, rotationB, t);
+    
+    // Recompose
+    mat4 rotationMat = toMat4(interpRotation);
+    rotationMat[3] = vec4(interpTranslation, 1.0f);
+    
+    return rotationMat;
+}
+
+float Camera::easeInOutCubic(float t) {
+    float f;
+    if(t < 0.5f) {
+        f = 4.0f * t * t * t;
+    }
+    else {
+        t = 1.0f - t;
+        f = 1.0f - 4.0f * t * t * t;
+    }
+    return f;
+}

Applications/Plasma/Camera.h

@@ -1,4 +1,4 @@
-// Copyright 2023 Autodesk, Inc.
+// Copyright 2025 Autodesk, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -36,28 +36,37 @@ class Camera
     vec3 forwardDir() const { return normalize(_target - _eye); }
     vec3 rightDir() const { return cross(forwardDir(), _up); }
     float targetDistance() const { return length(_target - _eye); }
-    float aspectRatio() const { return static_cast<float>(_dimensions.x) / _dimensions.y; }
+    float aspectRatio() const { return _aspectRatio; }
     const mat4& viewMatrix();
     const mat4& projMatrix();
     const ivec2& dimensions() const { return _dimensions; }
     bool isDirty() { return _isViewDirty || _isProjDirty; }
     void setIsOrtho(bool value);
     void setView(const vec3& eye, const vec3& target);
     void setProjection(float fov, float nearClip, float farClip);
+    void setAspect(float aspect);
     void setDimensions(const ivec2& dimensions);
     void fit(const Foundation::BoundingBox& bounds);
     void fit(const Foundation::BoundingBox& bounds, const vec3& direction);
     void mouseMove(int xPos, int yPos, const Inputs& inputs);
-
+    float fov() const { return _fov; }
+    float getNear() const { return _near; }
+    float getFar() const { return _far; }
+    bool isOrtho() const { return _isOrtho; }
+    
+    void moveTo(const mat4& destViewMatrix);
+    void update(float delta);
+    bool isMoving() const { return (_moveT < 1.0f); }
+    
 private:
     /*** Private Functions ***/
-
+    
     void orbit(const vec2& delta);
     void pan(const vec2& delta);
     void dolly(const vec2& delta);
-
+    
     /*** Private Variables ***/
-
+    
     bool _isUpdating = false;
     vec2 _lastMouse;
     bool _isViewDirty = true;
@@ -72,6 +81,17 @@ class Camera
     vec3 _target      = vec3(0.0f, 0.0f, 0.0f);
     vec3 _up          = vec3(0.0f, 1.0f, 0.0f);
     ivec2 _dimensions = ivec2(100, 100);
+    float _aspectRatio = 1.0f;
     mat4 _viewMatrix;
     mat4 _projMatrix;
-};
+    
+    float _moveT = 1.0f;
+    mat4 _destView, _fromView;
+    float _destFov, _destNear, _destFar, _destAspect;
+    float _fromFov, _fromNear, _fromFar, _fromAspect;
+
+
+    mat4 tweenCameraViewMatrix(const mat4& from, const mat4& to, float t);
+    float easeInOutCubic(float t);
+
+};

Applications/Plasma/Libraries.cpp

@@ -1,4 +1,4 @@
-// Copyright 2023 Autodesk, Inc.
+// Copyright 2025 Autodesk, Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -13,11 +13,12 @@
 // limitations under the License.
 #include "pch.h"
 
-#if defined(INTERACTIVE_PLASMA)
+#if defined(INTERACTIVE_PLASMA) && defined(WIN32)
 // Window global variable from pch.h.
 HWND gWindow = nullptr;
 #endif
 
+#if !defined(__APPLE__)
 // Prepare the implementations of these header-only libraries.
 // NOTE: This must be done in a *single* source file; other source files can just include the
 // header(s).
@@ -28,6 +29,10 @@ HWND gWindow = nullptr;
 #include <tiny_gltf.h>
 #pragma warning(push)
 #pragma warning(disable : 4996)
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wdeprecated-declarations"
 #define STB_IMAGE_WRITE_IMPLEMENTATION
 #include <stb_image_write.h>
-#pragma warning(pop)
+#pragma clang diagnostic pop
+#pragma warning(pop)
+#endif