Image Grab PIL (ImageGrabPIL) - ComfyUI-KJNodes

Image Grab PIL ノードはスクリーンキャプチャーツールで、コンピュータの画面上で指定した矩形領域を直接キャプチャし、その領域の画像を取得することができます。その中核機能は、画面の内容をリアルタイムで取得し、ComfyUI ワークフローで処理可能な画像データに変換することです。これにより、画面上のあらゆる視覚要素をAI画像処理のプロセスに素早く取り込むことが可能になります。

ノードの機能

このノードは、PythonのPIL（Pillow）ライブラリの ImageGrab.grab メソッドを基に実装されており、画面座標のバウンディングボックスを定義してピクセルをキャプチャします。キャプチャされた画像データは自動的にPyTorchテンソル形式に変換され、ComfyUIの IMAGE 型の標準に合わせて [0, 1] の浮動小数点範囲に正規化されます。さらに、このノードは複数フレームの連続キャプチャをサポートし、フレーム間に設定可能な遅延を挿入することができ、動的または変化する画面内容の録画の基礎を提供します。

ノードパラメータ説明 - Image Grab PIL

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`x`	INT	はい	0	0 - 4096 (ステップ: 1)	x（入力パラメータ）：キャプチャ領域の左上隅の水平座標（ピクセル単位）を定義します。範囲は0から4096、ステップは1です。
`y`	INT	はい	0	0 - 4096 (ステップ: 1)	y（入力パラメータ）：キャプチャ領域の左上隅の垂直座標（ピクセル単位）を定義します。範囲は0から4096、ステップは1です。
`width`	INT	はい	512	0 - 4096 (ステップ: 1)	width（入力パラメータ）：キャプチャ領域の幅（ピクセル単位）を定義します。範囲は0から4096、ステップは1です。
`height`	INT	はい	512	0 - 4096 (ステップ: 1)	height（入力パラメータ）：キャプチャ領域の高さ（ピクセル単位）を定義します。範囲は0から4096、ステップは1です。
`num_frames`	INT	はい	1	1 - 255 (ステップ: 1)	num_frames（入力パラメータ）：連続キャプチャするフレーム数を設定します。範囲は1から255、ステップは1です。
`delay`	FLOAT	はい	0.1	0.0 - 10.0 (ステップ: 0.01)	delay（入力パラメータ）：複数フレームを連続キャプチャする際の、フレーム間の待機時間（秒単位）を設定します。範囲は0.0から10.0、ステップは0.01です。

出力

パラメータ名	データ型	説明
image	IMAGE	image（出力パラメータ）：キャプチャした画面画像を出力します。形式はComfyUI標準の IMAGE 型（テンソル）です。

使用シナリオ

リアルタイム画像生成やスタイル転送のワークフローにおいて、このノードは非常に有用です。例えば、KSampler ノードと接続して「リアルタイム拡散」ループを作成することができます。まず、画面に描かれた絵やデザインのスケッチをキャプチャし、直ちに Stable Diffusion モデルに再描画やスタイル化を行わせ、結果を画面に出力することで、インタラクティブな創作ループを形成します。自動キュー機能と組み合わせることで、ほぼリアルタイムの連続処理を実現できます。

注意事項

このノードのキャプチャ範囲は、画面解像度の実際の制限を受けます。パラメータの上限は4096に設定されていますが、有効な領域は使用しているモニターの境界を超えてはなりません。複数フレームをキャプチャする際、短い遅延と高いフレーム数はシステム負荷を増加させる可能性があります。また、このノードは画面上で可視化されている内容のみをキャプチャでき、他のウィンドウで覆われていたり最小化されている領域はキャプチャできないことに注意してください。

Image Grab PIL ノードソースコードリンク

Image Grab PIL ノードは ComfyUI-KJNodes ノードパッケージに含まれています。

Image Grab PIL(ImageGrabPIL)

Image Grab PIL