Web 图形与 3D / 系统课时

静态场景按需触发渲染

静态场景按需触发渲染

产品展示、地图浏览与静态编辑器在用户不操作时,无需每秒重复绘制相同画面。本课把 Three.js 的连续循环改为事件驱动:只在视口、相机、场景内容或资源发生变化时申请一帧,并验证页面空闲后不再持续渲染。

学习目标

  • 列出初始化、视口变化、控件操作及资源加载完成后的重绘条件。
  • 使用单一请求入口合并重复事件,避免静止场景持续调用渲染器。
  • 通过控制台计数与交互检查按需渲染是否生效。

确定哪些变化需要重绘

renderer.render(scene, camera) 只绘制调用时的场景状态。修改材质、模型或相机不会自动更新屏幕,所以必须由业务在变化后明确请求重绘;页面首次显示也要主动请求一次。

变化来源 触发时机 处理动作
页面初始化 场景与相机创建完成 请求首帧
相机控件 OrbitControls 发出 change 请求更新后的画面
视口大小 浏览器触发 resize 更新画布尺寸与相机宽高比
异步资源 TextureLoader 的 onLoad 回调 应用纹理后请求重绘
自定义操作 按钮修改材质或物体参数 修改数据后请求重绘

同一次拖动或窗口缩放可能在一帧内触发多个事件。若每个事件都独立提交渲染,会产生重复工作;用“是否已有待执行帧”作为闸门,让多个变化合并为一次 requestAnimationFrame。

多路事件合并为单次渲染的按需调度流程

实现单帧调度

使用 Node.js 22.12+ 与 npm 创建 Vite 原生 JavaScript 项目,并安装 three。下列命令从一个可写工作目录执行:

bash
npm create vite@latest demand-render -- --template vanilla
cd demand-render
npm install
npm install three
npm run dev

预期结果:终端显示 Vite 开发服务器已启动及本地访问地址;实际端口可能不同。保留项目默认的 index.html 和 #app 容器,把 src/main.js 完整替换为以下代码:

js
import * as THREE from 'three';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';

const root = document.querySelector('#app');
document.body.style.margin = '0';
root.style.cssText = 'width:100vw;height:100vh;overflow:hidden';

const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.domElement.style.cssText = 'width:100%;height:100%;display:block';
root.replaceChildren(renderer.domElement);

const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf5f7fa);
const camera = new THREE.PerspectiveCamera(50, 1, 0.1, 100);
camera.position.set(3, 2, 5);

const cube = new THREE.Mesh(
  new THREE.BoxGeometry(2, 2, 2),
  new THREE.MeshBasicMaterial({ color: 0xffffff })
);
scene.add(cube);

const controls = new OrbitControls(camera, renderer.domElement);
controls.enableDamping = false;
controls.autoRotate = false;
controls.update();

let frameId = null;
let lastWidth = 0;
let lastHeight = 0;

function render() {
  frameId = null; // 已消费排队的帧,允许后续变化再次申请
  const width = root.clientWidth;
  const height = root.clientHeight;
  if (width === 0 || height === 0) return;

  if (width !== lastWidth || height !== lastHeight) {
    renderer.setSize(width, height, false);
    camera.aspect = width / height;
    camera.updateProjectionMatrix();
    lastWidth = width;
    lastHeight = height;
  }

  renderer.render(scene, camera);
  console.count('实际渲染');
}

function requestRender() {
  if (frameId !== null) return; // 合并同一帧到来的多个请求
  frameId = requestAnimationFrame(render);
}

controls.addEventListener('change', requestRender);
window.addEventListener('resize', requestRender);

const button = document.createElement('button');
button.textContent = '切换色调';
button.style.cssText = 'position:fixed;top:16px;left:16px;z-index:1;padding:8px 12px';
document.body.append(button);
let warm = false;
button.addEventListener('click', () => {
  warm = !warm;
  cube.material.color.set(warm ? 0xffc38a : 0xffffff);
  requestRender();
});

// 内嵌 SVG 充当异步加载资源,示例无需额外图片文件。
const svg = [
  '<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64">',
  '<rect width="64" height="64" fill="#2e8a9e"/>',
  '<circle cx="32" cy="32" r="18" fill="#ffdf89"/>',
  '</svg>'
].join('');
const textureUrl = 'data:image/svg+xml,' + encodeURIComponent(svg);
new THREE.TextureLoader().load(textureUrl, (texture) => {
  texture.colorSpace = THREE.SRGBColorSpace;
  cube.material.map = texture;
  cube.material.needsUpdate = true; // 从纯色材质切换为带贴图材质
  requestRender();
}, undefined, (error) => console.error('纹理加载失败', error));

requestRender(); // 首帧;若纹理已完成加载,请求仍会合并

预期结果:页面显示带圆形图案纹理的立方体,可拖动旋转、滚轮缩放;左上角按钮可改变色调。控制台显示“实际渲染”的累计调用次数。首帧与资源回调是否合并取决于加载时机,不能要求固定的初始次数。

检查空闲时是否停止

  1. 打开浏览器 DevTools 的 Console,刷新页面,确认至少出现一次“实际渲染”计数。
  2. 松开鼠标并保持页面静止 5 秒;计数应停止增长,不会每秒增加约 60 次。
  3. 拖动、滚轮缩放相机,再停止操作;交互期间计数增加,停止后保持不变。
  4. 调整浏览器窗口,检查立方体不被拉伸且计数增加;点击“切换色调”,确认颜色立即变化。
  5. 在 TextureLoader 回调处设置断点,确认纹理完成加载后执行 requestRender();若与首帧合并,只增加一次绘制也属于正确结果。

这段代码没有在 render() 末尾再次调用 requestAnimationFrame()。frameId 是排队状态而非动画开关;仅有事件触发时才安排下一帧。生产性能采样前可移除 console.count(),避免控制台日志影响测量。

识别按需渲染的边界

示例刻意关闭 OrbitControls.enableDamping 和 autoRotate。若启用阻尼,必须在惯性尚未结束时逐帧调用 controls.update() 并渲染;若开启自动旋转,也需要持续更新,不能直接沿用当前的单帧策略。

对于角色骨骼动画、粒子、视频纹理或持续变化的着色器时间参数,应在活动期间使用连续渲染,暂停后再切回事件触发。若容器尺寸能在窗口未缩放时改变,还应使用 ResizeObserver 监听容器尺寸,而不能只依赖 window.resize。按需渲染减少空闲绘制次数,但不会自动释放几何体、材质与纹理所占的 GPU 资源。

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

目录与阅读设置

阅读设置

17

记录一个想法

静态场景按需触发渲染

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

登录哪都通