素材阁

Three.js 速查

共 24 条 Three.js 常用 API,涵盖最小场景、几何与材质、光照与变换、资源加载、交互与工具。 支持搜索与分类筛选,点击即可复制。

最小场景

场景-相机-渲染器三件套。

命令说明
场景
透视相机
渲染器
挂载画布
渲染循环

几何与材质

Mesh = 几何 + 材质。

命令说明
立方体几何
球体
标准材质
物理材质
组合并加入场景

光照与变换

让画面立体起来。

命令说明
环境光
平行光(含阴影)
阴影
位姿与缩放
分组

资源加载

模型与贴图。

命令说明
加载贴图
加载 glTF/GLB 模型
动画播放
进度管理

交互与工具

相机控制与拾取。

命令说明
轨道控制器
鼠标拾取
适配高 DPI
响应式
颜色空间正确显示

使用说明

Three.js 常用 API 速查:最小场景、几何与材质、光照与变换、资源加载、交互与工具;支持搜索与分类筛选,点击即可复制。

  1. 按用途点分类:最小场景、几何与材质、光照与变换、资源加载、交互与工具。
  2. 点「API」列复制,替换尺寸、坐标与路径后使用。
  3. 渲染循环用 renderer.setAnimationLoop,容器尺寸变化时记得 setSize 与 camera.aspect 更新。
  4. 加载模型优先用 GLTF/GLB,纹理设 colorSpace 为 sRGB 避免偏色。

常见问题

为什么画面是黑的?
常见原因是没加光源(MeshStandardMaterial 需要光照)或相机没看向物体;先加 AmbientLight 与 DirectionalLight,并确认物体在相机视锥内。
OrbitControls 从哪导入?
新版从 three/addons/controls/OrbitControls.js 导入;旧版为 examples/js。需把 controls.update() 放进渲染循环以获得阻尼效果。
高 DPI 屏上画面发虚怎么办?
设置 renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2)),上限取 2 可兼顾清晰度与性能。

延伸阅读

相关工具