概要

ComfyUI-qwenmultianglelight は、ComfyUI 用のカスタムノードセットで、主に画像の再ライティング（relighting）を支援するための 3D ライティング制御機能を持ちます。Three.js ベースの小さなビューポートを内蔵し、ユーザーはライトの方位（角度）、仰角（高さ）、強度、色を視覚的に操作できます。操作結果は ComfyUI のワークフローで使えるように、整形済みのプロンプト文字列（例：“Light from 45° azimuth, 30° elevation, intensity …”）として出力されます。シンプルな UI とノード統合により、手早くライティング条件を試行しながら画像生成パラメータを生成・適用できる点が利点です。

リポジトリの統計情報

スター数: 22
フォーク数: 2
ウォッチャー数: 22
コミット数: 6
ファイル数: 8
メインの言語: JavaScript

主な特徴

インタラクティブな 3D ライティング制御（Three.js ビューポートでドラッグ操作）
ライトの方位（azimuth）・仰角（elevation）・強度・色を調整可能
調整結果を ComfyUI 用のプロンプト文字列としてフォーマットして出力
ComfyUI のワークフローに簡単に統合できるカスタムノード構成

技術的なポイント

このプロジェクトは ComfyUI 用のカスタムノードとして実装され、フロントエンドに Three.js を利用して 3D 表示とインタラクションを提供する点が最大の技術的特徴です。Three.js 側では光源ハンドル（ドラッグで角度・高さを変更）やシーン表示を軽量に実装し、ユーザー操作を角度・強度・色の数値に変換します。変換されたパラメータは文字列テンプレートに埋め込まれ、ComfyUI 側のノード出力として供給されます。これにより、画像再生成時に「どの方向から光が当たっているか」といった情報をテキストプロンプトに組み込めます。

ComfyUI ノードの登録・管理は Python 側（init.py 等）で行われ、JavaScript/Three.js の表示コンポーネントとはデータのやり取り（角度や色のシリアライズ）を行います。リポジトリはファイル数が小さく、サンプルワークフロー（example_workflows）を同梱しているため、導入後にすぐに既存パイプラインで試せる点も実用的です。ライティング操作は視覚的で直感的なため、テキストだけでは伝わりにくい光源条件を手早く決められ、複数角度のライティングを連続して比較するようなワークフローにも向きます。また、出力されるプロンプト文字列はカスタマイズ可能で、モデルごとのプロンプト設計に合わせて書式を変えることも想定されています。将来的には複数ライトの同時操作や、光源の形状・スペクトルを詳細制御する拡張も可能な設計になっています。

プロジェクトの構成

主要なファイルとディレクトリ：

.gitignore: file（不要ファイルや環境依存ファイルの除外設定）
LICENSE: file（ライセンス情報）
README.md: file（使い方、機能説明、スクリーンショット等）
init.py: file（ComfyUI ノードの登録やエントリポイント）
example_workflows: dir（サンプルワークフローを収めたディレクトリ）
img.png: file（プレビュー画像）
package.json: file（依存やスクリプト。Three.js 等のフロントエンド依存を管理）
frontend.js: file（Three.js ビューポートや UI イベントを実装）

…他 3 ファイル

使い方（簡易）

リポジトリを ComfyUI のカスタムノードフォルダに配置またはクローンします。
ComfyUI を再起動してノード一覧から QwenMultiangleLight ノードを追加します。
ノードをワークフローに配置し、プレビュー領域でライトハンドルをドラッグして角度・色・強度を調整します。
出力されたプロンプト文字列をそのまま次段のテキストプロンプトノードに接続して使用します。

まとめ

視覚的にライト条件を設定でき、ComfyUI に簡単に統合できる実用的なカスタムノード群です（導入が容易で実験に向く）。

リポジトリ情報：

名前: ComfyUI-qwenmultianglelight
説明: qwenmultianglelight
スター数: 22
言語: JavaScript
URL: https://github.com/wallen0322/ComfyUI-qwenmultianglelight
オーナー: wallen0322
アバター: https://avatars.githubusercontent.com/u/204548567?v=4

READMEの抜粋：

ComfyUI-QwenMultiangle Lightning

Authors / 作者: aiwood & wallen

English | 中文

English

A ComfyUI custom node for 3D lighting angle control. Provides an interactive Three.js viewport to adjust light direction, elevation, intensity and color, outputs formatted prompt strings for relighting image generation.

preview