用途:帮助在 Three.js 项目中构建或迁移到 WebGPURenderer,使用 TSL 节点材质,并实现 GPU 计算相关功能。
主要能力:覆盖 WebGPU 与 TSL 的使用指导,包括检查已安装的 Three.js 导出与对应渲染器/TSL 文档、列出所需功能与后端约束、按版本异步初始化、以节点/TSL 机制表达材质、移植自定义 GLSL 与着色器补丁、定义计算存储布局与调度同步、管理计算缓冲与渲染目标及设备丢失。
使用方式:先确认项目已安装版本与现有架构,使用项目锁定版本而非混用新版片段;遵循该版本的异步初始化约定,处理初始化失败与不支持设备并给出显式回退状态;保持导入与渲染器构建一致,避免重复类/模块实例;计算部分需定义存储布局、边界检查、调度尺寸、同步与回读频率,避免逐帧 CPU 回读。
适用场景:需要 WebGPU 渲染、TSL 节点材质或 GPU 计算的 Three.js 项目,以及从 WebGLRenderer 迁移的场景。
限制:WebGPURenderer 在支持时可使用 WebGL 后端,但后端选择不保证所有计算或效果在两者上都可用,需在实际选定的后端上测试;不要替换可正常工作的 WebGLRenderer,除非所需功能或迁移确有必要;自定义 GLSL、着色器补丁与合成器效果不会自动兼容,需有意移植;初始化失败后避免无界重试;需在目标 WebGPU 设备/浏览器及承诺的回退后端上分别验证并报告结果,浏览器暴露 navigator.gpu 并不代表场景渲染成功。官方文档不可用时,可检查已安装类型/源码并说明不确定性。