Web 图形与 3D / 系统课时

场景相机渲染器如何协作

场景相机渲染器如何协作

本课用一个持续旋转的立方体,把 Three.js 的 Scene、PerspectiveCamera 和 WebGLRenderer 串成可见的画面。完成后,你将知道物体由谁管理、观察角度由谁决定,以及最终如何绘制到页面的 Canvas。

学习目标

  • 区分场景、透视相机和渲染器的职责及调用关系。
  • 使用一个完整 HTML 页面绘制并旋转三维网格。
  • 检查空白画面和窗口缩放变形的常见原因。

三个对象各负责什么

Scene 保存要绘制的对象及其层级关系。本例把一个 Mesh 加入场景:它由 BoxGeometry 定义形状,由 MeshNormalMaterial 决定表面颜色。只创建网格、不调用 scene.add(cube),它不会出现在这次场景渲染中。

PerspectiveCamera 决定从哪里看、看到多宽,以及多远的物体允许进入画面。构造参数依次是垂直视角、宽高比、近裁剪距离、远裁剪距离;本例使用 60 度、窗口宽/窗口高、0.1、100。相机不负责输出像素,参数定义可查阅 PerspectiveCamera 文档。

WebGLRenderer 接收场景与相机,执行 renderer.render(scene, camera),通过 WebGL 将结果绘制到它管理的 canvas。renderer.domElement 就是这个画布,需要挂到网页 DOM 中。

Scene、Camera 和 Renderer 到 Canvas 的协作关系

写出最小可运行页面

新建 index.html 并复制以下完整内容。示例固定使用 three@0.186.1 的 ES Module,通过 import map 让浏览器识别 three;首次运行需要联网加载模块,浏览器需要支持 WebGL 2。选用 MeshNormalMaterial 是为了在不添加灯光时仍能看见立方体的表面。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Three.js 渲染闭环</title>
  <style>
    html, body { margin: 0; width: 100%; height: 100%; overflow: hidden; }
    canvas { display: block; }
  </style>
  <script type="importmap">
    {"imports": {"three": "https://cdn.jsdelivr.net/npm/three@0.186.1/build/three.module.js"}}
  </script>
</head>
<body>
  <script type="module">
    import * as THREE from 'three';

    const scene = new THREE.Scene();
    scene.background = new THREE.Color(0x101820);
    const camera = new THREE.PerspectiveCamera(
      60, window.innerWidth / window.innerHeight, 0.1, 100
    );
    camera.position.set(0, 0, 4);

    const renderer = new THREE.WebGLRenderer({ antialias: true });
    // 限制高分屏像素倍率,避免无谓增加绘制开销。
    renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
    renderer.setSize(window.innerWidth, window.innerHeight);
    document.body.appendChild(renderer.domElement);

    // 网格必须加入场景,材质无需额外灯光。
    const cube = new THREE.Mesh(
      new THREE.BoxGeometry(1.5, 1.5, 1.5),
      new THREE.MeshNormalMaterial()
    );
    scene.add(cube);

    renderer.setAnimationLoop((time) => {
      // time 以毫秒计,旋转角度使用弧度。
      cube.rotation.y = time * 0.001;
      cube.rotation.x = time * 0.0005;
      renderer.render(scene, camera);
    });

    window.addEventListener('resize', () => {
      // 相机投影和实际画布必须一起更新。
      camera.aspect = window.innerWidth / window.innerHeight;
      camera.updateProjectionMatrix();
      renderer.setSize(window.innerWidth, window.innerHeight);
    });
  </script>
</body>
</html>

预期结果:浏览器显示深色背景上的彩色立方体,并持续绕两个轴旋转;调整窗口大小时,画布保持铺满窗口,立方体不会因宽高比变化而被拉伸。旋转速度会随时间均匀变化,而不是依赖显示器每秒刷新多少次。

启动服务并验证画面

在保存 index.html 的目录打开终端;安装了 Python 3 的系统可执行:

bash
python3 -m http.server 8000

预期结果:终端显示本地 HTTP 服务正在监听 8000 端口(具体提示文本因系统和 Python 版本而异)。在浏览器访问 http://localhost:8000/,应出现前述旋转立方体;结束服务可在终端按 Ctrl+C。不要以直接双击文件、使用 file:// 的方式作为后续模块和资源加载的标准流程。

此时每帧的顺序是:动画回调先改变 cube.rotation,渲染器随后读取场景里的网格及相机的投影、视图信息,最后更新 Canvas 像素。setAnimationLoop 会安排后续帧,但场景和相机本身不会自动绘图。相机位于 (0, 0, 4),默认朝向负 Z 轴;把相机的 Z 坐标临时改为 8,立方体会看起来更小。

根据症状定位问题

  • 只看见背景:确认存在 scene.add(cube);相机是否朝向原点;近、远裁剪距离是否满足 0 < near < far。若把相机移到 (0, 0, -4) 且不改变朝向,原点就在相机背后。
  • 页面全空或控制台报模块加载错误:打开开发者工具的 Console 和 Network,检查 CDN 是否加载成功,并确认通过 http://localhost:8000/ 而非本地文件访问。
  • 画面在缩放后变形或留白:检查 camera.aspect、camera.updateProjectionMatrix() 和 renderer.setSize() 是否都在 resize 回调中执行。
  • 换材质后立方体变黑:若改用 MeshStandardMaterial,需要在场景中添加有效灯光;当前使用的 MeshNormalMaterial 不依赖灯光。

最终可以用一个可操作的检查区分职责:暂时移除 scene.add(cube),画布仍会绘制背景,但立方体消失;恢复网格后若停止调用 renderer.render(scene, camera),后续帧就不会更新。这两个现象分别验证了场景负责组织对象和渲染器负责提交画面。

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

目录与阅读设置

阅读设置

17

记录一个想法

场景相机渲染器如何协作

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

登录哪都通