Web 图形与 3D / 系统课时
用 KTX2 降低纹理内存压力
用 KTX2 降低纹理内存压力
PNG 图片在网络上传输时可能只有几百 KB,但进入 GPU 后通常按解码后的像素格式占用显存。这里把一张 1024×1024 的颜色贴图制成 Basis Universal KTX2,接入 Three.js,并对照检查加载耗时、显存估算和材质外观。
学习目标
- 区分 KTX2 文件大小、运行时转码成本和 GPU 纹理占用。
- 配置
KTX2Loader、WASM 转码器与压缩格式能力检测。 - 用同一张图片比较 PNG 和 KTX2 的加载、显示与画质。
区分文件压缩与 GPU 压缩
PNG 的磁盘体积不能代表 GPU 占用。以带完整 mipmap 的 1024×1024 RGBA8 纹理为例,下表是纹理像素数据的理论大小,不包括驱动对齐、其他缓冲或运行时开销。
| GPU 格式示例 | 每像素位数 | 含 mipmap 的约占用 |
|---|---|---|
| RGBA8(未压缩) | 32 bit | 5.33 MiB |
| BC1 / ETC1(RGB) | 4 bit | 0.67 MiB |
| BC7 / ETC2 RGBA / ASTC 4×4 | 8 bit | 1.33 MiB |
KTX2 是容器,只有内容最终转为设备支持的 GPU 压缩格式,才获得上述显存收益。Basis Universal 纹理先下载,再由 Web Worker 中的 WASM 转码器选择 ASTC、BC、ETC 等目标格式;首次加载因此可能增加解码器下载、转码和上传等待。具体目标格式依设备而定。

准备 KTX2 文件和转码器
下面使用 Node.js 22.12+、npm、Three.js r186(npm 包 three@0.186.0)和 Khronos KTX-Software 5.x 的 ktx 命令。命令适用于 macOS、Linux 或 Windows 的 Git Bash。先创建 Vite 项目,再将与 Three.js 同版本的 JS/WASM 转码器作为静态文件发布。
npm create vite@latest ktx2-lab -- --template vanilla
cd ktx2-lab
npm install
npm install three@0.186.0
# Vite 的 public 目录会按原路径发布静态转码器
mkdir -p public/basis
cp node_modules/three/examples/jsm/libs/basis/basis_transcoder.js public/basis/
cp node_modules/three/examples/jsm/libs/basis/basis_transcoder.wasm public/basis/预期结果:public/basis/ 中有 basis_transcoder.js 和 basis_transcoder.wasm 两个文件。将一张 1024×1024、RGBA8、sRGB 的颜色贴图放在 public/albedo.png,然后生成带 mipmap 的 UASTC 纹理:
ktx create --encode uastc-ldr-4x4 --format R8G8B8A8_SRGB --assign-tf srgb --assign-primaries bt709 --generate-mipmap public/albedo.png public/albedo.ktx2预期结果:生成 public/albedo.ktx2。这里显式保留颜色贴图的 sRGB 语义,并离线生成 mipmap,避免把 mipmap 生成工作留到运行时。法线图属于线性数据,不应照搬 R8G8B8A8_SRGB。
配置加载器并渲染对照画面
将 Vite 项目的 src/main.js 完整替换为以下代码。页面左侧显示 PNG,右侧显示相同源图的 KTX2;两侧使用相同的 MeshBasicMaterial,避免灯光差异干扰比较。
import * as THREE from 'three';
import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(800, 420);
renderer.outputColorSpace = THREE.SRGBColorSpace;
document.querySelector('#app').replaceChildren(renderer.domElement);
const scene = new THREE.Scene();
scene.background = new THREE.Color(0x202938);
const camera = new THREE.OrthographicCamera(-2.1, 2.1, 1.1, -1.1, 0.1, 10);
camera.position.z = 3;
// 必须先根据当前 renderer 检测 GPU 压缩格式,再加载 KTX2。
const ktxLoader = new KTX2Loader()
.setTranscoderPath('/basis/')
.setWorkerLimit(2)
.detectSupport(renderer);
async function timed(loader, url) {
const start = performance.now();
const texture = await loader.loadAsync(url);
return { texture, ms: performance.now() - start };
}
try {
const [png, ktx] = await Promise.all([
timed(new THREE.TextureLoader(), '/albedo.png'),
timed(ktxLoader, '/albedo.ktx2')
]);
png.texture.colorSpace = THREE.SRGBColorSpace;
ktx.texture.colorSpace = THREE.SRGBColorSpace;
function addPlane(x, texture, invertV) {
const geometry = new THREE.PlaneGeometry(1.8, 1.8);
if (invertV) {
// 压缩纹理通常不能用 flipY 翻转,改用 UV 方向对齐 PNG。
const uv = geometry.attributes.uv;
for (let i = 0; i < uv.count; i++) uv.setY(i, 1 - uv.getY(i));
}
const material = new THREE.MeshBasicMaterial({ map: texture });
const mesh = new THREE.Mesh(geometry, material);
mesh.position.x = x;
scene.add(mesh);
}
addPlane(-1, png.texture, false);
addPlane(1, ktx.texture, true);
renderer.render(scene, camera);
console.log('对照画面已渲染');
// 仅估算纹理像素数据,不计 GPU 驱动分配和临时缓冲。
const pngBytes = png.texture.image.width * png.texture.image.height * 4 * 4 / 3;
const ktxBytes = ktx.texture.isCompressedTexture
? ktx.texture.mipmaps.reduce((n, level) => n + level.data.byteLength, 0)
: null;
console.table([
{
source: 'PNG', loadMs: png.ms.toFixed(1),
gpuCompressed: false, estimatedGpuMiB: (pngBytes / 1048576).toFixed(2)
},
{
source: 'KTX2', loadMs: ktx.ms.toFixed(1),
gpuCompressed: ktx.texture.isCompressedTexture === true,
estimatedGpuMiB: ktxBytes === null ? '非压缩回退' : (ktxBytes / 1048576).toFixed(2)
}
]);
} catch (error) {
console.error('纹理加载失败', error);
} finally {
// 释放转码 Worker;不会销毁已经加载的纹理。
ktxLoader.dispose();
}预期结果:资源路径正确时,页面绘制左右两张贴图;Console 输出“对照画面已渲染”及两条纹理统计,具体毫秒数和 GPU 压缩格式随设备变化。
上述 loadMs 包括下载与解码/转码等待,不等于单独的 GPU 上传时间;首次调用 KTX2 还可能包含 WASM 初始化。gpuCompressed 表示本次实际取得的纹理是否为 GPU 压缩纹理,而不是简单检查文件后缀。
运行并比较三类成本
在项目根目录运行:
npm run dev预期结果:终端显示可访问的 Vite 本地地址,端口以实际输出为准;在浏览器打开页面后,左边出现 PNG 贴图,右边出现 KTX2 贴图,Console 至少出现:
对照画面已渲染Console 还会列出两条纹理的实际 loadMs、gpuCompressed 和 estimatedGpuMiB;后者为像素数据估算,不等于显卡任务管理器中的实际显存占用。按同一浏览器、设备和网络条件执行下列检查:
- 在 DevTools 的 Network 面板启用 Disable cache,比较
albedo.png、albedo.ktx2的传输字节;冷启动时把basis_transcoder.wasm的额外请求单独记账。 - 比较 Console 的
loadMs,分别重复冷缓存和热缓存测试,每种至少运行 5 次取中位数;不要拿首次 WASM 初始化时间冒充每张纹理的恒定开销。 - 查看
estimatedGpuMiB:本例的 PNG 约 5.33 MiB,KTX2 依据实际转码后各 mipmap 的字节数求和;若显示“非压缩回退”,则未获得预期 GPU 压缩收益。renderer.info.memory.textures只能统计纹理数量。 - 在相同尺寸下观察渐变、细线、文字边缘及透明边界;需要时放大到接近 1:1,避免缩小显示掩盖压缩失真。
识别压缩失效和画质取舍
如果 KTX2 加载失败,先检查 Network 中 /basis/basis_transcoder.js、/basis/basis_transcoder.wasm 和 /albedo.ktx2 是否返回成功,再确认 detectSupport(renderer) 在 loadAsync() 前调用。纹理颠倒时检查 UV 方向;颜色偏灰或偏亮时检查 KTX2 的 sRGB 元数据和材质贴图用途,法线、粗糙度等数据贴图应使用线性数据语义。
本例选择 UASTC,是为了保留更多图像细节;若传输体积是首要瓶颈,可将生成命令的 --encode uastc-ldr-4x4 改为 --encode basis-lz 测试 ETC1S。ETC1S 往往文件更小、失真更明显,但 GPU 最终占用仍由实际转码目标决定。对大量大贴图应分批加载并预热转码器,避免同时发起过多转码和首次 GPU 上传;对于少量小图,额外的 WASM 下载可能得不偿失。接口参数可核对 Three.js KTX2Loader 文档 与 KTX-Software ktx create 文档。