@aethervtt/shard-texture 0.0.1 → 0.1.0

package/dist/channels.d.ts

@@ -0,0 +1,9 @@
+import type { Image } from './image.js';
+import { Texture } from './texture.js';
+/**
+ * Packs separate roughness and metalness images into one `metallicRoughnessTexture` (0066): G is
+ * roughness, B is metalness, as glTF has it. Each input's red channel is its value (grayscale
+ * maps). A missing map packs as 1, so the material's own roughness and metallic factors apply
+ * unchanged. Maps of different sizes are resized to the larger one.
+ */
+export declare function packMetallicRoughness(roughness?: Image, metalness?: Image): Texture;

package/dist/channels.js

@@ -0,0 +1,40 @@
+import { ShardError } from "@aethervtt/shard-core";
+import { resizeImage } from "./array.js";
+import { Texture } from "./texture.js";
+function packMetallicRoughness(roughness, metalness) {
+  if (!roughness && !metalness) {
+    throw new ShardError(
+      "texture/nothing-to-pack",
+      "packMetallicRoughness needs a roughness or a metalness map",
+      {
+        hint: "Without either, leave metallicRoughnessTexture empty: the scalar factors apply."
+      }
+    );
+  }
+  for (const image of [roughness, metalness]) {
+    if (image && image.kind !== "u8") {
+      throw new ShardError(
+        "texture/wrong-kind",
+        "Roughness and metalness maps must be 8-bit images",
+        {
+          hint: 'Decode them as RGBA8 (kind "u8").'
+        }
+      );
+    }
+  }
+  const width = Math.max(roughness?.width ?? 0, metalness?.width ?? 0);
+  const height = Math.max(roughness?.height ?? 0, metalness?.height ?? 0);
+  const r = roughness ? resizeImage(roughness, width, height).data : void 0;
+  const m = metalness ? resizeImage(metalness, width, height).data : void 0;
+  const out = new Uint8Array(width * height * 4);
+  for (let i = 0; i < width * height; i++) {
+    out[i * 4] = 0;
+    out[i * 4 + 1] = r ? r[i * 4] : 255;
+    out[i * 4 + 2] = m ? m[i * 4] : 255;
+    out[i * 4 + 3] = 255;
+  }
+  return Texture.create({ width, height, usage: "data", mips: [out], mipmaps: true });
+}
+export {
+  packMetallicRoughness
+};

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 export { resizeImage, type TextureArrayFile, TextureArrayImporter } from './array.js';
 export { encodeBasis, type TranscodedTexture, type TranscodeTarget, transcodeBasis } from './basis.js';
+export { packMetallicRoughness } from './channels.js';
 export { decodeHdr, decodeImage, decodeJpeg, decodePngImage, decodeWebp, type ImageFormat, sniffImage, } from './decode/index.js';
 export type { Image } from './image.js';
 export { flipGreen, importImageBytes, TextureImporter, TextureImportSettings, type TextureSettings, usageFromName, } from './importer.js';
 export { type Ktx2Data, readKtx2, tagKtx2, writeKtx2 } from './ktx2.js';
 export { buildMips, type MipChain, type MipOptions, type TextureUsage, toHalf } from './mips.js';
 export { type PackItem, type PackResult, packRects, SkylinePacker } from './pack.js';
-export { FORMAT_INFO, setTextureCapabilities, Texture, TextureAssetType, type TextureCapabilities, type TextureFormat, type TextureInit, Textures, textureCapabilities, textureFromKtx2, transcodeTarget, } from './texture.js';
+export { FORMAT_INFO, fallbackTexture, setTextureCapabilities, Texture, TextureAssetType, type TextureCapabilities, type TextureFormat, type TextureInit, Textures, textureCapabilities, textureFromKtx2, transcodeTarget, } from './texture.js';

package/dist/index.js

@@ -1,5 +1,6 @@
 import { resizeImage, TextureArrayImporter } from "./array.js";
 import { encodeBasis, transcodeBasis } from "./basis.js";
+import { packMetallicRoughness } from "./channels.js";
 import {
   decodeHdr,
   decodeImage,
@@ -20,6 +21,7 @@ import { buildMips, toHalf } from "./mips.js";
 import { packRects, SkylinePacker } from "./pack.js";
 import {
   FORMAT_INFO,
+  fallbackTexture,
   setTextureCapabilities,
   Texture,
   TextureAssetType,
@@ -44,8 +46,10 @@ export {
   decodePngImage,
   decodeWebp,
   encodeBasis,
+  fallbackTexture,
   flipGreen,
   importImageBytes,
+  packMetallicRoughness,
   packRects,
   readKtx2,
   resizeImage,

package/dist/texture.d.ts

@@ -95,3 +95,8 @@ export declare function textureFromKtx2(bytes: Uint8Array, options?: {
     cpu?: boolean;
 }): Promise<Texture>;
 export declare const TextureAssetType: import("@aethervtt/shard-assets").AssetTypeDef<Texture>;
+/**
+ * What a texture that failed to load shows (0061): 50% gray, or in a dev build a magenta and gray
+ * checker that can't be mistaken for art. RGBA8, so it binds in any color or data slot.
+ */
+export declare function fallbackTexture(dev: boolean): Texture;

package/dist/texture.js

@@ -204,13 +204,31 @@ const TextureAssetType = defineAssetType("Texture", {
     existing.layers = next.layers;
     existing.premultiplied = next.premultiplied;
     existing.version++;
-  }
+  },
+  fallback: ({ dev }) => fallbackTexture(dev),
+  cost: (texture) => ({ textures: 1, bytes: texture.byteSize })
 });
+function fallbackTexture(dev) {
+  const size = dev ? 8 : 1;
+  const pixels = new Uint8Array(size * size * 4);
+  for (let y = 0; y < size; y++) {
+    for (let x = 0; x < size; x++) {
+      const o = (y * size + x) * 4;
+      const checker = dev && ((x >> 1) + (y >> 1)) % 2 === 0;
+      pixels[o] = checker ? 255 : 128;
+      pixels[o + 1] = checker ? 0 : 128;
+      pixels[o + 2] = checker ? 255 : 128;
+      pixels[o + 3] = 255;
+    }
+  }
+  return Texture.create({ width: size, height: size, mips: [pixels], usage: "color", cpu: true });
+}
 export {
   FORMAT_INFO,
   Texture,
   TextureAssetType,
   Textures,
+  fallbackTexture,
   setTextureCapabilities,
   textureCapabilities,
   textureFromKtx2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aethervtt/shard-texture",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -18,8 +18,8 @@
   ],
   "dependencies": {
     "@jsquash/webp": "^1.5.0",
-    "@aethervtt/shard-assets": "0.0.1",
-    "@aethervtt/shard-core": "0.0.1",
+    "@aethervtt/shard-assets": "0.1.0",
+    "@aethervtt/shard-core": "0.1.0",
     "fzstd": "^0.1.1",
     "jpeg-js": "^0.4.4",
     "ktx-parse": "^2.0.0"
@@ -34,6 +34,6 @@
     "provenance": true
   },
   "shard": {
-    "buildSha": "d6c5c6aef4675575c878b02cf2c8f738b4190229"
+    "buildSha": "8e14c9896f82a3554b156f1ffdd68f2cc3e7d78a"
   }
 }