Add Label (AddLabel) - ComfyUI-KJNodes

技術的な実装の観点から見ると、Add LabelノードはPILライブラリを使用して画像処理とテキストレンダリングを行います。

Add Labelノードは画像注釈ツールであり、入力画像にカスタムテキストを含むラベルバーを追加することができます。このノードのコア機能は、テキスト付きの背景領域を生成し、それを元の画像と連結または重ね合わせることで、画像に説明文を追加することです。

ノード機能

技術的な実装の観点から見ると、このノードはPILライブラリを使用して画像処理とテキストレンダリングを行います。ラベルバーを画像の端に「上、下、左、右」の4方向で連結するか、または「オーバーレイ」モードで画像上に直接重ねることをサポートしています。ノードは指定されたフォントフォルダ（通常は ComfyUI/custom_nodes/ComfyUI-KJNodes/fonts）からフォントファイルを読み込み、ユーザーがカラー文字列（例："white"、"#FF0000"）を通じて文字とラベル背景の色を定義できるようにします。

ノードパラメータ説明 - Add Label

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`image`	IMAGE	はい	-	-	image（入力パラメータ）：ラベルを追加する元の画像を入力します。
`font`	COMBO	はい	-	(利用可能なフォントのリスト)	font（入力パラメータ）：テキストレンダリングに使用するフォントファイルを選択します。フォントファイルは指定された `kjnodes_fonts` ディレクトリに配置する必要があります。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`direction`	COMBO	はい	up	"up", "down", "left", "right", "overlay"	`down`（下方）、`left`（左側）、`right`（右側）、または `overlay`（画像上に直接オーバーレイ）のいずれか。
`text_x`	INT	はい	10	0 - 4096 (ステップ: 1)	text_x（入力パラメータ）：ラベルバー内でのラベルテキストの水平方向開始位置（X座標）を設定します。範囲は 0 から 4096 です。
`text_y`	INT	はい	2	0 - 4096 (ステップ: 1)	text_y（入力パラメータ）：ラベルバー内でのラベルテキストの垂直方向開始位置（Y座標）を設定します。範囲は 0 から 4096 です。
`height`	INT	はい	48	-1 - 4096 (ステップ: 1)	height（入力パラメータ）：ラベルバーの高さを設定します（方向が左または右の場合は、このパラメータが幅を制御します）。値が -1 の場合、高さはフォントサイズに自動的に調整されます。
`font_size`	INT	はい	32	0 - 4096 (ステップ: 1)	font_size（入力パラメータ）：ラベルテキストのフォントサイズを設定します。範囲は 0 から 4096 です。
`font_color`	STRING	はい	white	-	font_color（入力パラメータ）：ラベルテキストの色を定義します。色名（例："white"）または16進数カラーコード（例："#FF0000"）をサポートします。
`label_color`	STRING	はい	black	-	label_color（入力パラメータ）：ラベルバーの背景色を定義します。色名または16進数カラーコードをサポートします。
`text`	STRING	はい	Text	-	text（入力パラメータ）：ラベルバーに表示するテキスト内容を入力します。
`caption`	STRING	いいえ	""	-	caption（入力パラメータ）：オプションの追加キャプションテキスト。

出力

パラメータ名	データ型	説明
IMAGE	IMAGE	IMAGE（出力パラメータ）：テキストラベルが追加された画像を出力します。

使用シナリオ

画像のバッチ処理や生成ワークフローにおいて、このノードは非常に実用的です。例えば、一連のスタイルテスト画像を生成した後、このノードを使用して各画像に使用したパラメータ（モデル名、サンプリングステップ数など）を記述したラベルを自動的に追加し、後続の比較や選別を容易にすることができます。また、漫画のコマ割りやストーリーボード画像に台詞やシーケンス番号を追加するためにも使用できます。

注意事項

「上、下、左、右」の方向を選択した場合、この操作は出力画像のサイズ（高さまたは幅）を変更することに注意してください。また、フォントカラーとラベル背景色は複数の形式をサポートしていますが、入力された文字列が正しくRGBカラー値として解析できることを確認する必要があります。

Add Label ノードソースコードリンク

Add Label ノードは ComfyUI-KJNodes ノードパッケージに含まれています。

Add Label(AddLabel)

Add Label