Web 图形与 3D / 系统课时
用 KTX2 降低纹理显存占用
用 KTX2 降低纹理显存占用
PNG、JPEG 文件很小,不代表纹理上传 GPU 后也小。本篇以一份带贴图的 GLB 为例,将纹理改为 KTX2,接入 Three.js 的设备格式检测和转码流程,再对照文件体积、画面细节与显存估算判断是否值得采用。
学习目标
- 使用 glTF-Transform 将 GLB 内的常规贴图转换为 KTX2。
- 正确配置
KTX2Loader、转码文件路径和GLTFLoader。 - 用可复核的指标区分下载体积、GPU 显存占用和画质。
KTX2 如何减少显存
PNG、JPEG 通常在上传 GPU 前被解码。以 2048×2048 的 RGBA8 贴图为例,基础层为 16 MiB,包含完整 mipmap 约 21.3 MiB;如果设备采用每像素 8 bit 的 GPU 块压缩格式,同尺寸、含 mipmap 的理论占用约 5.3 MiB。
KTX2 是纹理容器,不等同于某一种压缩算法。这里使用 Basis Universal 的 ETC1S 或 UASTC 编码,运行时由转码器按设备能力选择 ASTC、ETC2、BC 等 GPU 格式。文件缩小比例不等于显存缩小比例;实际显存取决于最终 GPU 格式、尺寸、mipmap 和设备支持情况。

ETC1S 通常使文件更小,适合基础色和发光贴图;UASTC 往往保留更多细节,更适合容易出现块状伪影的法线、粗糙度和金属度数据贴图。二者都仍需要设备端转码,不是把 PNG 改扩展名即可。
离线转换带贴图的 GLB
示例采用 Node.js 22+、Vite、Three.js addons 导入路径及 glTF-Transform CLI 4.5。先准备一份确实包含 PNG/JPEG 纹理的 character.glb。安装 KTX-Software 4.4 或更新版本,并保证 ktx 命令可在终端使用;glTF-Transform 4.5 调用的是 ktx 命令,部分旧教程写的 toktx 不适用于这套版本。
先创建项目并复制与已安装 Three.js 同版本的转码器文件:
npm create vite@latest ktx2-demo -- --template vanilla
cd ktx2-demo
npm install
npm install three
npm install -D @gltf-transform/cli
node -e "require('node:fs').cpSync('node_modules/three/examples/jsm/libs/basis','public/basis',{recursive:true})"预期结果:public/basis/ 下包含 basis_transcoder.js 与 basis_transcoder.wasm 等文件。将自己的源模型放入 public/models/character.glb;该 GLB 是读者准备的输入资产,并非上述命令自动生成。
先对法线和 ORM 贴图使用 UASTC,再对剩余 PNG/JPEG 贴图使用 ETC1S:
ktx --version
npx gltf-transform uastc public/models/character.glb public/models/character-data.glb --level 2 --slots "{normalTexture,occlusionTexture,metallicRoughnessTexture}"
npx gltf-transform etc1s public/models/character-data.glb public/models/character-ktx2.glb --quality 128
npx gltf-transform inspect public/models/character-ktx2.glb --format md预期结果:首条命令显示实际安装的 KTX-Software 版本,随后生成 character-ktx2.glb;检查报告中的纹理应显示 KTX2 类型。--slots 仅选择数据贴图,第二次转换会处理剩余可转换的常规纹理;如果模型没有这些数据贴图,第一步可能不产生纹理改动。文件大小和编码日志由输入模型决定,不应期待固定数值。
让 GLTFLoader 使用转码器
用以下内容替换 Vite 项目的 src/main.js。setTranscoderPath('/basis/') 指向静态发布目录,detectSupport(renderer) 必须在加载 KTX2 之前执行。示例用查询参数切换原版和压缩版,以便在相同环境下观察效果。
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';
document.body.style.margin = '0';
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(window.innerWidth, window.innerHeight);
document.querySelector('#app').replaceChildren(renderer.domElement);
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf5f7f9);
scene.add(new THREE.HemisphereLight(0xffffff, 0x667788, 3));
const light = new THREE.DirectionalLight(0xffffff, 2);
light.position.set(3, 5, 4);
scene.add(light);
const camera = new THREE.PerspectiveCamera(45, innerWidth / innerHeight, 0.1, 1000);
// 先检测硬件格式,再将同一个 KTX2Loader 交给 GLTFLoader。
const ktx2 = new KTX2Loader().setTranscoderPath('/basis/').detectSupport(renderer);
const loader = new GLTFLoader().setKTX2Loader(ktx2);
const modelPath = new URLSearchParams(location.search).has('original')
? '/models/character.glb' : '/models/character-ktx2.glb';
async function main() {
const gltf = await loader.loadAsync(modelPath);
scene.add(gltf.scene);
const box = new THREE.Box3().setFromObject(gltf.scene);
const center = box.getCenter(new THREE.Vector3());
const extent = box.getSize(new THREE.Vector3()).length();
gltf.scene.position.sub(center);
const distance = Math.max(extent, 1) * 1.6;
camera.position.set(distance * 0.3, distance * 0.2, distance);
camera.lookAt(0, 0, 0);
camera.far = distance * 10;
camera.updateProjectionMatrix();
// 对材质引用的压缩纹理去重统计,不把数量误当显存字节数。
const textures = new Set();
gltf.scene.traverse((obj) => {
if (!obj.isMesh) return;
for (const mat of Array.isArray(obj.material) ? obj.material : [obj.material]) {
if (!mat) continue;
for (const value of Object.values(mat)) {
if (value?.isCompressedTexture) textures.add(value);
}
}
});
console.log('GLB:', modelPath, '压缩纹理数:', textures.size);
}
renderer.setAnimationLoop(() => renderer.render(scene, camera));
main().catch(console.error);
window.addEventListener('resize', () => {
camera.aspect = innerWidth / innerHeight;
camera.updateProjectionMatrix();
renderer.setSize(innerWidth, innerHeight);
});预期结果:浏览器画面显示模型;默认打开压缩版时,在支持 GPU 压缩格式的设备上,控制台“压缩纹理数”通常大于 0;加上 ?original=1 打开原版时应为 0。不支持块压缩的设备可能回退到非压缩纹理,此时数量也可能是 0。
运行开发服务器:
npm run dev预期结果:终端打印 Vite 的本地访问地址,实际端口可能不同;打开该地址即可测试,不需要额外手写纹理加载代码。
验收体积、画质和显存
| 检查项 | 操作与判断 |
|---|---|
| 下载体积 | 对比两个 GLB 的文件字节数,并在浏览器 Network 面板比较传输大小;不要把压缩比当作显存比。 |
| 视觉质量 | 固定相机、画布尺寸和设备,对比人物轮廓、面部细节、透明边缘、法线与 ORM 高光;明显色带或块状伪影应调整编码。 |
| GPU 占用 | 使用 gltf-transform inspect 查看纹理的 GPU 占用估算,再以 GPU 调试或分析工具核对目标设备实际转码格式;分别记录 ASTC、ETC2 或 BC 的结果。 |
| 加载耗时 | 在 Network 和 Performance 中对比下载与转码耗时;首次转码会消耗 CPU 与 Worker 资源,文件更小不代表首帧必然更快。 |
出错时检查这些位置
- 终端提示找不到
ktx:检查 KTX-Software 版本和系统PATH;仅安装 npm CLI 不会自动提供编码器。 - 浏览器请求
/basis/basis_transcoder.wasm返回 404:确认复制了node_modules/three/examples/jsm/libs/basis的文件,并且setTranscoderPath以/basis/结尾。 - 报错缺少 KTX2Loader 或未检测支持格式:确认在
loadAsync前依次调用detectSupport(renderer)和setKTX2Loader(ktx2)。 - 细密法线产生色块:优先保持 UASTC,或者先用
inspect查纹理槽位,再只调整问题贴图;不要为了缩小几百 KB 牺牲近景质量。
上线前至少在一台桌面设备和一台移动设备上比较结果。KTX2 优先解决纹理传输与显存压力;若瓶颈来自过多 draw call 或蒙皮计算,单靠纹理压缩不能解决帧率问题。