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 等目标格式;首次加载因此可能增加解码器下载、转码和上传等待。具体目标格式依设备而定。

PNG 与 KTX2 从下载到 GPU 上传的差异

准备 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 转码器作为静态文件发布。

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

bash
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,避免灯光差异干扰比较。

js
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 压缩纹理,而不是简单检查文件后缀。

运行并比较三类成本

在项目根目录运行:

bash
npm run dev

预期结果:终端显示可访问的 Vite 本地地址,端口以实际输出为准;在浏览器打开页面后,左边出现 PNG 贴图,右边出现 KTX2 贴图,Console 至少出现:

text
对照画面已渲染

Console 还会列出两条纹理的实际 loadMs、gpuCompressed 和 estimatedGpuMiB;后者为像素数据估算,不等于显卡任务管理器中的实际显存占用。按同一浏览器、设备和网络条件执行下列检查:

  1. 在 DevTools 的 Network 面板启用 Disable cache,比较 albedo.png、albedo.ktx2 的传输字节;冷启动时把 basis_transcoder.wasm 的额外请求单独记账。
  2. 比较 Console 的 loadMs,分别重复冷缓存和热缓存测试,每种至少运行 5 次取中位数;不要拿首次 WASM 初始化时间冒充每张纹理的恒定开销。
  3. 查看 estimatedGpuMiB:本例的 PNG 约 5.33 MiB,KTX2 依据实际转码后各 mipmap 的字节数求和;若显示“非压缩回退”,则未获得预期 GPU 压缩收益。renderer.info.memory.textures 只能统计纹理数量。
  4. 在相同尺寸下观察渐变、细线、文字边缘及透明边界;需要时放大到接近 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 文档。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 KTX2 降低纹理内存压力

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

登录哪都通