@needle-tools/materialx 1.0.1-next.df0e959 → 1.0.2-next.81f48e0

package/CHANGELOG.md

@@ -4,5 +4,10 @@ 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.0.2] - 2025-07-10
+- Add: Material extension `doubleSided` support
+- Improved lighting support
+- Improved texture loading and fix bug where glTF texture index was not resolved properly
+
 ## [1.0.1] - 2025-07-08
 - Initial release

package/README.md

@@ -1,6 +1,6 @@
 # Needle MaterialX
 
-Load and display MaterialX materials in Needle Engine
+Web runtime support to load and display MaterialX materials in Needle Engine
 
 ## Installation
 `npm i @needle-tools/materialx`  

package/codegen/register_types.ts

@@ -2,7 +2,9 @@
 import { TypeStore } from "@needle-tools/engine"
 
 // Import types
+import { MaterialXMaterial } from "../src/materialx.material.js";
 import { MaterialXUniformUpdate } from "../src/loader/loader.needle.js";
 
 // Register types
+TypeStore.add("MaterialXMaterial", MaterialXMaterial);
 TypeStore.add("MaterialXUniformUpdate", MaterialXUniformUpdate);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/materialx",
-  "version": "1.0.1-next.df0e959",
+  "version": "1.0.2-next.81f48e0",
   "type": "module",
   "main": "index.ts",
   "exports": {

package/src/loader/loader.needle.ts

@@ -6,32 +6,21 @@ import type { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
 import type { GLTFExporter } from "three/examples/jsm/exporters/GLTFExporter.js";
 import { MaterialXLoader } from "./loader.three.js";
 import { debug } from "../utils.js";
-import { state } from "../materialx.js";
+import { MaterialXEnvironment, state } from "../materialx.js";
+import { MaterialXMaterial } from "../materialx.material.js";
 
 //@dont-generate-component
 export class MaterialXUniformUpdate extends Component {
 
-    static updateMaterial(mat: Material | Material[], object: Object3D, camera: Camera) {
-        if (Array.isArray(mat)) {
-            mat.forEach(m => {
-                if (m.userData?.updateUniforms) {
-                    m.userData.updateUniforms(object, camera);
-                }
-            });
-        } else if (mat.userData?.updateUniforms) {
-            mat.userData.updateUniforms(object, camera);
-        }
-    }
-
     onEnable(): void {
-        this.context.addBeforeRenderListener(this.gameObject, this._onBeforeRender);
+        this.context.addBeforeRenderListener(this.gameObject, this.onBeforeRenderThree);
     }
 
     onDisable(): void {
-        this.context.removeBeforeRenderListener(this.gameObject, this._onBeforeRender);
+        this.context.removeBeforeRenderListener(this.gameObject, this.onBeforeRenderThree);
     }
 
-    _onBeforeRender = () => {
+    onBeforeRenderThree = () => {
         // Update uniforms or perform any pre-render logic here
         const gameObject = this.gameObject as any as Mesh;
         const material = gameObject?.material;
@@ -39,14 +28,16 @@ export class MaterialXUniformUpdate extends Component {
         const camera = this.context.mainCamera;
         if (!camera) return;
 
-        MaterialXUniformUpdate.updateMaterial(material, gameObject, camera);
+        const env = state.materialXEnvironment;
 
-        // If this is a Group, we need to update all direct children
-        if ((gameObject as any as Group).isGroup) {
-            gameObject.children.forEach((child: Object3D) => {
-                if (child instanceof Mesh && child.material)
-                    MaterialXUniformUpdate.updateMaterial(child.material, child, camera);
-            });
+        if (Array.isArray(material)) {
+            for (const entry of material) {
+                if (entry && entry instanceof MaterialXMaterial) {
+                    entry.updateUniforms(this.context, env, this.gameObject, camera);
+                }
+            }
+        } else if (material instanceof MaterialXMaterial) {
+            material.updateUniforms(this.context, env, this.gameObject, camera);
         }
     }
 }
@@ -62,14 +53,18 @@ export class MaterialXLoaderPlugin implements INeedleGLTFExtensionPlugin {
         // Register the MaterialX loader extension
         // Environment initialization is now handled in the MaterialXLoader constructor
         loader.register(p => {
-            this.loader = new MaterialXLoader(p, context);
+            this.loader = new MaterialXLoader(p, url, context);
             return this.loader;
         });
     };
 
-    onLoaded = (url: string, gltf: GLTF, context: Context) => {
-        if (debug) console.log("[MaterialX] MaterialXLoaderPlugin: glTF loaded", url, gltf.scene);
+    onLoaded = (url: string, gltf: GLTF, _context: Context) => {
+        if (debug) console.log("[MaterialX] MaterialXLoaderPlugin: glTF loaded", { url, scene: gltf.scene, materialX_root_data: this.loader?.materialX_root_data });
 
+        // If we don't have MaterialX data in the loaded glTF we don't need to do anything else here
+        if (!this.loader?.materialX_root_data) {
+            return;
+        }
         // Set up onBeforeRender callbacks for objects with MaterialX materials
         // This ensures uniforms are updated properly during rendering
         gltf.scene.traverse((child) => {
@@ -77,7 +72,7 @@ export class MaterialXLoaderPlugin implements INeedleGLTFExtensionPlugin {
                 const mesh = child as Mesh;
                 const material = mesh.material as Material;
 
-                if (material?.userData?.updateUniforms) {
+                if (material instanceof MaterialXMaterial) {
                     if (debug) console.log("[MaterialX] Adding MaterialX uniform update component to:", child.name);
                     child.addComponent(MaterialXUniformUpdate);
                 }
@@ -85,12 +80,6 @@ export class MaterialXLoaderPlugin implements INeedleGLTFExtensionPlugin {
         });
 
         if (debug) console.log("[MaterialX] Loaded: ", this.loader);
-
-        // Initialize MaterialX lighting system with scene data
-        const environment = state.materialXEnvironment;
-        environment.initializeFromContext(context).then(() => {
-            this.loader?.updateLightingFromEnvironment(environment);
-        });
     };
 
     onExport = (_exporter: GLTFExporter, _context: Context) => {