@forgeax/engine-image 0.1.3 → 0.1.6

package/dist/image-importer.mjs

@@ -21,7 +21,7 @@ var init_errors = __esm({
   "src/errors.ts"() {
     IMAGE_ERROR_EXPECTED = {
       "image-decode-failed": "PNG / JPG byte stream decodes successfully",
-      "image-format-unsupported": "mime is one of ['image/png', 'image/jpeg', 'image/x-tga']; uploadTexture format <-> colorSpace family agrees",
+      "image-format-unsupported": "mime is one of ['image/png', 'image/jpeg']; uploadTexture format <-> colorSpace family agrees",
       "image-dimension-out-of-bounds": "width and height fall under device caps maxTextureDimension2D (or 16384 hard cap)",
       "image-meta-missing": "<source>.meta.json sidecar (importer: 'image') exists in the same directory",
       "image-hdr-decode-failed": "Radiance RGBE header is valid and pixel data decodes successfully",
@@ -238,36 +238,34 @@ var init_hdr_decoder = __esm({
     LF = 10;
   }
 });
-var COMPRESSION_MODES = ["auto", "etc1s", "uastc", "none"];
-var RESOLVED_ENCODE_MODES = ["etc1s", "uastc", "uastc-hdr", "none"];
 function resolveEncodeMode(mode, source) {
   switch (mode) {
-    case COMPRESSION_MODES[3]:
-      return RESOLVED_ENCODE_MODES[3];
-    case COMPRESSION_MODES[1]:
-      return RESOLVED_ENCODE_MODES[0];
-    case COMPRESSION_MODES[2]:
-      return source.isHdr ? RESOLVED_ENCODE_MODES[2] : RESOLVED_ENCODE_MODES[1];
-    case COMPRESSION_MODES[0]:
-      if (source.isHdr) return RESOLVED_ENCODE_MODES[2];
-      return source.colorSpace === "srgb" ? RESOLVED_ENCODE_MODES[0] : RESOLVED_ENCODE_MODES[1];
+    case "none":
+      return "none";
+    case "etc1s":
+      return "etc1s";
+    case "uastc":
+      return source.isHdr ? "uastc-hdr" : "uastc";
+    case "auto":
+      if (source.isHdr) return "uastc-hdr";
+      return source.colorSpace === "srgb" ? "etc1s" : "uastc";
   }
 }
 function basisEncodeParamsFor(mode, source) {
   const resolved = resolveEncodeMode(mode, source);
   const srgbColor = source.colorSpace === "srgb";
   switch (resolved) {
-    case RESOLVED_ENCODE_MODES[3]:
+    case "none":
       return null;
-    case RESOLVED_ENCODE_MODES[0]:
+    case "etc1s":
       return {
-        mode: RESOLVED_ENCODE_MODES[0],
+        mode: "etc1s",
         srgb: srgbColor,
         perceptual: srgbColor,
         uastcSupercompression: false,
         mipGen: false
       };
-    case RESOLVED_ENCODE_MODES[1]:
+    case "uastc":
       return {
         mode: "uastc-ldr",
         srgb: srgbColor,
@@ -275,9 +273,9 @@ function basisEncodeParamsFor(mode, source) {
         uastcSupercompression: true,
         mipGen: false
       };
-    case RESOLVED_ENCODE_MODES[2]:
+    case "uastc-hdr":
       return {
-        mode: RESOLVED_ENCODE_MODES[2],
+        mode: "uastc-hdr",
         srgb: false,
         perceptual: false,
         uastcSupercompression: false,
@@ -369,7 +367,7 @@ function downscaleRgba(bytes, width, height, maxDimension) {
 // src/parse-image.ts
 init_result();
 var DEFAULT_MAX_DIMENSION = 16384;
-var SUPPORTED_MIMES = ["image/png", "image/jpeg", "image/x-tga"];
+var SUPPORTED_MIMES = ["image/png", "image/jpeg"];
 function parseImage(bytes, mime, opts = {}) {
   if (!SUPPORTED_MIMES.includes(mime)) {
     return err(
@@ -401,17 +399,12 @@ function parseImage(bytes, mime, opts = {}) {
         );
       }
       rgba = new Uint8Array(first);
-    } else if (mime === "image/jpeg") {
+    } else {
       const jpegMod = jpeg.default ?? jpeg;
       const decoded = jpegMod.decode(bytes, { useTArray: true, formatAsRGBA: true });
       width = decoded.width;
       height = decoded.height;
       rgba = decoded.data;
-    } else {
-      const decoded = decodeTga(bytes);
-      width = decoded.width;
-      height = decoded.height;
-      rgba = decoded.bytes;
     }
   } catch (e) {
     return err(
@@ -448,85 +441,12 @@ function parseImage(bytes, mime, opts = {}) {
     mipmap: opts.mipmap ?? true
   });
 }
-function decodeTga(bytes) {
-  if (bytes.length < 18) throw new Error("TGA header is truncated");
-  const colorMapType = bytes[1];
-  const imageType = bytes[2];
-  const idLength = bytes[0] ?? 0;
-  const width = (bytes[12] ?? 0) | (bytes[13] ?? 0) << 8;
-  const height = (bytes[14] ?? 0) | (bytes[15] ?? 0) << 8;
-  const pixelDepth = bytes[16] ?? 0;
-  const descriptor = bytes[17] ?? 0;
-  if (colorMapType !== 0) throw new Error("color-mapped TGA is unsupported");
-  if (width < 1 || height < 1) throw new Error("TGA dimensions must be positive");
-  const isTrueColor = imageType === 2 || imageType === 10;
-  const isGray = imageType === 3 || imageType === 11;
-  if (!isTrueColor && !isGray) throw new Error(`TGA image type ${imageType} is unsupported`);
-  if (isTrueColor && pixelDepth !== 24 && pixelDepth !== 32) {
-    throw new Error(`TGA true-color depth ${pixelDepth} is unsupported`);
-  }
-  if (isGray && pixelDepth !== 8)
-    throw new Error(`TGA grayscale depth ${pixelDepth} is unsupported`);
-  const bytesPerPixel = pixelDepth / 8;
-  let offset = 18 + idLength;
-  const pixelCount = width * height;
-  const out = new Uint8Array(pixelCount * 4);
-  const topOrigin = (descriptor & 32) !== 0;
-  const rightOrigin = (descriptor & 16) !== 0;
-  let filePixel = 0;
-  const writePixel = (pixel) => {
-    if (filePixel >= pixelCount) throw new Error("TGA pixel data has too many pixels");
-    const fileX = filePixel % width;
-    const fileY = Math.floor(filePixel / width);
-    const x = rightOrigin ? width - 1 - fileX : fileX;
-    const y = topOrigin ? fileY : height - 1 - fileY;
-    const destination = (y * width + x) * 4;
-    if (isGray) {
-      const value = pixel[0] ?? 0;
-      out[destination] = value;
-      out[destination + 1] = value;
-      out[destination + 2] = value;
-      out[destination + 3] = 255;
-    } else {
-      out[destination] = pixel[2] ?? 0;
-      out[destination + 1] = pixel[1] ?? 0;
-      out[destination + 2] = pixel[0] ?? 0;
-      out[destination + 3] = bytesPerPixel === 4 ? pixel[3] ?? 255 : 255;
-    }
-    filePixel += 1;
-  };
-  const readPixel = () => {
-    if (offset + bytesPerPixel > bytes.length) throw new Error("TGA pixel data is truncated");
-    const pixel = bytes.slice(offset, offset + bytesPerPixel);
-    offset += bytesPerPixel;
-    return pixel;
-  };
-  if (imageType === 2 || imageType === 3) {
-    while (filePixel < pixelCount) writePixel(readPixel());
-  } else {
-    while (filePixel < pixelCount) {
-      if (offset >= bytes.length) throw new Error("TGA RLE packet header is truncated");
-      const packet = bytes[offset++] ?? 0;
-      const count = (packet & 127) + 1;
-      if (filePixel + count > pixelCount) throw new Error("TGA RLE packet exceeds image bounds");
-      if ((packet & 128) !== 0) {
-        const pixel = readPixel();
-        for (let i = 0; i < count; i++) writePixel(pixel);
-      } else {
-        for (let i = 0; i < count; i++) writePixel(readPixel());
-      }
-    }
-  }
-  if (filePixel !== pixelCount) throw new Error("TGA pixel count mismatch");
-  return { width, height, bytes: out };
-}
 
 // src/image-importer.ts
 function mimeFromSource(source) {
   const lower = source.toLowerCase();
   if (lower.endsWith(".png")) return "image/png";
   if (lower.endsWith(".jpg") || lower.endsWith(".jpeg")) return "image/jpeg";
-  if (lower.endsWith(".tga")) return "image/x-tga";
   return void 0;
 }
 function requiredImageOutputKind(source) {
@@ -1027,7 +947,7 @@ async function importImage(ctx) {
   }
   if (mime === void 0) {
     throw new Error(
-      `imageImporter: unsupported source extension for "${ctx.source}" (expected .png / .jpg / .jpeg / .tga / .hdr / .ktx2 / .basis)`
+      `imageImporter: unsupported source extension for "${ctx.source}" (expected .png / .jpg / .jpeg / .hdr / .ktx2 / .basis)`
     );
   }
   const colorSpace = ctx.importSettings.colorSpace === "srgb" ? "srgb" : "linear";
@@ -1047,7 +967,7 @@ async function importImage(ctx) {
         "decode",
         "ldr",
         ctx.source,
-        "valid PNG, JPEG, or TGA bytes to decode into RGBA pixels",
+        "valid PNG or JPEG bytes to decode into RGBA pixels",
         `image:${decoded.error.code}`,
         "repair the source image bytes and retry the import"
       )
@@ -1097,11 +1017,69 @@ async function importImage(ctx) {
   }
   return { ok: true, value: { assets: out, sourceDependencies: [] } };
 }
+var decodeImageForImport = async (bytes, mimeType, importSettings) => {
+  const colorSpace = importSettings.colorSpace === "srgb" || importSettings.colorSpace === "linear" ? importSettings.colorSpace : "linear";
+  const mipmap = importSettings.mipmap === true;
+  const downscaleMaxDimension = typeof importSettings.downscaleMaxDimension === "number" && Number.isInteger(importSettings.downscaleMaxDimension) && importSettings.downscaleMaxDimension > 0 ? importSettings.downscaleMaxDimension : void 0;
+  const decoded = parseImage(bytes, mimeType, {
+    colorSpace,
+    mipmap,
+    ...downscaleMaxDimension === void 0 ? {} : { downscaleMaxDimension }
+  });
+  if (!decoded.ok) return decoded;
+  const tex = decoded.value;
+  const requestedCompression = importSettings.compressionMode === "auto" || importSettings.compressionMode === "etc1s" || importSettings.compressionMode === "uastc" || importSettings.compressionMode === "none" ? importSettings.compressionMode : "none";
+  const resolvedCompression = resolveEncodeMode(requestedCompression, {
+    colorSpace,
+    isHdr: false
+  });
+  let cookedBytes = tex.bytes;
+  let mediaType = mimeType;
+  let assetCodec = {
+    name: "rgba8",
+    version: "1"
+  };
+  if (resolvedCompression !== "none") {
+    const encoded = await encodeTextureToKtx2(
+      tex.bytes,
+      tex.width,
+      tex.height,
+      requestedCompression,
+      { colorSpace, isHdr: false }
+    );
+    if (!encoded.ok) {
+      throw new Error(
+        `embedded texture compression failed (${encoded.error.code} / ${encoded.error.mode}): ${encoded.error.reason}`
+      );
+    }
+    cookedBytes = encoded.value.ktx2;
+    mediaType = "image/ktx2";
+    assetCodec = { name: "basis", profile: encoded.value.mode };
+  }
+  return {
+    ok: true,
+    value: {
+      texture: {
+        kind: "texture",
+        data: cookedBytes,
+        width: tex.width,
+        height: tex.height,
+        format: colorSpaceToFormat(colorSpace),
+        colorSpace,
+        mipmap
+      },
+      bytes: cookedBytes,
+      mediaType,
+      assetCodec
+    }
+  };
+};
 var imageImporter = {
   key: "image",
-  import: importImage
+  import: importImage,
+  capabilities: { decodeImage: decodeImageForImport }
 };
 
-export { imageImporter };
+export { decodeImageForImport, imageImporter };
 //# sourceMappingURL=image-importer.mjs.map
 //# sourceMappingURL=image-importer.mjs.map