cione-comp-lib
Version:
`$ yarn add cione-comp-lib` 或者 `$ npm i cione-comp-lib -S`
450 lines (449 loc) • 16.9 kB
JavaScript
import { Loader, FileLoader, CompressedArrayTexture, UnsignedByteType, CompressedTexture, LinearFilter, LinearMipmapLinearFilter, sRGBEncoding, LinearEncoding, RGBAFormat, RGBA_ASTC_4x4_Format, RGBA_BPTC_Format, RGBA_ETC2_EAC_Format, RGBA_PVRTC_4BPPV1_Format, RGBA_S3TC_DXT5_Format, RGB_ETC1_Format, RGB_ETC2_Format, RGB_PVRTC_4BPPV1_Format, RGB_S3TC_DXT1_Format, RGFormat, RedFormat, FloatType, HalfFloatType, DataTexture, Data3DTexture } from "../../../build/three.module.mjs";
import { WorkerPool } from "../utils/WorkerPool.mjs";
import { KHR_DF_TRANSFER_SRGB as x, KHR_DF_FLAG_ALPHA_PREMULTIPLIED as p, read as Pi, VK_FORMAT_UNDEFINED as nt, VK_FORMAT_R32G32B32A32_SFLOAT as Ae, VK_FORMAT_R16G16B16A16_SFLOAT as pe, VK_FORMAT_R8G8B8A8_UNORM as Ot, VK_FORMAT_R8G8B8A8_SRGB as Ft, VK_FORMAT_R32G32_SFLOAT as de, VK_FORMAT_R16G16_SFLOAT as se, VK_FORMAT_R8G8_UNORM as yt, VK_FORMAT_R8G8_SRGB as dt, VK_FORMAT_R32_SFLOAT as xe, VK_FORMAT_R16_SFLOAT as $t, VK_FORMAT_R8_SRGB as gt, VK_FORMAT_R8_UNORM as ct, KHR_SUPERCOMPRESSION_NONE as t, KHR_SUPERCOMPRESSION_ZSTD as n } from "../libs/ktx-parse.module.mjs";
import { ZSTDDecoder as Q } from "../libs/zstddec.module.mjs";
const _taskCache = /* @__PURE__ */ new WeakMap();
let _activeLoaders = 0;
let _zstd;
class KTX2Loader extends Loader {
constructor(manager) {
super(manager);
this.transcoderPath = "";
this.transcoderBinary = null;
this.transcoderPending = null;
this.workerPool = new WorkerPool();
this.workerSourceURL = "";
this.workerConfig = null;
if (typeof MSC_TRANSCODER !== "undefined") {
console.warn(
'THREE.KTX2Loader: Please update to latest "basis_transcoder". "msc_basis_transcoder" is no longer supported in three.js r125+.'
);
}
}
setTranscoderPath(path) {
this.transcoderPath = path;
return this;
}
setWorkerLimit(num) {
this.workerPool.setWorkerLimit(num);
return this;
}
detectSupport(renderer) {
this.workerConfig = {
astcSupported: renderer.extensions.has("WEBGL_compressed_texture_astc"),
etc1Supported: renderer.extensions.has("WEBGL_compressed_texture_etc1"),
etc2Supported: renderer.extensions.has("WEBGL_compressed_texture_etc"),
dxtSupported: renderer.extensions.has("WEBGL_compressed_texture_s3tc"),
bptcSupported: renderer.extensions.has("EXT_texture_compression_bptc"),
pvrtcSupported: renderer.extensions.has("WEBGL_compressed_texture_pvrtc") || renderer.extensions.has("WEBKIT_WEBGL_compressed_texture_pvrtc")
};
if (renderer.capabilities.isWebGL2) {
this.workerConfig.etc1Supported = false;
}
return this;
}
init() {
if (!this.transcoderPending) {
const jsLoader = new FileLoader(this.manager);
jsLoader.setPath(this.transcoderPath);
jsLoader.setWithCredentials(this.withCredentials);
const jsContent = jsLoader.loadAsync("basis_transcoder.js");
const binaryLoader = new FileLoader(this.manager);
binaryLoader.setPath(this.transcoderPath);
binaryLoader.setResponseType("arraybuffer");
binaryLoader.setWithCredentials(this.withCredentials);
const binaryContent = binaryLoader.loadAsync("basis_transcoder.wasm");
this.transcoderPending = Promise.all([jsContent, binaryContent]).then(([jsContent2, binaryContent2]) => {
const fn = KTX2Loader.BasisWorker.toString();
const body = [
"/* constants */",
"let _EngineFormat = " + JSON.stringify(KTX2Loader.EngineFormat),
"let _TranscoderFormat = " + JSON.stringify(KTX2Loader.TranscoderFormat),
"let _BasisFormat = " + JSON.stringify(KTX2Loader.BasisFormat),
"/* basis_transcoder.js */",
jsContent2,
"/* worker */",
fn.substring(fn.indexOf("{") + 1, fn.lastIndexOf("}"))
].join("\n");
this.workerSourceURL = URL.createObjectURL(new Blob([body]));
this.transcoderBinary = binaryContent2;
this.workerPool.setWorkerCreator(() => {
const worker = new Worker(this.workerSourceURL);
const transcoderBinary = this.transcoderBinary.slice(0);
worker.postMessage({ type: "init", config: this.workerConfig, transcoderBinary }, [transcoderBinary]);
return worker;
});
});
if (_activeLoaders > 0) {
console.warn(
"THREE.KTX2Loader: Multiple active KTX2 loaders may cause performance issues. Use a single KTX2Loader instance, or call .dispose() on old instances."
);
}
_activeLoaders++;
}
return this.transcoderPending;
}
load(url, onLoad, onProgress, onError) {
if (this.workerConfig === null) {
throw new Error("THREE.KTX2Loader: Missing initialization with `.detectSupport( renderer )`.");
}
const loader = new FileLoader(this.manager);
loader.setResponseType("arraybuffer");
loader.setWithCredentials(this.withCredentials);
loader.load(url, (buffer) => {
if (_taskCache.has(buffer)) {
const cachedTask = _taskCache.get(buffer);
return cachedTask.promise.then(onLoad).catch(onError);
}
this._createTexture(buffer).then((texture) => onLoad ? onLoad(texture) : null).catch(onError);
}, onProgress, onError);
}
_createTextureFrom(transcodeResult, container) {
const { mipmaps, width, height, format, type, error, dfdTransferFn, dfdFlags } = transcodeResult;
if (type === "error")
return Promise.reject(error);
const texture = container.layerCount > 1 ? new CompressedArrayTexture(mipmaps, width, height, container.layerCount, format, UnsignedByteType) : new CompressedTexture(mipmaps, width, height, format, UnsignedByteType);
texture.minFilter = mipmaps.length === 1 ? LinearFilter : LinearMipmapLinearFilter;
texture.magFilter = LinearFilter;
texture.generateMipmaps = false;
texture.needsUpdate = true;
texture.encoding = dfdTransferFn === x ? sRGBEncoding : LinearEncoding;
texture.premultiplyAlpha = !!(dfdFlags & p);
return texture;
}
async _createTexture(buffer, config = {}) {
const container = Pi(new Uint8Array(buffer));
if (container.vkFormat !== nt) {
return createDataTexture(container);
}
const taskConfig = config;
const texturePending = this.init().then(() => {
return this.workerPool.postMessage({ type: "transcode", buffer, taskConfig }, [buffer]);
}).then((e) => this._createTextureFrom(e.data, container));
_taskCache.set(buffer, { promise: texturePending });
return texturePending;
}
dispose() {
this.workerPool.dispose();
if (this.workerSourceURL)
URL.revokeObjectURL(this.workerSourceURL);
_activeLoaders--;
return this;
}
}
KTX2Loader.BasisFormat = {
ETC1S: 0,
UASTC_4x4: 1
};
KTX2Loader.TranscoderFormat = {
ETC1: 0,
ETC2: 1,
BC1: 2,
BC3: 3,
BC4: 4,
BC5: 5,
BC7_M6_OPAQUE_ONLY: 6,
BC7_M5: 7,
PVRTC1_4_RGB: 8,
PVRTC1_4_RGBA: 9,
ASTC_4x4: 10,
ATC_RGB: 11,
ATC_RGBA_INTERPOLATED_ALPHA: 12,
RGBA32: 13,
RGB565: 14,
BGR565: 15,
RGBA4444: 16
};
KTX2Loader.EngineFormat = {
RGBAFormat,
RGBA_ASTC_4x4_Format,
RGBA_BPTC_Format,
RGBA_ETC2_EAC_Format,
RGBA_PVRTC_4BPPV1_Format,
RGBA_S3TC_DXT5_Format,
RGB_ETC1_Format,
RGB_ETC2_Format,
RGB_PVRTC_4BPPV1_Format,
RGB_S3TC_DXT1_Format
};
KTX2Loader.BasisWorker = function() {
let config;
let transcoderPending;
let BasisModule;
const EngineFormat = _EngineFormat;
const TranscoderFormat = _TranscoderFormat;
const BasisFormat = _BasisFormat;
self.addEventListener("message", function(e) {
const message = e.data;
switch (message.type) {
case "init":
config = message.config;
init(message.transcoderBinary);
break;
case "transcode":
transcoderPending.then(() => {
try {
const { width, height, hasAlpha, mipmaps, format, dfdTransferFn, dfdFlags } = transcode(message.buffer);
const buffers = [];
for (let i = 0; i < mipmaps.length; ++i) {
buffers.push(mipmaps[i].data.buffer);
}
self.postMessage({ type: "transcode", id: message.id, width, height, hasAlpha, mipmaps, format, dfdTransferFn, dfdFlags }, buffers);
} catch (error) {
console.error(error);
self.postMessage({ type: "error", id: message.id, error: error.message });
}
});
break;
}
});
function init(wasmBinary) {
transcoderPending = new Promise((resolve) => {
BasisModule = { wasmBinary, onRuntimeInitialized: resolve };
BASIS(BasisModule);
}).then(() => {
BasisModule.initializeBasis();
if (BasisModule.KTX2File === void 0) {
console.warn("THREE.KTX2Loader: Please update Basis Universal transcoder.");
}
});
}
function transcode(buffer) {
const ktx2File = new BasisModule.KTX2File(new Uint8Array(buffer));
function cleanup() {
ktx2File.close();
ktx2File.delete();
}
if (!ktx2File.isValid()) {
cleanup();
throw new Error("THREE.KTX2Loader: Invalid or unsupported .ktx2 file");
}
const basisFormat = ktx2File.isUASTC() ? BasisFormat.UASTC_4x4 : BasisFormat.ETC1S;
const width = ktx2File.getWidth();
const height = ktx2File.getHeight();
const layers = ktx2File.getLayers() || 1;
const levels = ktx2File.getLevels();
const hasAlpha = ktx2File.getHasAlpha();
const dfdTransferFn = ktx2File.getDFDTransferFunc();
const dfdFlags = ktx2File.getDFDFlags();
const { transcoderFormat, engineFormat } = getTranscoderFormat(basisFormat, width, height, hasAlpha);
if (!width || !height || !levels) {
cleanup();
throw new Error("THREE.KTX2Loader: Invalid texture");
}
if (!ktx2File.startTranscoding()) {
cleanup();
throw new Error("THREE.KTX2Loader: .startTranscoding failed");
}
const mipmaps = [];
for (let mip = 0; mip < levels; mip++) {
const layerMips = [];
let mipWidth, mipHeight;
for (let layer = 0; layer < layers; layer++) {
const levelInfo = ktx2File.getImageLevelInfo(mip, layer, 0);
mipWidth = levelInfo.origWidth < 4 ? levelInfo.origWidth : levelInfo.width;
mipHeight = levelInfo.origHeight < 4 ? levelInfo.origHeight : levelInfo.height;
const dst = new Uint8Array(ktx2File.getImageTranscodedSizeInBytes(mip, layer, 0, transcoderFormat));
const status = ktx2File.transcodeImage(
dst,
mip,
layer,
0,
transcoderFormat,
0,
-1,
-1
);
if (!status) {
cleanup();
throw new Error("THREE.KTX2Loader: .transcodeImage failed.");
}
layerMips.push(dst);
}
mipmaps.push({ data: concat(layerMips), width: mipWidth, height: mipHeight });
}
cleanup();
return { width, height, hasAlpha, mipmaps, format: engineFormat, dfdTransferFn, dfdFlags };
}
const FORMAT_OPTIONS = [
{
if: "astcSupported",
basisFormat: [BasisFormat.UASTC_4x4],
transcoderFormat: [TranscoderFormat.ASTC_4x4, TranscoderFormat.ASTC_4x4],
engineFormat: [EngineFormat.RGBA_ASTC_4x4_Format, EngineFormat.RGBA_ASTC_4x4_Format],
priorityETC1S: Infinity,
priorityUASTC: 1,
needsPowerOfTwo: false
},
{
if: "bptcSupported",
basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
transcoderFormat: [TranscoderFormat.BC7_M5, TranscoderFormat.BC7_M5],
engineFormat: [EngineFormat.RGBA_BPTC_Format, EngineFormat.RGBA_BPTC_Format],
priorityETC1S: 3,
priorityUASTC: 2,
needsPowerOfTwo: false
},
{
if: "dxtSupported",
basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
transcoderFormat: [TranscoderFormat.BC1, TranscoderFormat.BC3],
engineFormat: [EngineFormat.RGB_S3TC_DXT1_Format, EngineFormat.RGBA_S3TC_DXT5_Format],
priorityETC1S: 4,
priorityUASTC: 5,
needsPowerOfTwo: false
},
{
if: "etc2Supported",
basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
transcoderFormat: [TranscoderFormat.ETC1, TranscoderFormat.ETC2],
engineFormat: [EngineFormat.RGB_ETC2_Format, EngineFormat.RGBA_ETC2_EAC_Format],
priorityETC1S: 1,
priorityUASTC: 3,
needsPowerOfTwo: false
},
{
if: "etc1Supported",
basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
transcoderFormat: [TranscoderFormat.ETC1],
engineFormat: [EngineFormat.RGB_ETC1_Format],
priorityETC1S: 2,
priorityUASTC: 4,
needsPowerOfTwo: false
},
{
if: "pvrtcSupported",
basisFormat: [BasisFormat.ETC1S, BasisFormat.UASTC_4x4],
transcoderFormat: [TranscoderFormat.PVRTC1_4_RGB, TranscoderFormat.PVRTC1_4_RGBA],
engineFormat: [EngineFormat.RGB_PVRTC_4BPPV1_Format, EngineFormat.RGBA_PVRTC_4BPPV1_Format],
priorityETC1S: 5,
priorityUASTC: 6,
needsPowerOfTwo: true
}
];
const ETC1S_OPTIONS = FORMAT_OPTIONS.sort(function(a, b) {
return a.priorityETC1S - b.priorityETC1S;
});
const UASTC_OPTIONS = FORMAT_OPTIONS.sort(function(a, b) {
return a.priorityUASTC - b.priorityUASTC;
});
function getTranscoderFormat(basisFormat, width, height, hasAlpha) {
let transcoderFormat;
let engineFormat;
const options = basisFormat === BasisFormat.ETC1S ? ETC1S_OPTIONS : UASTC_OPTIONS;
for (let i = 0; i < options.length; i++) {
const opt = options[i];
if (!config[opt.if])
continue;
if (!opt.basisFormat.includes(basisFormat))
continue;
if (hasAlpha && opt.transcoderFormat.length < 2)
continue;
if (opt.needsPowerOfTwo && !(isPowerOfTwo(width) && isPowerOfTwo(height)))
continue;
transcoderFormat = opt.transcoderFormat[hasAlpha ? 1 : 0];
engineFormat = opt.engineFormat[hasAlpha ? 1 : 0];
return { transcoderFormat, engineFormat };
}
console.warn("THREE.KTX2Loader: No suitable compressed texture format found. Decoding to RGBA32.");
transcoderFormat = TranscoderFormat.RGBA32;
engineFormat = EngineFormat.RGBAFormat;
return { transcoderFormat, engineFormat };
}
function isPowerOfTwo(value) {
if (value <= 2)
return true;
return (value & value - 1) === 0 && value !== 0;
}
function concat(arrays) {
let totalByteLength = 0;
for (const array of arrays) {
totalByteLength += array.byteLength;
}
const result = new Uint8Array(totalByteLength);
let byteOffset = 0;
for (const array of arrays) {
result.set(array, byteOffset);
byteOffset += array.byteLength;
}
return result;
}
};
const FORMAT_MAP = {
[Ae]: RGBAFormat,
[pe]: RGBAFormat,
[Ot]: RGBAFormat,
[Ft]: RGBAFormat,
[de]: RGFormat,
[se]: RGFormat,
[yt]: RGFormat,
[dt]: RGFormat,
[xe]: RedFormat,
[$t]: RedFormat,
[gt]: RedFormat,
[ct]: RedFormat
};
const TYPE_MAP = {
[Ae]: FloatType,
[pe]: HalfFloatType,
[Ot]: UnsignedByteType,
[Ft]: UnsignedByteType,
[de]: FloatType,
[se]: HalfFloatType,
[yt]: UnsignedByteType,
[dt]: UnsignedByteType,
[xe]: FloatType,
[$t]: HalfFloatType,
[gt]: UnsignedByteType,
[ct]: UnsignedByteType
};
const ENCODING_MAP = {
[Ft]: sRGBEncoding,
[dt]: sRGBEncoding,
[gt]: sRGBEncoding
};
async function createDataTexture(container) {
const { vkFormat, pixelWidth, pixelHeight, pixelDepth } = container;
if (FORMAT_MAP[vkFormat] === void 0) {
throw new Error("THREE.KTX2Loader: Unsupported vkFormat.");
}
const level = container.levels[0];
let levelData;
let view;
if (container.supercompressionScheme === t) {
levelData = level.levelData;
} else if (container.supercompressionScheme === n) {
if (!_zstd) {
_zstd = new Promise(async (resolve) => {
const zstd = new Q();
await zstd.init();
resolve(zstd);
});
}
levelData = (await _zstd).decode(level.levelData, level.uncompressedByteLength);
} else {
throw new Error("THREE.KTX2Loader: Unsupported supercompressionScheme.");
}
if (TYPE_MAP[vkFormat] === FloatType) {
view = new Float32Array(
levelData.buffer,
levelData.byteOffset,
levelData.byteLength / Float32Array.BYTES_PER_ELEMENT
);
} else if (TYPE_MAP[vkFormat] === HalfFloatType) {
view = new Uint16Array(
levelData.buffer,
levelData.byteOffset,
levelData.byteLength / Uint16Array.BYTES_PER_ELEMENT
);
} else {
view = levelData;
}
const texture = pixelDepth === 0 ? new DataTexture(view, pixelWidth, pixelHeight) : new Data3DTexture(view, pixelWidth, pixelHeight, pixelDepth);
texture.type = TYPE_MAP[vkFormat];
texture.format = FORMAT_MAP[vkFormat];
texture.encoding = ENCODING_MAP[vkFormat] || LinearEncoding;
texture.needsUpdate = true;
return Promise.resolve(texture);
}
export { KTX2Loader };