@needle-tools/materialx 1.7.2 → 1.7.3

package/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [1.7.3] - 2026-07-09
+
+### Fixed
+- Three PMREM environment sampling now reads the encoded CubeUV atlas from the base texture level, keeping glossy MaterialX reflections stable for prefiltered KTX2 environments that include hardware mip levels.
+
 ## [1.7.2] - 2026-07-06
 
 ### Fixed

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@needle-tools/materialx",
   "description": "MaterialX material support for three.js and Needle Engine – render physically based MaterialX shaders in the browser via WebAssembly",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "type": "module",
   "license": "PolyForm-Noncommercial-1.0.0",
   "main": "index.js",

package/src/materialx.material.js

@@ -203,7 +203,10 @@ vec3 mx_cubeuv_bilinear(sampler2D envMap, vec3 direction, float mipInt) {
     uv.y += 4.0 * (exp2(u_envRadianceCubeUVMaxMip) - faceSize);
     uv.x *= u_envRadianceCubeUVTexelWidth;
     uv.y *= u_envRadianceCubeUVTexelHeight;
-    return texture(envMap, uv).rgb;
+    // PMREM encodes roughness in the CubeUV atlas itself. If the source KTX2
+    // carries hardware mip levels, implicit sampling may pick those mips and
+    // corrupt the atlas lookup.
+    return textureLod(envMap, uv, 0.0).rgb;
 }
 
 float mx_cubeuv_roughnessToMip(float roughness) {