SuperAPI AI 工具集

threejs-fundamentals

测试与质量

查看项目

更新于 10-15 19:53

技能介绍

用途:用于通用 Three.js 网页体验的渲染基础搭建与修复,包括场景、相机、渲染器、canvas 归属与动画循环;也可用于选择透视或正交投影、修正世界/局部变换、处理高 DPI 与色彩管理,以及诊断空白场景、内容裁剪、取景错误与 GPU 资源泄漏。若涉及可玩游戏系统、生命周期或发布,应改用 web-game-development;具体渲染领域使用对应的 threejs-* 技能。

主要能力与用法:先确认已安装的 three 版本、既有渲染器与 canvas 归属,保持渲染循环和 resize 监听只有一个归属者(React Three Fiber 等封装已接管时不要另加原生循环);默认使用 WebGLRenderer,WebGPU 模式需核对所用 Three.js 版本。先构建最小可见场景:显式 scene、camera、renderer、一个受光网格和渲染循环,再叠加加载器、着色器或后处理。用 Group 作为功能变换根;未渲染前查询世界坐标需调用 updateWorldMatrix。resize 时更新 camera.aspect 并调用 updateProjectionMatrix(),renderer.setSize(width, height, false) 可用原样示例:camera.aspect = width / height; camera.updateProjectionMatrix(); renderer.setSize(width, height, false);。释放时遍历对象,调用 geometry?.dispose() 与 material?.dispose(),并释放该功能拥有的纹理和渲染目标,共享资源需等所有使用方结束。

限制与注意:像素比应设上限,避免无界 devicePixelRatio 导致的 GPU 开销;裁剪面尽量收紧;每个功能拥有的 GPU 分配都要配套清理路径。资料未提供具体收费、价格、平台或效果数据。适配场景包括产品透视视图、等距棋盘视图等;验证需确认目标 canvas 尺寸下网格可见与取景稳定,覆盖窄、宽和高 DPI 情形,检查控制台 WebGL 警告,并运行仓库已有的构建、类型检查与视觉/浏览器测试。