CloserAI Relight Control插件节点说明文档

简介 (Introduction)

CloserAI Relight Control 是一款专为 ComfyUI 设计的交互式灯光控制插件。它提供了一个直观的 3D/2D 混合可视化界面，允许用户通过简单的拖拽和点击，精确控制生成图像中的光影效果。

该插件的核心价值在于能够将可视化设置的灯光参数，实时转义为精准的自然语言描述（提示词），极大地提升了 AI 图像生成过程中对光效控制的可预测性和便捷性。

主要特性 (Main Features)

• 2D 平面辅助
  提供 2D 正/背视切换功能，适合快速直观地调整灯光方位。
• 多维度参数调节
  • 方位角 (Azimuth)： 0∘−360∘0∘−360∘ 水平旋转。
  • 仰角 (Elevation)： −90∘−90∘−90∘−90∘ 垂直高度。
  • 光照类型： 支持 "柔光 (Soft)" 和 "硬光 (Hard)" 切换。
  • 亮度与颜色： 支持 0-100% 亮度滑动调节及十六进制 (Hex) 颜色选择。
• 实时提示词生成
  自动生成结构化的灯光描述 (Light Prompt) 与相机角度描述 (Camera Prompt)。
• 中英文支持
  界面显示及输出的提示词均支持中英文一键切换。
• 实时预览
  支持将节点输入图像嵌入 3D 控制区作为背景，便于参考和调整。

安装说明 (Installation)

1. 下载或克隆仓库
   将本插件文件夹放置在 ComfyUI 的 custom_nodes 目录下：
   ComfyUI/custom_nodes/closerai-relightcontrol/
2. 安装依赖
   本插件主要依赖 ComfyUI 原生环境，前端 3D 渲染组件已内置并自动加载，无需复杂配置。
3. 重启 ComfyUI
   启动后，在节点菜单中搜索 CloserAI 即可找到 CloserAI Relight Control 节点。

使用说明 (Usage Guide)

1. 节点接口

2. 控制区操作 (Control Area)

• 2D 模式交互
  • 在 2D 圆盘内直接点击或拖拽，光标位置即代表光线投射的方向。
  • 视角切换： 支持点击按钮在 "Front (正面前方)" 和 "Back (背面背后)" 视角间切换。
• 快速预设 (Presets)
  • 提供了 "顶部"、"底部"、"左侧"、"右后方" 等 12 个常用灯光方位 的快速切换按钮，点击即可一步到位。

3. 参数配置 (Parameters)

• Azimuth / Elevation
  既支持手动输入数值，也支持通过可视化拖拽自动更新。
• Light Type
  影响提示词中对光线硬度的描述（例如生成“高反差硬光”或“均匀柔光”）。
• Brightness
  滑动调节光照强度的百分比。
• Color
  设置光源颜色，该选项会同步影响 3D 预览中的光源色及输出的颜色描述。

注意事项 (Notes)

💡 使用建议

• 建议配合能够理解精准灯光描述的基座模型（如 SDXL, Flux 等）使用，效果更佳。
• 提示词描述会根据插件界面上所选的 language 自动切换，方便适配不同的 Prompt 习惯（中文/英文）。

Produced by CloserAI (公众号：产品经理逛世界)

主题授权提示：请在后台主题设置-主题授权-激活主题的正版授权，授权购买：RiTheme官网