关于 threejs-scenes
这是一个面向 three.js 开发者的场景 API 技能,聚焦 Scene、雾效和背景设置。它说明雾与相机远裁剪面的配合,并指引 HDR、纹理等相关主题查阅其他文档。
主要功能
- 01配置 Scene 与场景背景
- 02区分线性雾和指数雾
- 03协调雾距离与相机远平面
- 04说明背景、环境与渲染设置关系
- 05指引 HDR、加载器和纹理相关文档
适用场景
- 01为 three.js 场景设置背景
- 02调整雾效以匹配场景尺度
- 03排查雾效与相机裁剪问题
- 04从雾效设置转向 HDR 环境配置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ full-stack-skills/ threejs-skills --skill threejs-scenes安装后在 Claude Code 中输入/threejs-scenes确认已加载。
附带文件agents/openai.yamlexamples/workflow-fog-background.md
详细介绍
何时使用此技能
用户提到以下内容时,务必使用此技能:
- 以
Scene为根节点、scene.background、场景级环境或天空盒设置 Fog或FogExp2参数(near、far、color、密度)以及与相机远裁剪面的交互- 从概念上组织渲染列表(场景的子对象)
重要:场景、纹理与加载器
| 关注点 | 技能 |
|---|---|
| Scene + 雾 API | threejs-scenes |
| 纹理采样、PMREM 生成器的使用 | threejs-textures |
| 获取 HDR/glTF | threejs-loaders |
触发短语包括:
- “Scene”、“Fog”、“FogExp2”、“background”、“雾”
- “场景根节点”、“线性雾”、“指数雾”
如何使用此技能
- 按照图形规则(threejs-objects)实例化
Scene,并将灯光、网格和相机添加为子对象。 - 选择雾类型:线性
Fog或具有户外/地平线效果的指数FogExp2。 - 同时调整雾的
near/far和相机的far,以避免裁剪异常。 - 根据文档将
scene.background设为Color、Texture或立方体贴图;环境光照仍需要匹配的渲染器/材质设置。 - 如果用户想从 HDR 文件获取 IBL,请明确说明 loaders → textures → materials 流程。
- 说明雾不能替代用于提升性能的视锥体剔除。
参见 examples/workflow-fog-background.md。
文档索引(官方)
| 文档部分 | 代表性链接 |
|---|---|
| 场景 | https://threejs.org/docs/#Scenes |
| 场景 | https://threejs.org/docs/Scene.html |
| 雾 | https://threejs.org/docs/Fog.html |
| FogExp2 | https://threejs.org/docs/FogExp2.html |
范围
- 涵盖范围:
Scene、雾类型,以及 API 层面的背景字段语义。 - 不涵盖范围: HDR/glTF 文件获取(threejs-loaders);PMREM 和纹理采样(threejs-textures);色调映射/输出色彩空间默认值(threejs-renderers);全屏纯雾后期处理栈(threejs-postprocessing),除非与场景
Fog相关;核心雾 API 之外的自定义大气散射着色器。
常见问题与最佳实践
- 雾的颜色应与背景协调,以隐藏地平线接缝。
- 即使使用雾,相机的
far值很大时,也仍需确保场景比例一致。 background的旋转/强度功能取决于渲染器版本——请引用当前文档。
文档与版本
Scene、Fog 和背景字段记录在 three.js 文档的 Scenes 中。与环境相关的视觉效果通常会结合此技能与 threejs-textures(PMREM)和 threejs-loaders(HDR 文件)——当用户的话题从“雾的颜色”转向“HDR 天空”时,请链接这些页面。
Agent 回复检查清单
使用此技能作答时,建议:
- 链接
Scene、Fog或FogExp2的官方页面。 - 将雾距离与 threejs-camera 的
far远裁剪面及世界比例联系起来。 - 将 PMREM/HDR 文件相关步骤交由 threejs-textures/threejs-loaders 介绍,各用一句话说明。
- 避免重复讲解完整的色彩管理教程——请指向渲染器和纹理技能。
参考资料
- https://threejs.org/docs/Scene.html
- https://threejs.org/docs/Fog.html
- https://threejs.org/docs/FogExp2.html
关键词
英语: 场景、雾、fogexp2、背景、环境、three.js
中文: 场景、雾、Fog、背景、环境、three.js
评论
支持 Markdown