mcpField
T
threejs-scenes

threejs-scenes

github.com/full-stack-skills开发10384 次安装4 周前更新
代码仓库

关于 threejs-scenes

这是一个面向 three.js 开发者的场景 API 技能,聚焦 Scene、雾效和背景设置。它说明雾与相机远裁剪面的配合,并指引 HDR、纹理等相关主题查阅其他文档。

主要功能

  1. 01配置 Scene 与场景背景
  2. 02区分线性雾和指数雾
  3. 03协调雾距离与相机远平面
  4. 04说明背景、环境与渲染设置关系
  5. 05指引 HDR、加载器和纹理相关文档

适用场景

  1. 01为 three.js 场景设置背景
  2. 02调整雾效以匹配场景尺度
  3. 03排查雾效与相机裁剪问题
  4. 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 + 雾 APIthreejs-scenes
纹理采样、PMREM 生成器的使用threejs-textures
获取 HDR/glTFthreejs-loaders

触发短语包括:

  • “Scene”、“Fog”、“FogExp2”、“background”、“雾”
  • “场景根节点”、“线性雾”、“指数雾”

如何使用此技能

  1. 按照图形规则(threejs-objects)实例化 Scene,并将灯光、网格和相机添加为子对象。
  2. 选择雾类型:线性 Fog 或具有户外/地平线效果的指数 FogExp2。
  3. 同时调整雾的 near/far 和相机的 far,以避免裁剪异常。
  4. 根据文档将 scene.background 设为 Color、Texture 或立方体贴图;环境光照仍需要匹配的渲染器/材质设置。
  5. 如果用户想从 HDR 文件获取 IBL,请明确说明 loaders → textures → materials 流程。
  6. 说明雾不能替代用于提升性能的视锥体剔除。

参见 examples/workflow-fog-background.md。

文档索引(官方)

文档部分代表性链接
场景https://threejs.org/docs/#Scenes
场景https://threejs.org/docs/Scene.html
雾https://threejs.org/docs/Fog.html
FogExp2https://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 回复检查清单

使用此技能作答时,建议:

  1. 链接 Scene、Fog 或 FogExp2 的官方页面。
  2. 将雾距离与 threejs-camera 的 far 远裁剪面及世界比例联系起来。
  3. 将 PMREM/HDR 文件相关步骤交由 threejs-textures/threejs-loaders 介绍,各用一句话说明。
  4. 避免重复讲解完整的色彩管理教程——请指向渲染器和纹理技能。

参考资料

关键词

英语: 场景、雾、fogexp2、背景、环境、three.js

中文: 场景、雾、Fog、背景、环境、three.js

评论

支持 Markdown