s3m-three 0.3.12 → 0.3.14

package/src/worker/S3MWorkerClient.ts

@@ -97,13 +97,16 @@ export class S3MWorkerClient {
     });
   }
 
-  /** 解码一张纹理（DXT / CRN / WEBP / RGB 系）。tex.data 走 structured clone，主线程保留原数据 */
-  decodeTexture(tex: S3MTexture, compressed = false): Promise<DecodedTextureData> {
+  /**
+   * 解码一张纹理（DXT / CRN / WEBP / RGB 系）。tex.data 走 structured clone，主线程保留原数据。
+   * `maxSize` 交给 Worker 侧收口——缩放本身也是 CPU 活，放在 Worker 里主线程零成本。
+   */
+  decodeTexture(tex: S3MTexture, compressed = false, maxSize?: number): Promise<DecodedTextureData> {
     if (this.dead) return Promise.reject(new WorkerDeadError('s3m 解析 Worker 已终止'));
     const id = ++this._seq;
     return new Promise<DecodedTextureData>((resolve, reject) => {
       this._pending.set(id, { resolve: resolve as (v: unknown) => void, reject });
-      this._worker.postMessage({ type: 'tex', id, tex, compressed });
+      this._worker.postMessage({ type: 'tex', id, tex, compressed, maxSize });
     });
   }
 
@@ -147,12 +150,13 @@ export function getSharedS3MWorker(): S3MWorkerClient | null {
  */
 export async function decodeTextureWithWorker(
   tex: S3MTexture,
-  compressed: boolean
+  compressed: boolean,
+  maxSize?: number
 ): Promise<DecodedTextureData | null> {
   const client = getSharedS3MWorker();
   if (!client) return null;
   try {
-    return await client.decodeTexture(tex, compressed);
+    return await client.decodeTexture(tex, compressed, maxSize);
   } catch {
     return null;
   }

package/src/worker/s3mWorker.ts

@@ -29,7 +29,7 @@ type ParseRequest = {
   assemble?: boolean;
   batching?: boolean;
 };
-type TexRequest = { type: 'tex'; id: number; tex: S3MTexture; compressed?: boolean };
+type TexRequest = { type: 'tex'; id: number; tex: S3MTexture; compressed?: boolean; maxSize?: number };
 type Request = ParseRequest | TexRequest;
 
 type ParseResponse =
@@ -65,7 +65,7 @@ ctx.onmessage = async (e: MessageEvent<Request>) => {
         ctx.postMessage({ id, ok: true, tile } satisfies ParseResponse, collectTransferables(tile));
       }
     } else {
-      const data = await decodeTextureData(msg.tex, { compressed: msg.compressed });
+      const data = await decodeTextureData(msg.tex, { compressed: msg.compressed, maxSize: msg.maxSize });
       ctx.postMessage({ id, ok: true, data } satisfies TexResponse, texTransferList(data));
     }
   } catch (err) {