Points Editor (PointsEditor) - ComfyUI-KJNodes

Points Editor ノードは、2種類の座標点タイプ（ポジティブとネガティブ）と2種類のバウンディングボックス形式（xyxy と xywh）をサポートします。

Points Editor は、画像上でインタラクティブに座標点を作成・編集するためのグラフィカルツールノードです。ユーザーはクリック操作で関心領域をマークし、対応する座標データを生成することができ、後続の画像処理ステップに正確な位置情報を提供します。

インタラクティブコントロール

Shift + クリック でポジティブ（緑色）点を追加します。
Shift + 右クリック でネガティブ（赤色）点を追加します。
点を右クリック で削除します。
Ctrl + クリック でバウンディングボックスを描画します。
バウンディングボックスの角をドラッグ でリサイズ、内部をドラッグ で移動します。
バウンディングボックスを右クリック で削除します。
画像を追加するには、ノードを選択し、画像をコピー＆ペーストまたはドラッグするか、bg_image 入力（バッチの最初のフレーム）から指定します。

ノード機能

このノードは、2種類の座標点タイプ（ポジティブとネガティブ）と2種類のバウンディングボックス形式（xyxy と xywh）をサポートします。その中核となるメカニズムは、組み込みのグラフィカルインターフェースを通じてユーザーのマウス操作を受け付け、クリック位置を座標データに変換し、これらのデータを文字列または構造化された形式（バウンディングボックス、マスクなど）で出力して、ワークフロー内の他のノードで使用できるようにすることです。

ノードパラメータ説明 - Points Editor

入力接続 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`bg_image`	IMAGE	いいえ	-	-	bg_image（入力パラメータ）：オプションのパラメータ。エディタに背景画像を読み込み、描画の参考として使用します。

コントロールパラメータ (Parameters)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`bbox_format`	COMBO	はい	xyxy	"xyxy", "xywh", ""	bbox_format（入力パラメータ）：バウンディングボックスの座標形式を選択します。オプションは「xyxy」（左上x, y, 右下x, y）または「xywh」（左上x, y, 幅, 高さ）です。
`points_store`	STRING	はい	-	-	points_store（入力パラメータ）：ポジティブ座標点データを内部で保存・管理するための文字列フィールドです。
`coordinates`	STRING	はい	-	-	coordinates（入力パラメータ）：既存のポジティブ座標点文字列を入力または受け取ります。通常の形式は「x1,y1;x2,y2」です。
`neg_coordinates`	STRING	はい	-	-	neg_coordinates（入力パラメータ）：既存のネガティブ座標点文字列を入力または受け取ります。通常の形式は「x1,y1;x2,y2」です。
`bbox_store`	STRING	はい	-	-	bbox_store（入力パラメータ）：バウンディングボックスデータを内部で保存・管理するための文字列フィールドです。
`bboxes`	STRING	はい	-	-	bboxes（入力パラメータ）：既存のバウンディングボックス座標文字列を入力または受け取ります。
`width`	INT	はい	512	8 - 4096 (ステップ: 8)	width（入力パラメータ）：エディタのキャンバスおよび出力座標の参照系の幅を定義します。範囲は8から4096で、調整ステップは8です。
`height`	INT	はい	512	8 - 4096 (ステップ: 8)	height（入力パラメータ）：エディタのキャンバスおよび出力座標の参照系の高さを定義します。範囲は8から4096で、調整ステップは8です。
`normalize`	BOOLEAN	はい	False	-	normalize（入力パラメータ）：出力座標値を0-1の範囲に正規化するかどうかを制御します。

出力 (Outputs)

パラメータ名	データ型	説明
positive_coords	STRING	positive_coords（出力パラメータ）：すべてのポジティブ（緑色）座標点を含む文字列を出力します。
negative_coords	STRING	negative_coords（出力パラメータ）：すべてのネガティブ（赤色）座標点を含む文字列を出力します。
bbox	BBOX	bbox（出力パラメータ）：ユーザーが描画したバウンディングボックスデータを出力します。
bbox_mask	MASK	bbox_mask（出力パラメータ）：バウンディングボックスに対応する白黒のマスク画像を出力します。
cropped_image	IMAGE	cropped_image（出力パラメータ）：バウンディングボックスに従って切り抜かれた画像領域を出力します。

使用シナリオ

画像のインペインティングやローカルリドローワークフローでは、このノードを使用して背景画像上で修正が必要な領域（ポジティブ点）と保護が必要な領域（ネガティブ点）を正確にマークできます。生成された座標とバウンディングボックスは、サンプラーやマスク処理ノードに直接接続して、AIが指定された領域のみを描画するように導くことができます。

注意事項

WORK IN PROGRESS: このノードをワークフローの一部としてまだ信頼しないでください。多くのバグが含まれている可能性があり、安定性は保証されません!! ノードに読み込まれた背景画像は、ノードとワークフローのメタデータに保存されます。画像を削除するには、キャンバス上で右クリックし、コンテキストメニューから「Clear Image」を選択します。

Points Editor ノードのソースコードリンク

Points Editor ノードは、ComfyUI-KJNodes ノードパッケージに含まれています。

Points Editor(PointsEditor)

Points Editor