几何体 · Geometry · ▶ 在线运行案例

几何体

你将学到什么

  • Three.js 常用 内置几何体 及构造参数
  • 多个 Mesh 共享同一 Material、不同 Geometry 的用法
  • OrbitControls 配合 change 事件的手动渲染模式

效果说明

场景中沿 Z 轴排列五个红色物体：长方体、球体、圆柱、矩形平面、圆形平面。可通过鼠标旋转观察各形状差异。

核心概念

Geometry 只描述形状（顶点、面、UV），不包含颜色或纹理。外观由 Material 决定。

几何体 构造参数 说明
BoxGeometry(w,h,d) 宽高深 六面体
SphereGeometry(r, wSeg, hSeg) 半径、经纬分段 球体，分段越高越圆
CylinderGeometry(rTop,rBot,h, radialSeg) 上下半径、高度 圆柱/圆台
PlaneGeometry(w, h, wSeg, hSeg) 宽高、细分 默认 XY 平面
CircleGeometry(r, segments) 半径、分段 圆形面片

多个 mesh 可以 共用同一个 material 实例（节省 GPU 状态切换），但 geometry 通常各自独立。

实现步骤

  1. 创建 5 种 Geometry，各自对应一个 Mesh
  2. 沿 Z 轴 position.set(0, 0, n*30) 错开排列
  3. 添加 OrbitControls，change 时手动 render（本案例未开 rAF 循环）

代码要点


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

// 场景
const scene = new THREE.Scene();// 创建场景
//BoxGeometry：长方体
const geometry1 = new THREE.BoxGeometry(10, 10, 10);
// SphereGeometry：球体
const geometry2 = new THREE.SphereGeometry(10);
// CylinderGeometry：圆柱
const geometry3 = new THREE.CylinderGeometry(10, 10, 100);
// PlaneGeometry：矩形平面
const geometry4 = new THREE.PlaneGeometry(10, 50);
// CircleGeometry：圆形平面
const geometry5 = new THREE.CircleGeometry(10);

const material = new THREE.MeshBasicMaterial({ color: 0xff0000 }); //材质 

const mesh1 = new THREE.Mesh(geometry1, material);
mesh1.position.set(0, 0, 0);
const mesh2 = new THREE.Mesh(geometry2, material);
mesh2.position.set(0, 0, 30);
const mesh3 = new THREE.Mesh(geometry3, material);
mesh3.position.set(0, 0, 60);
const mesh4 = new THREE.Mesh(geometry4, material);
mesh4.position.set(0, 0, 90);
const mesh5 = new THREE.Mesh(geometry5, material);
mesh5.position.set(0, 0, 120);

scene.add(mesh1);
scene.add(mesh2);
scene.add(mesh3);
scene.add(mesh4);
scene.add(mesh5);

// AxesHelper
const axesHelper = new THREE.AxesHelper(150);
scene.add(axesHelper);

// 相机
const camera = new THREE.PerspectiveCamera();  //相机
camera.position.set(400, 300, 500); //相机位置
camera.lookAt(0, 50, 40);   //相机观察位置

// 渲染器
const renderer = new THREE.WebGLRenderer(); // 创建渲染器
const box = document.getElementById('box');
renderer.setSize(box.clientWidth, box.clientHeight); //渲染区域
renderer.render(scene, camera); //执行渲染
box.appendChild(renderer.domElement);;


// 设置相机控件轨道控制器OrbitControls
const controls = new OrbitControls(camera, renderer.domElement);
// 如果OrbitControls改变了相机参数，重新调用渲染器渲染三维场景
controls.addEventListener('change', function () {
        renderer.render(scene, camera); //执行渲染操作
        console.log(camera.position)
});//监听鼠标、键盘事件

完整源码：GitHub

小结