@needle-tools/materialx 1.6.0-next.2af5fc1 → 1.7.0-next.0d06218

package/CHANGELOG.md

@@ -4,6 +4,20 @@ 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.0] - 2026-05-21
+
+### Added
+- Runtime environment radiance modes for fast Three.js PMREM sampling, MaterialX prefiltered latlong sampling, and MaterialX filtered importance sampling.
+- MaterialX viewer examples for material library inspection, PMREM comparison, shaderball previews, configurable environments, and graph-driven material loading.
+
+### Changed
+- Rebuilt the bundled MaterialX runtime to 1.39.5.
+- Improved texture sampling, alpha-mode render state, environment rotation, and PMREM handling for Three.js integration.
+
+### Fixed
+- Corrected material parameter editing for color values, environment controls, and graph-loaded materials in the viewer examples.
+- Kept viewer debug panels and camera controls consistent across the material library, graph, shadows, and complex scenes.
+
 ## [1.6.0] – 2026-04-01
 
 ### Added
@@ -108,4 +122,4 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Fix: Texture loading and glTF texture index resolution
 
 ## [1.0.1] - 2025-07-08
-- Initial release
+- Initial release

package/README.md

@@ -43,6 +43,39 @@ MaterialX shaders will create `MaterialXMaterial` materials at runtime. These ar
 
 [Learn more in the Needle Engine documentation](https://engine.needle.tools/docs/how-to-guides/export/materialx.html)
 
+## Notes
+
+### Anisotropy and environment lighting
+
+The public `environmentRadianceMode` option is a string enum with three modes:
+
+- `three-pmrem` is the default. It samples a prefiltered three.js CubeUV PMREM directly. This is the fast path and is the recommended default for runtime use, but prefiltered environment lookup is scalar-roughness based and does not preserve full anisotropic specular environment reflections. Direct lighting and the rest of the generated MaterialX shader still run normally.
+- `materialx-prefiltered` uses MaterialX's stock prefiltered latlong environment shader path. It is useful for parity checks and exported MaterialX-style prefiltered maps, but it is still a prefiltered lookup.
+- `materialx-fis` enables MaterialX filtered importance sampling. This path is slower, but it preserves anisotropic specular environment reflections.
+
+For anisotropic specular environment reflection checks, opt into `materialx-fis`:
+
+```ts
+import { useNeedleMaterialX } from "@needle-tools/materialx";
+
+useNeedleMaterialX(gltfLoader, {
+    environmentRadianceMode: "materialx-fis",
+});
+```
+
+The same option is available when creating a raw MaterialX material:
+
+```ts
+import { Experimental_API } from "@needle-tools/materialx";
+
+const material = await Experimental_API.createMaterialXMaterial(
+    mtlxSource,
+    0,
+    undefined,
+    { environmentRadianceMode: "materialx-fis" },
+);
+```
+
 ## WASM
 
 ### Default (CDN)
@@ -143,4 +176,3 @@ Materials can also contain the `NEEDLE_materials_mtlx` extension, which referenc
 [Discord](https://discord.needle.tools) • 
 [Forum](https://forum.needle.tools) • 
 [Youtube](https://www.youtube.com/@needle-tools)
-