Function ktxdecompress

packages/cli/src/transforms/ktxdecompress.ts:30–107

(options: KTXDecompressOptions = KTX_DECOMPRESS_DEFAULTS)

};

export const ktxdecompress = function (options: KTXDecompressOptions = KTX_DECOMPRESS_DEFAULTS): Transform {
	options = { ...KTX_DECOMPRESS_DEFAULTS, ...options };

	return createTransform('ktxdecompress', async (doc: Document): Promise<void> => {
		const logger = doc.getLogger();

		// Confirm recent version of KTX-Software is installed.
		await checkKTXSoftware(logger);

		// Create workspace. Avoid 'unsafeCleanup' and 'setGracefulCleanup', which
		// are not working as expected and are slated for removal:
		// https://github.com/raszi/node-tmp/pull/281
		const batchPrefix = uuid();
		const batchDir = tmp.dirSync({ prefix: 'gltf-transform-' });

		const basisuExtension = doc.createExtension(KHRTextureBasisu);
		const textures = doc.getRoot().listTextures();

		await pLimit(textures, options.jobs!, async (texture, textureIndex) => {
			const textureLabel =
				texture.getURI() || texture.getName() || `${textureIndex + 1}/${doc.getRoot().listTextures().length}`;
			const prefix = `ktx:texture(${textureLabel})`;

			const srcMimeType = texture.getMimeType();
			if (srcMimeType !== 'image/ktx2') return;

			const srcImage = texture.getImage()!;
			const srcExtension = texture.getURI()
				? FileUtils.extension(texture.getURI())
				: ImageUtils.mimeTypeToExtension(srcMimeType);
			const srcSize = texture.getSize();
			const srcBytes = srcImage ? srcImage.byteLength : null;

			if (!srcImage || !srcSize || !srcBytes) {
				logger.warn(`${prefix}: Skipping, unreadable texture.`);
				return;
			}

			// PREPARE: Create temporary in/out paths for the 'ktx' CLI tool, and determine
			// necessary command-line flags.

			const srcPath = join(batchDir.name, `${batchPrefix}_${textureIndex}.${srcExtension}`);
			const dstPath = join(batchDir.name, `${batchPrefix}_${textureIndex}.png`);

			await fs.writeFile(srcPath, srcImage);

			// COMPRESS: Run `ktx create` CLI tool.
			// eslint-disable-next-line @typescript-eslint/no-unused-vars
			const [status, _stdout, stderr] = await waitExit(spawn('ktx', ['extract', srcPath, dstPath]));

			if (status !== 0) {
				logger.error(`${prefix}: Failed → \n\n${stderr.toString()}`);
			} else {
				// PACK: Replace image data in the glTF asset.
				texture.setImage(await fs.readFile(dstPath)).setMimeType('image/png');
				if (texture.getURI()) {
					texture.setURI(FileUtils.basename(texture.getURI()) + '.png');
				}