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 和设备支持情况。

KTX2 离线编码与运行时转码的数据流

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 同版本的转码器文件:

bash
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:

bash
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 之前执行。示例用查询参数切换原版和压缩版,以便在相同环境下观察效果。

js
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。

运行开发服务器:

bash
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 或蒙皮计算,单靠纹理压缩不能解决帧率问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 KTX2 降低纹理显存占用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通