@ringozz/godot 4.7.1-8 → 4.7.1-9

package/src/web-image.ts

@@ -1,118 +1,118 @@
-/**********************************************************************
- Copyright (c) Vladimir Davidovich. All rights reserved.
-***********************************************************************/
-
-// Web-only: decode the embedded PNG/WebP blobs of a `.ctex` CompressedTexture2D
-// container with the browser's `createImageBitmap`, and rebuild the container as
-// a raw RGBA8 `DATA_FORMAT_IMAGE` ctex — so no image codec runs in wasm on web.
-// Anything that isn't a PNG/WebP-embedded ctex is returned unchanged.
-
-const CTEX_MAGIC = 'GST2';
-const DATA_FORMAT_IMAGE = 0;
-const DATA_FORMAT_PNG = 1;
-const DATA_FORMAT_WEBP = 2;
-const FORMAT_RGBA8 = 5;
-const FORMAT_BIT_STREAM = 1 << 22;
-
-// Outer header: magic(4) version(4) w(4) h(4) df(4) mipmap_limit(4) reserved(12).
-const OUTER_HEADER_SIZE = 36;
-// Sub-header: data_format(4) w(2) h(2) mipmaps(4) format(4).
-const SUB_HEADER_OFFSET = OUTER_HEADER_SIZE;
-const SUB_HEADER_SIZE = 16;
-const BLOB_TABLE_OFFSET = SUB_HEADER_OFFSET + SUB_HEADER_SIZE;
-
-interface DecodedBitmap {
-	width: number;
-	height: number;
-	data: Uint8Array;
-}
-
-async function decodeWebBitmap(blob: Uint8Array<ArrayBuffer>, type: string): Promise<DecodedBitmap> {
-	const bmp = await createImageBitmap(new Blob([blob], { type }), {
-		imageOrientation: 'none',
-		colorSpaceConversion: 'none',
-		premultiplyAlpha: 'none',
-	});
-	try {
-		const canvas = new OffscreenCanvas(bmp.width, bmp.height);
-		const ctx = canvas.getContext('2d', { colorSpace: 'srgb', willReadFrequently: true }) as
-			| OffscreenCanvasRenderingContext2D
-			| null;
-		if (!ctx) {
-			throw new Error('web-image: no 2d context for OffscreenCanvas');
-		}
-		ctx.drawImage(bmp, 0, 0);
-		const img = ctx.getImageData(0, 0, bmp.width, bmp.height);
-		return { width: bmp.width, height: bmp.height, data: new Uint8Array(img.data.buffer, img.data.byteOffset, img.data.byteLength) };
-	} finally {
-		bmp.close();
-	}
-}
-
-/**
- * Decodes the embedded PNG/WebP blobs of a `.ctex` file with the browser's
- * `createImageBitmap` and rebuilds it as a raw RGBA8 (`DATA_FORMAT_IMAGE`)
- * container. Non-ctex bytes, streamable textures, and `DATA_FORMAT_IMAGE` /
- * `DATA_FORMAT_BASIS_UNIVERSAL` containers are returned unchanged. Throws if an
- * embedded blob can't be decoded or its dimensions don't match the expected
- * mipmap layout, so a would-be undecodable texture fails loudly at materialize
- * time. A no-op outside browsers (no `createImageBitmap`).
- */
-export async function decodeCtex(bytes: Uint8Array): Promise<Uint8Array> {
-	if (
-		typeof createImageBitmap !== 'function' ||
-		bytes.length < SUB_HEADER_OFFSET + SUB_HEADER_SIZE ||
-		String.fromCharCode(...bytes.subarray(0, 4)) !== CTEX_MAGIC
-	) {
-		return bytes;
-	}
-	const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-	if (dv.getUint32(16, true) & FORMAT_BIT_STREAM) {
-		return bytes; // streamable layout differs; leave it to the engine
-	}
-	const dataFormat = dv.getUint32(SUB_HEADER_OFFSET, true);
-	if (dataFormat !== DATA_FORMAT_PNG && dataFormat !== DATA_FORMAT_WEBP) {
-		return bytes; // raw and BASIS_UNIVERSAL containers pass through
-	}
-	const w = dv.getUint16(SUB_HEADER_OFFSET + 4, true);
-	const h = dv.getUint16(SUB_HEADER_OFFSET + 6, true);
-	const mipmaps = dv.getUint32(SUB_HEADER_OFFSET + 8, true);
-	const type = dataFormat === DATA_FORMAT_WEBP ? 'image/webp' : 'image/png';
-
-	let ofs = BLOB_TABLE_OFFSET;
-	const levels: Uint8Array[] = [];
-	for (let i = 0; i <= mipmaps; i++) {
-		if (ofs + 4 > bytes.length) {
-			throw new Error(`web-image: truncated ctex at mipmap ${i}`);
-		}
-		const size = dv.getUint32(ofs, true);
-		ofs += 4;
-		if (ofs + size > bytes.length) {
-			throw new Error(`web-image: truncated ctex blob at mipmap ${i}`);
-		}
-		const bmp = await decodeWebBitmap(bytes.slice(ofs, ofs + size), type);
-		ofs += size;
-		const ew = Math.max(w >> i, 1);
-		const eh = Math.max(h >> i, 1);
-		if (bmp.width !== ew || bmp.height !== eh) {
-			throw new Error(`web-image: mipmap ${i} decoded as ${bmp.width}x${bmp.height}, expected ${ew}x${eh}`);
-		}
-		levels.push(bmp.data);
-	}
-
-	const dataSize = levels.reduce((n, level) => n + level.length, 0);
-	const out = new Uint8Array(BLOB_TABLE_OFFSET + dataSize);
-	out.set(bytes.subarray(0, OUTER_HEADER_SIZE)); // outer header verbatim
-	const odv = new DataView(out.buffer);
-	odv.setUint32(SUB_HEADER_OFFSET, DATA_FORMAT_IMAGE, true);
-	odv.setUint16(SUB_HEADER_OFFSET + 4, w, true);
-	odv.setUint16(SUB_HEADER_OFFSET + 6, h, true);
-	odv.setUint32(SUB_HEADER_OFFSET + 8, mipmaps, true);
-	odv.setUint32(SUB_HEADER_OFFSET + 12, FORMAT_RGBA8, true);
-	let p = BLOB_TABLE_OFFSET;
-	for (const level of levels) {
-		out.set(level, p);
-		p += level.length;
-	}
-	return out;
-}
+/**********************************************************************
+ Copyright (c) Vladimir Davidovich. All rights reserved.
+***********************************************************************/
+
+// Web-only: decode the embedded PNG/WebP blobs of a `.ctex` CompressedTexture2D
+// container with the browser's `createImageBitmap`, and rebuild the container as
+// a raw RGBA8 `DATA_FORMAT_IMAGE` ctex — so no image codec runs in wasm on web.
+// Anything that isn't a PNG/WebP-embedded ctex is returned unchanged.
+
+const CTEX_MAGIC = 'GST2';
+const DATA_FORMAT_IMAGE = 0;
+const DATA_FORMAT_PNG = 1;
+const DATA_FORMAT_WEBP = 2;
+const FORMAT_RGBA8 = 5;
+const FORMAT_BIT_STREAM = 1 << 22;
+
+// Outer header: magic(4) version(4) w(4) h(4) df(4) mipmap_limit(4) reserved(12).
+const OUTER_HEADER_SIZE = 36;
+// Sub-header: data_format(4) w(2) h(2) mipmaps(4) format(4).
+const SUB_HEADER_OFFSET = OUTER_HEADER_SIZE;
+const SUB_HEADER_SIZE = 16;
+const BLOB_TABLE_OFFSET = SUB_HEADER_OFFSET + SUB_HEADER_SIZE;
+
+interface DecodedBitmap {
+	width: number;
+	height: number;
+	data: Uint8Array;
+}
+
+async function decodeWebBitmap(blob: Uint8Array<ArrayBuffer>, type: string): Promise<DecodedBitmap> {
+	const bmp = await createImageBitmap(new Blob([blob], { type }), {
+		imageOrientation: 'none',
+		colorSpaceConversion: 'none',
+		premultiplyAlpha: 'none',
+	});
+	try {
+		const canvas = new OffscreenCanvas(bmp.width, bmp.height);
+		const ctx = canvas.getContext('2d', { colorSpace: 'srgb', willReadFrequently: true }) as
+			| OffscreenCanvasRenderingContext2D
+			| null;
+		if (!ctx) {
+			throw new Error('web-image: no 2d context for OffscreenCanvas');
+		}
+		ctx.drawImage(bmp, 0, 0);
+		const img = ctx.getImageData(0, 0, bmp.width, bmp.height);
+		return { width: bmp.width, height: bmp.height, data: new Uint8Array(img.data.buffer, img.data.byteOffset, img.data.byteLength) };
+	} finally {
+		bmp.close();
+	}
+}
+
+/**
+ * Decodes the embedded PNG/WebP blobs of a `.ctex` file with the browser's
+ * `createImageBitmap` and rebuilds it as a raw RGBA8 (`DATA_FORMAT_IMAGE`)
+ * container. Non-ctex bytes, streamable textures, and `DATA_FORMAT_IMAGE` /
+ * `DATA_FORMAT_BASIS_UNIVERSAL` containers are returned unchanged. Throws if an
+ * embedded blob can't be decoded or its dimensions don't match the expected
+ * mipmap layout, so a would-be undecodable texture fails loudly at materialize
+ * time. A no-op outside browsers (no `createImageBitmap`).
+ */
+export async function decodeCtex(bytes: Uint8Array): Promise<Uint8Array> {
+	if (
+		typeof createImageBitmap !== 'function' ||
+		bytes.length < SUB_HEADER_OFFSET + SUB_HEADER_SIZE ||
+		String.fromCharCode(...bytes.subarray(0, 4)) !== CTEX_MAGIC
+	) {
+		return bytes;
+	}
+	const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	if (dv.getUint32(16, true) & FORMAT_BIT_STREAM) {
+		return bytes; // streamable layout differs; leave it to the engine
+	}
+	const dataFormat = dv.getUint32(SUB_HEADER_OFFSET, true);
+	if (dataFormat !== DATA_FORMAT_PNG && dataFormat !== DATA_FORMAT_WEBP) {
+		return bytes; // raw and BASIS_UNIVERSAL containers pass through
+	}
+	const w = dv.getUint16(SUB_HEADER_OFFSET + 4, true);
+	const h = dv.getUint16(SUB_HEADER_OFFSET + 6, true);
+	const mipmaps = dv.getUint32(SUB_HEADER_OFFSET + 8, true);
+	const type = dataFormat === DATA_FORMAT_WEBP ? 'image/webp' : 'image/png';
+
+	let ofs = BLOB_TABLE_OFFSET;
+	const levels: Uint8Array[] = [];
+	for (let i = 0; i <= mipmaps; i++) {
+		if (ofs + 4 > bytes.length) {
+			throw new Error(`web-image: truncated ctex at mipmap ${i}`);
+		}
+		const size = dv.getUint32(ofs, true);
+		ofs += 4;
+		if (ofs + size > bytes.length) {
+			throw new Error(`web-image: truncated ctex blob at mipmap ${i}`);
+		}
+		const bmp = await decodeWebBitmap(bytes.slice(ofs, ofs + size), type);
+		ofs += size;
+		const ew = Math.max(w >> i, 1);
+		const eh = Math.max(h >> i, 1);
+		if (bmp.width !== ew || bmp.height !== eh) {
+			throw new Error(`web-image: mipmap ${i} decoded as ${bmp.width}x${bmp.height}, expected ${ew}x${eh}`);
+		}
+		levels.push(bmp.data);
+	}
+
+	const dataSize = levels.reduce((n, level) => n + level.length, 0);
+	const out = new Uint8Array(BLOB_TABLE_OFFSET + dataSize);
+	out.set(bytes.subarray(0, OUTER_HEADER_SIZE)); // outer header verbatim
+	const odv = new DataView(out.buffer);
+	odv.setUint32(SUB_HEADER_OFFSET, DATA_FORMAT_IMAGE, true);
+	odv.setUint16(SUB_HEADER_OFFSET + 4, w, true);
+	odv.setUint16(SUB_HEADER_OFFSET + 6, h, true);
+	odv.setUint32(SUB_HEADER_OFFSET + 8, mipmaps, true);
+	odv.setUint32(SUB_HEADER_OFFSET + 12, FORMAT_RGBA8, true);
+	let p = BLOB_TABLE_OFFSET;
+	for (const level of levels) {
+		out.set(level, p);
+		p += level.length;
+	}
+	return out;
+}