gputex 0.0.4 → 0.0.5

package/README.md

@@ -158,9 +158,9 @@ encoder.destroy()
 - `texture-compression-bc` (desktop) or `texture-compression-astc` (mobile) for compressed output
 - Falls back to uncompressed RGBA8 when neither is available
 
-## Known issues
+## Device-specific workarounds
 
-- Black texture on Google Pixel 10
+- Black texture on Google Pixel 10: `copyExternalImageToTexture` produces black textures on the Pixel 10's PowerVR DXT GPU (vendor `img-tec`, architecture `d-series`). Worked around by uploading via `writeTexture` with rasterised pixel data instead.
 
 ## Acknowledgements
 

package/dist/index.js

@@ -50,6 +50,25 @@ import {
   SRGBColorSpace,
   RepeatWrapping
 } from "three";
+
+// src/workarounds.ts
+function needsWriteTextureWorkaround(adapter) {
+  const { vendor, architecture } = adapter.info ?? {};
+  return vendor === "img-tec" && architecture === "d-series";
+}
+function uploadSourceTexture(device, srcTex, source, width, height, flipY, useWriteTexture) {
+  if (useWriteTexture && source instanceof ImageData) {
+    device.queue.writeTexture({ texture: srcTex }, source.data, { bytesPerRow: width * 4 }, [width, height, 1]);
+  } else {
+    device.queue.copyExternalImageToTexture({ source, flipY }, { texture: srcTex }, [
+      width,
+      height,
+      1
+    ]);
+  }
+}
+
+// src/Encoder.ts
 var Encoder = class {
   /**
    * Subclasses set this to the WebGPU feature string the output texture
@@ -184,9 +203,11 @@ var Encoder = class {
       label: `${this.label}-src`,
       size: [paddedWidth, paddedHeight, 1],
       format: "rgba8unorm",
+      // RENDER_ATTACHMENT is required by copyExternalImageToTexture
+      // (internally a blit) even though we never render into this texture.
       usage: GPUTextureUsage.COPY_DST | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT
     });
-    device.queue.copyExternalImageToTexture({ source, flipY }, { texture: srcTex }, [width, height, 1]);
+    uploadSourceTexture(device, srcTex, source, width, height, flipY, source instanceof ImageData);
     const dstBuffer = device.createBuffer({
       label: `${this.label}-dst`,
       size: outByteLen,
@@ -608,8 +629,16 @@ async function compressTexture(source, options = {}) {
     encoder = await selection.encoderClass.create();
   }
   try {
+    const needsWriteTexture = needsWriteTextureWorkaround(adapter);
     if (!mipmaps) {
-      const bytes = await encoder.encodeToBytes(bitmap, { flipY });
+      let bytes;
+      if (needsWriteTexture) {
+        const level02 = bitmapToMipLevel(bitmap, flipY);
+        const imageData = mipLevelToImageData(level02);
+        bytes = await encoder.encodeToBytes(imageData);
+      } else {
+        bytes = await encoder.encodeToBytes(bitmap, { flipY });
+      }
       const tex2 = encoder.buildMippedTexture([bytes], { colorSpace });
       return {
         texture: tex2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gputex",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "license": "MIT",
   "files": [
     "dist"