@needle-tools/gltf-build-pipeline 2.13.0-next.8c4b2db → 2.14.0-alpha

package/CHANGELOG.md

@@ -4,7 +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).
 
-## [2.13.0-beta] - 2025-10-20
+## [2.14.0-alpha] - 2025-12-08
+- add: KHR_materials_pbrSpecularGlossiness extension support
+
+## [2.13.0] - 2025-10-20
 - Use xxhash-wasm for buffer hashing
 
 ## [2.12.0] - 2025-09-13

package/dist/scripts/pack-gltf.js

@@ -4,7 +4,7 @@ import { ALL_EXTENSIONS } from '@gltf-transform/extensions';
 import draco3d from 'draco3dgltf';
 import { existsSync, readFileSync, statSync, writeFileSync } from 'fs';
 import { MeshoptDecoder, MeshoptEncoder } from 'meshoptimizer';
-import { dedup, prune, resample } from '@gltf-transform/functions';
+import { dedup, metalRough, prune, resample } from '@gltf-transform/functions';
 import { ALL_EXTENSIONS as NEEDLE_EXTENSIONS, NEEDLE_compression_texture, NEEDLE_mesh_compression, } from '../extensions/index.js';
 import { isLOD, isMeshLOD, needle_animation_transform, needle_asset, needle_mesh_transform, needle_texture_transform, } from '../transforms/index.js';
 import { getOutputPath, getVersion, ioTryReadWithMissingResources, writeNodeIO } from "../utils/index.js";
@@ -70,6 +70,7 @@ export async function packGLTF(inputFile, outputFile, options) {
         /** @type {Array<import('@gltf-transform/core').Transform>} */
         const transforms = [
             needle_asset(),
+            metalRough(),
             needle_texture_transform({
                 file: inputFile,
                 outfile: outputFile,

package/dist/transforms/needle_progressive.js

@@ -1,5 +1,6 @@
 import { BufferUtils, Document, NodeIO, PropertyType, TextureChannel, Verbosity } from '@gltf-transform/core';
-import { SIMPLIFY_DEFAULTS, WELD_DEFAULTS, listTextureChannels, listTextureSlots, sparse } from '@gltf-transform/functions';
+import { SIMPLIFY_DEFAULTS, WELD_DEFAULTS, listTextureChannels, listTextureSlots, metalRough, sparse } from '@gltf-transform/functions';
+import { KHRMaterialsSpecular } from '@gltf-transform/extensions';
 import draco3d from 'draco3dgltf';
 import { NEEDLE_PROGRESSIVE_EXTENSION_NAME, NEEDLE_progressive } from "../extensions/NEEDLE_progressive/index.js";
 import { createOpaqueExtension, currentGenerator, NEEDLE_compression_texture, NEEDLE_mesh_compression, NEEDLE_progressive_mesh_settings, NEEDLE_progressive_texture_settings, registerExtensions as registerDefaultExtensions } from '../extensions/index.js';
@@ -87,6 +88,16 @@ async function onProcess(file, opts) {
             const transforms = [
                 needle_asset(),
             ];
+            const json = await io.readAsJSON(file);
+            if (json.json.extensionsUsed?.includes("KHR_materials_pbrSpecularGlossiness")) {
+                // TODO: transforming the document here but we still get specularRoughness textures in subsequent code
+                // Test asset: https://github.com/KhronosGroup/glTF-Sample-Models/blob/main/2.0/SpecGlossVsMetalRough/glTF-Binary/SpecGlossVsMetalRough.glb
+                logger.warn("Converting KHR_materials_pbrSpecularGlossiness to metal/rough workflow...");
+                await document.transform(metalRough());
+                // await new Promise(resolve => setTimeout(resolve, 1000));
+                // await io.write(file, document);
+                // return onProcess(file, opts);
+            }
             if (opts.config?.textures?.lods !== false) {
                 transforms.push(make_progressive_textures(file, { size: [smallesTextureSize, smallesTextureSize] }, opts));
             }
@@ -97,6 +108,7 @@ async function onProcess(file, opts) {
             }
             else if (isVRM)
                 logger.warn("WARN: Progressive meshes are not supported for VRM files yet");
+            transforms.push(metalRough());
             transforms.push(sparse());
             logger.info("→ Transforming: " + file);
             await document.transform(...transforms);
@@ -268,14 +280,18 @@ export function make_progressive_textures(filePath, _options = TEXTURE_RESIZE_DE
                     continue;
                 }
             }
-            options.size[0] = settings.maxSize;
-            options.size[1] = settings.maxSize;
-            logger.debug(`[${NAME}] Resizing embedded texture[${index}] to ${options.size[0]}x${options.size[1]}`);
-            await resizeTexture(options, texture, logger, uri || name, slots);
-            if (opts?.useCache === false) {
+            // If any texture LOD was generated we can resize the texture here
+            // E.g. for specular/glossiness textures we might not generate any LODs and then we don't want to downsize the texture
+            if (results?.length) {
+                options.size[0] = settings.maxSize;
+                options.size[1] = settings.maxSize;
+                logger.debug(`[${NAME}] Resizing embedded texture[${index}] to ${options.size[0]}x${options.size[1]}`);
+                await resizeTexture(options, texture, logger, uri || name, slots);
+                if (opts?.useCache === false) {
+                }
+                else
+                    addToCache(cacheKey, texture.getImage());
             }
-            else
-                addToCache(cacheKey, texture.getImage());
         }
         logger.debug(`Progressive transform finished in ${((Date.now() - startTime) / 1000).toFixed(1)} sec.`);
     });
@@ -346,7 +362,23 @@ async function createTextureLod(args, opts) {
                     newMaterial.setBaseColorTexture(newTexture);
                     continue;
                 }
-                logger.warn(`WARN: Unknown texture slot: ${slot} for texture ${textureIndex} → can not load progressively`);
+                if (slot === "specularColorTexture") {
+                    logger.info("Pass-through KHR_materials_pbrSpecularGlossiness specularColorTexture");
+                    const ext = newDoc.createExtension(KHRMaterialsSpecular);
+                    const prob = ext.createSpecular();
+                    prob.setSpecularColorTexture(newTexture);
+                    newMaterial.setExtension(KHRMaterialsSpecular.EXTENSION_NAME, prob);
+                    continue;
+                }
+                else if (slot === "specularTexture") {
+                    logger.info("Pass-through KHR_materials_specular specularTexture");
+                    const ext = newDoc.createExtension(KHRMaterialsSpecular);
+                    const prob = ext.createSpecular();
+                    prob.setSpecularTexture(newTexture);
+                    newMaterial.setExtension(KHRMaterialsSpecular.EXTENSION_NAME, prob);
+                    continue;
+                }
+                logger.warn(`WARN: Unknown texture slot: ${slot} for texture ${textureIndex} → can not load progressively (all slots: ${slots.join(", ")})`);
                 return null;
         }
         // Make sure the material is used

package/dist/utils/version.gen.d.ts

@@ -1 +1 @@
-export declare const version = "2.13.0-next.8c4b2db";
+export declare const version = "2.14.0-alpha";

package/dist/utils/version.gen.js

@@ -1 +1 @@
-export const version = "2.13.0-next.8c4b2db";
+export const version = "2.14.0-alpha";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/gltf-build-pipeline",
-  "version": "2.13.0-next.8c4b2db",
+  "version": "2.14.0-alpha",
   "description": "Pipeline and tools for optimizing gltf files using gltf-transform and compression settings within glTF extensions",
   "main": "dist/index.js",
   "type": "module",
@@ -25,7 +25,6 @@
     "start": "node scripts/index.mjs",
     "dev": "npm-watch compile",
     "publish-package": "npm run compile && npm publish",
-    "postinstall": "node tools/prebuild.mjs",
     "prepublishOnly": "npm run compile",
     "compile": "node tools/prebuild.mjs && (tsc || exit 1) && node tools/postbuild.mjs",
     "clear-caches": "node scripts/clear-caches.mjs",