用途:帮助创建简单、性能良好的 Three.js 网页应用,采用现代 ES 模块写法,覆盖场景搭建、光照、几何体、材质、动画与响应式渲染。
主要能力:提供最小 HTML 模板与场景、相机、渲染器初始化;内置几何体(Box、Sphere、Cylinder、Torus、Plane、Cone、Icosahedron)与材质选择指南(Basic、Standard、Physical、Normal、Phong);光照类型与阴影配置;动画循环(setAnimationLoop)、鼠标交互、OrbitControls;以及旋转立方体、粒子场、网格背景等常见场景模式。
参考文档:GLTF 模型加载与缓存(gltf-loading-guide.md)、参考坐标系契约(reference-frame-contract.md)、游戏模式(game-patterns.md)、进阶主题如后处理、着色器、物理与实例化(advanced-topics.md),以及 GLTF 校准辅助脚本说明(scripts/README.md)。
必要用法:通过 CDN 导入,例如 import * as THREE from 'https://unpkg.com/three@0.160.0/build/three.module.js';OrbitControls 从 examples/jsm/controls/OrbitControls.js 导入。创建网格后需 scene.add;动画用 renderer.setAnimationLoop;窗口缩放时更新相机 aspect 与渲染器尺寸;像素比建议 Math.min(window.devicePixelRatio, 2)。
限制与注意:资料强调 Three.js 为右手坐标系,+Y 向上、+Z 朝向相机;GLTF 模型默认朝向 -Z;相机有角度时原始 WASD 输入会方向错误,需按相机朝向计算移动方向。避免在动画循环中新建几何体、使用过多分段、遗漏 scene.add 等反模式。资料未提供收费、价格、平台支持范围与具体效果数据。