@forgeax/engine-image 0.1.3 → 0.1.4

package/src/image-importer.ts

@@ -762,9 +762,87 @@ async function importImage(ctx: ImportContext): Promise<ImportResult> {
   return { ok: true, value: { assets: out, sourceDependencies: [] } };
 }
 
+/** Bind the image producer to the generic importer runner's decode seam. */
+export const decodeImageForImport: ImportContext['decodeImage'] = 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
+      : undefined;
+  const decoded = parseImage(bytes, mimeType, {
+    colorSpace,
+    mipmap,
+    ...(downscaleMaxDimension === undefined ? {} : { 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: string = mimeType;
+  let assetCodec: { name: string; profile?: string; version?: string } = {
+    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 as const,
+    value: {
+      texture: {
+        kind: 'texture' as const,
+        data: cookedBytes,
+        width: tex.width,
+        height: tex.height,
+        format: colorSpaceToFormat(colorSpace),
+        colorSpace,
+        mipmap,
+      },
+      bytes: cookedBytes,
+      mediaType,
+      assetCodec,
+    },
+  };
+};
+
 /**
  * The image {@link Importer}. Register it into an `ImporterRegistry` so the
- * import runner dispatches `meta.importer === 'image'` sidecars here.
+ * import runner dispatches `meta.importer === 'image'` sidecars here and can
+ * offer the same producer's decoder to importers with embedded images.
  *
  * @example
  * ```ts
@@ -777,4 +855,5 @@ async function importImage(ctx: ImportContext): Promise<ImportResult> {
 export const imageImporter: Importer = {
   key: 'image',
   import: importImage,
+  capabilities: { decodeImage: decodeImageForImport },
 };