com.atteneder.gltfast Release 6.16.0

Author: atteneder

CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [6.16.0] - 2026-01-20
+
+### Added
+- [GltfAsset](xref:GLTFast.GltfAsset) property setters to allow change of behavior from script.
+  - [PlayAutomatically](xref:GLTFast.GltfAsset.PlayAutomatically).
+  - [SceneId](xref:GLTFast.GltfAsset.SceneId).
+- HDRP material validation (fixes [#561](https://github.com/atteneder/glTFast/issues/561)).
+- Various overridable shader loading methods to [MaterialGenerator](xref:GLTFast.Materials.MaterialGenerator)-based classes so users can customize shader lookup. This is useful when working with Addressables (fixes [#715](https://github.com/atteneder/glTFast/issues/715)).
+  - [MaterialGenerator.FindShader](xref:GLTFast.Materials.MaterialGenerator.FindShader(System.String)) for generic, runtime shader resolution.
+  - [BuiltInMaterialGenerator.FindShaderMetallicRoughness](xref:GLTFast.Materials.BuiltInMaterialGenerator.FindShaderMetallicRoughness).
+  - [BuiltInMaterialGenerator.FindShaderSpecularGlossiness](xref:GLTFast.Materials.BuiltInMaterialGenerator.FindShaderSpecularGlossiness).
+  - [BuiltInMaterialGenerator.FindShaderUnlit](xref:GLTFast.Materials.BuiltInMaterialGenerator.FindShaderUnlit).
+  - [ShaderGraphMaterialGenerator.LoadShaderByName](xref:GLTFast.Materials.ShaderGraphMaterialGenerator.LoadShaderByName(System.String)).
+
+### Fixed
+- Emission color (emissiveFactor) is now in correct color space for shader graphs and built-in shaders.
+- Normal map scale on shader graphs.
+- (Export) Avoid creating empty ORM textures if no smoothness texture is assigned (fixes [#801](https://github.com/atteneder/glTFast/issues/801)).
+
+### Deprecated
+- Access to glTF images via [IGltfReadable.ImageCount](xref:GLTFast.IGltfReadable.ImageCount) and [IGltfReadable.GetImage](xref:GLTFast.IGltfReadable.GetImage*). This has not been used internally and was unreliable. Please access glTF textures instead (see [TextureCount](xref:GLTFast.IGltfReadable.TextureCount) and [GetTexture](xref:GLTFast.IGltfReadable.GetTexture*)).
+
 ## [6.15.1] - 2025-12-09
 
 ### Added

Runtime/Scripts/Export/Constants.cs

@@ -7,7 +7,7 @@ namespace GLTFast.Export
 {
     static class Constants
     {
-        public const string version = "6.15.1";
+        public const string version = "6.16.0";
 
         internal const string mimeTypePNG = "image/png";
         internal const string mimeTypeJPG = "image/jpeg";

Runtime/Scripts/Export/StandardMaterialExport.cs

@@ -131,12 +131,6 @@ public override bool ConvertMaterial(UnityEngine.Material uMaterial, out Materia
             }
 
             var isPbrMetallicRoughness = IsPbrMetallicRoughness(uMaterial);
-            var needsMetalRoughTexture =
-                isPbrMetallicRoughness &&
-                (
-                    HasMetallicGlossMap(uMaterial)
-                    || uMaterial.IsKeywordEnabled(k_KeywordSmoothnessTextureAlbedoChannelA)
-                );
 
             Texture2D occlusionTexture = null;
             Texture2D metalGlossTexture = null;
@@ -152,6 +146,13 @@ public override bool ConvertMaterial(UnityEngine.Material uMaterial, out Materia
                 mainTexProperty = k_ColorTexture;
             }
 
+            var needsMetalRoughTexture =
+                isPbrMetallicRoughness &&
+                (
+                    HasMetallicGlossMap(uMaterial)
+                    || HasSmoothnessInAlbedoMapAlpha(uMaterial, mainTexProperty)
+                );
+
             if (IsUnlit(uMaterial))
             {
                 ExportUnlit(material, uMaterial, mainTexProperty, gltf, logger);
@@ -262,6 +263,13 @@ out smoothnessTexture
             return success;
         }
 
+        static bool HasSmoothnessInAlbedoMapAlpha(UnityEngine.Material uMaterial, int mainTexProperty)
+        {
+            return uMaterial.IsKeywordEnabled(k_KeywordSmoothnessTextureAlbedoChannelA)
+                && uMaterial.HasProperty(mainTexProperty)
+                && uMaterial.GetTexture(mainTexProperty) is not null;
+        }
+
         static bool IsPbrMetallicRoughness(UnityEngine.Material material)
         {
             return material.HasProperty(MetallicProperty)

Runtime/Scripts/GltfAsset.cs

@@ -38,12 +38,20 @@ public bool LoadOnStartup
         /// <summary>
         /// Scene to load (-1 loads glTFs default scene)
         /// </summary>
-        protected int SceneId => sceneId;
+        public int SceneId
+        {
+            get => sceneId;
+            set => sceneId = value;
+        }
 
         /// <summary>
         /// If true, the first animation clip starts playing right after instantiation.
         /// </summary>
-        public bool PlayAutomatically => playAutomatically;
+        public bool PlayAutomatically
+        {
+            get => playAutomatically;
+            set => playAutomatically = value;
+        }
 
         /// <summary>
         /// If true, url is treated as relative StreamingAssets path

Runtime/Scripts/GltfImport.cs

@@ -850,14 +850,11 @@ void DisposeArray(IEnumerable<UnityEngine.Object> objects)
         /// </summary>
         public int MaterialCount => m_Materials?.Length ?? 0;
 
-        /// <summary>
-        /// Number of images
-        /// </summary>
+        /// <inheritdoc cref="IGltfReadable.ImageCount"/>
+        [Obsolete("Use TextureCount and GetTexture instead. This property will be removed in future releases.")]
         public int ImageCount => m_Images?.Length ?? 0;
 
-        /// <summary>
-        /// Number of textures
-        /// </summary>
+        /// <inheritdoc cref="IGltfReadable.TextureCount"/>
         public int TextureCount => m_Textures?.Length ?? 0;
 
         /// <summary>
@@ -932,11 +929,8 @@ public UnityEngine.Material GetDefaultMaterial()
             return Task.FromResult(GetDefaultMaterial());
         }
 
-        /// <summary>
-        /// Returns a texture by its glTF image index
-        /// </summary>
-        /// <param name="index">glTF image index</param>
-        /// <returns>Corresponding Unity texture</returns>
+        /// <inheritdoc cref="IGltfReadable.GetImage"/>
+        [Obsolete("Use GetTexture instead. This method will be removed in future releases.")]
         public Texture2D GetImage(int index = 0)
         {
             if (m_Images != null && index >= 0 && index < m_Images.Length)
@@ -946,11 +940,7 @@ public Texture2D GetImage(int index = 0)
             return null;
         }
 
-        /// <summary>
-        /// Returns a texture by its glTF texture index
-        /// </summary>
-        /// <param name="index">glTF texture index</param>
-        /// <returns>Corresponding Unity texture</returns>
+        /// <inheritdoc cref="IGltfReadable.GetTexture"/>
         public Texture2D GetTexture(int index = 0)
         {
             if (m_Textures != null && index >= 0 && index < m_Textures.Length)

Runtime/Scripts/IGltfReadable.cs

@@ -38,11 +38,15 @@ public interface IGltfReadable : IMaterialProvider
         /// <summary>
         /// Number of images
         /// </summary>
+        /// <seealso cref="TextureCount"/>
+        /// <seealso cref="GetTexture"/>
+        [Obsolete("Use TextureCount and GetTexture instead. This property will be removed in future releases.")]
         int ImageCount { get; }
 
         /// <summary>
         /// Number of textures
         /// </summary>
+        /// <seealso cref="GetTexture"/>
         int TextureCount { get; }
 
         /// <summary>
@@ -60,14 +64,18 @@ public interface IGltfReadable : IMaterialProvider
         Material GetDefaultMaterial();
 
         /// <summary>
-        /// Get texture by glTF image index
+        /// Get imported glTF image by index.
+        /// <b>Warning:</b> Only works temporarily during loading phase!
+        /// It's recommended to work with <see cref="GetTexture"/> instead.
         /// </summary>
         /// <param name="index">glTF image index</param>
         /// <returns>Loaded Unity texture</returns>
+        /// <seealso cref="GetTexture"/>
+        [Obsolete("Use GetTexture instead. This method will be removed in future releases.")]
         Texture2D GetImage(int index = 0);
 
         /// <summary>
-        /// Get texture by glTF texture index
+        /// Get imported glTF texture by index.
         /// </summary>
         /// <param name="index">glTF texture index</param>
         /// <returns>Loaded Unity texture</returns>

Runtime/Scripts/Material/BuiltInMaterialGenerator.cs

@@ -80,12 +80,12 @@ protected override Material GenerateDefaultMaterial(bool pointsSupport = false)
         /// <returns>Metallic/Roughness shader</returns>
         // Needs to be non-static outside of the Editor.
         // ReSharper disable once MemberCanBeMadeStatic.Local
-        Shader FinderShaderMetallicRoughness()
+        protected virtual Shader FindShaderMetallicRoughness()
         {
 #if UNITY_EDITOR
             return AssetDatabase.LoadAssetAtPath<Shader>($"{k_ShaderPathPrefix}{k_PbrMetallicRoughnessShaderPath}");
 #else
-            return FindShader(k_PbrMetallicRoughnessShaderName, Logger);
+            return FindShader(k_PbrMetallicRoughnessShaderName);
 #endif
         }
 
@@ -95,12 +95,12 @@ Shader FinderShaderMetallicRoughness()
         /// <returns>Specular/Glossiness shader</returns>
         // Needs to be non-static outside of the Editor.
         // ReSharper disable once MemberCanBeMadeStatic.Local
-        Shader FinderShaderSpecularGlossiness()
+        protected virtual Shader FindShaderSpecularGlossiness()
         {
 #if UNITY_EDITOR
             return AssetDatabase.LoadAssetAtPath<Shader>($"{k_ShaderPathPrefix}{k_PbrSpecularGlossinessShaderPath}");
 #else
-            return FindShader(k_PbrSpecularGlossinessShaderName, Logger);
+            return FindShader(k_PbrSpecularGlossinessShaderName);
 #endif
         }
 
@@ -110,20 +110,20 @@ Shader FinderShaderSpecularGlossiness()
         /// <returns>Unlit shader</returns>
         // Needs to be non-static outside of the Editor.
         // ReSharper disable once MemberCanBeMadeStatic.Local
-        Shader FinderShaderUnlit()
+        protected virtual Shader FindShaderUnlit()
         {
 #if UNITY_EDITOR
             return AssetDatabase.LoadAssetAtPath<Shader>($"{k_ShaderPathPrefix}{k_UnlitShaderPath}");
 #else
-            return FindShader(k_UnlitShaderName, Logger);
+            return FindShader(k_UnlitShaderName);
 #endif
         }
 
         Material GetPbrMetallicRoughnessMaterial(bool doubleSided = false)
         {
             if (m_PbrMetallicRoughnessShader == null)
             {
-                m_PbrMetallicRoughnessShader = FinderShaderMetallicRoughness();
+                m_PbrMetallicRoughnessShader = FindShaderMetallicRoughness();
             }
             if (m_PbrMetallicRoughnessShader == null)
             {
@@ -145,7 +145,7 @@ Material GetPbrSpecularGlossinessMaterial(bool doubleSided = false)
         {
             if (m_PbrSpecularGlossinessShader == null)
             {
-                m_PbrSpecularGlossinessShader = FinderShaderSpecularGlossiness();
+                m_PbrSpecularGlossinessShader = FindShaderSpecularGlossiness();
             }
             if (m_PbrSpecularGlossinessShader == null)
             {
@@ -167,7 +167,7 @@ Material GetUnlitMaterial(bool doubleSided = false)
         {
             if (m_UnlitShader == null)
             {
-                m_UnlitShader = FinderShaderUnlit();
+                m_UnlitShader = FindShaderUnlit();
             }
             if (m_UnlitShader == null)
             {
@@ -385,7 +385,7 @@ public override Material GenerateMaterial(
 
             if (gltfMaterial.Emissive != Color.black)
             {
-                material.SetColor(MaterialProperty.EmissiveFactor, gltfMaterial.Emissive.gamma);
+                material.SetColor(MaterialProperty.EmissiveFactor, gltfMaterial.Emissive);
                 material.EnableKeyword(k_EmissionKeyword);
             }
 

Runtime/Scripts/Material/HighDefinitionRPMaterialGenerator.cs

@@ -4,12 +4,14 @@
 #if USING_HDRP
 
 using System;
+using GLTFast.Schema;
 #if UNITY_EDITOR
 using UnityEditor;
 #endif
 using UnityEngine;
 using UnityEngine.Rendering;
 using UnityEngine.Rendering.HighDefinition;
+using Material = UnityEngine.Material;
 
 namespace GLTFast.Materials {
 
@@ -43,6 +45,13 @@ public class HighDefinitionRPMaterialGenerator : ShaderGraphMaterialGenerator {
         static bool s_MetallicStackLitShaderQueried;
         static Shader s_MetallicStackLitShader;
 
+        public override Material GenerateMaterial(MaterialBase gltfMaterial, IGltfReadable gltf, bool pointsSupport = false)
+        {
+            var material = base.GenerateMaterial(gltfMaterial, gltf, pointsSupport);
+            HDMaterial.ValidateMaterial(material);
+            return material;
+        }
+
         protected override void SetDoubleSided(Schema.MaterialBase gltfMaterial, Material material) {
             base.SetDoubleSided(gltfMaterial,material);
 

Runtime/Scripts/Material/MaterialGenerator.cs

@@ -281,7 +281,17 @@ public UnityEngine.Material GetDefaultMaterial(bool pointsSupport = false)
         protected abstract UnityEngine.Material GenerateDefaultMaterial(bool pointsSupport = false);
 
         /// <summary>
-        /// Tries to load a shader and covers error handling.
+        /// Loads a shader by name and does eventual error reporting.
+        /// </summary>
+        /// <param name="shaderName">The requested shader's name.</param>
+        /// <returns>Requested shader or null if it couldn't be loaded.</returns>
+        protected virtual Shader FindShader(string shaderName)
+        {
+            return FindShader(shaderName, Logger);
+        }
+
+        /// <summary>
+        /// Loads a shader by name and does eventual error reporting.
         /// </summary>
         /// <param name="shaderName">The requested shader's name.</param>
         /// <param name="logger">Logger used for reporting errors.</param>

Runtime/Scripts/Material/ShaderGraphMaterialGenerator.cs

@@ -531,16 +531,21 @@ protected static Shader LoadShaderByGuid(GUID guid)
         }
 #endif
 
-        protected Shader LoadShaderByName(string shaderName) {
+        /// <summary>
+        /// Loads a shader by name and does eventual error reporting.
+        /// </summary>
+        /// <param name="shaderName">The requested shader's name.</param>
+        /// <returns>Requested shader or null if it couldn't be loaded.</returns>
+        protected virtual Shader LoadShaderByName(string shaderName) {
 #if UNITY_EDITOR
             var shaderPath = $"{k_ShaderPathPrefix}{shaderName}.shadergraph";
             var shader = AssetDatabase.LoadAssetAtPath<Shader>(shaderPath);
             if (shader == null) {
-                Logger?.Error($"Cannot load shader at path {shaderPath}");
+                Logger?.Error(LogCode.ShaderMissing, shaderPath);
             }
             return shader;
 #else
-            return FindShader($"{k_ShaderGraphsPrefix}{shaderName}", Logger);
+            return FindShader($"{k_ShaderGraphsPrefix}{shaderName}");
 #endif
         }