ImageAndMaskPreview

ImageAndMaskPreview ノードは、SaveImage クラスを継承していますが、主な目的は永続的な保存ではなく、一時的なプレビュー画像を生成することです。

ImageAndMaskPreview ノードは、画像とマスクをプレビューするためのユーティリティツールです。その中核機能は、ユーザーが画像またはマスクを個別に表示したり、指定した色と透明度でマスクを画像の上に重ね合わせたりして、マスク領域を直感的に確認できるようにすることです。

ノード機能

このノードは SaveImage クラスを継承していますが、主な目的は永続的な保存ではなく、一時的なプレビューを生成することです。マスクの色を定義するための RGB タプル、RGBA タプル、16進数コードなど、複数の色形式をサポートしています。画像とマスクの両方が提供された場合、ノードは設定された不透明度と色でマスクを画像に合成します。どちらか一方のみが提供された場合は、その要素のプレビューを直接出力します。

ノードパラメータ説明 - ImageAndMaskPreview

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	値範囲/オプション	説明
`image`	IMAGE	いいえ	-	-	プレビューまたはマスク合成の対象となる画像（オプション）。
`mask`	MASK	いいえ	-	-	プレビューまたは画像に合成するマスク（オプション）。

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

パラメータ名	データ型	必須	デフォルト値	値範囲/オプション	説明
`mask_opacity`	FLOAT	はい	1.0	0.0 - 1.0 (ステップ: 0.01)	mask_opacity（入力パラメータ）：画像上に重ね合わせるマスクの全体的な不透明度を制御します。値範囲は 0.0（完全に透明）から 1.0（完全不透明）で、調整ステップは 0.01 です。
`mask_color`	STRING	はい	255, 255, 255	-	RGBA（例："255,255,255,128"）または16進数（例："#FF0000"）形式。
`pass_through`	BOOLEAN	はい	False	-	pass_through（入力パラメータ）：有効にすると、ノードはUIプレビューを無効にし、合成された画像データを出力ポートから直接渡します。

出力

パラメータ名	データ型	説明
composite	IMAGE	-

使用シナリオ

このノードは画像処理ワークフローで非常に有用です。例えば、マスクを生成した後、このノードに接続し、mask_color を目立つ赤色に設定することで、マスクが対象領域を正確にカバーしているかどうかを素早く検証できます。また、ビデオ合成パイプラインの前に、pass_through 機能を使用して合成結果を後続のアニメーション合成ノードに直接渡し、フローを中断してプレビューを表示する必要をなくすこともできます。

注意事項

pass_through モードを有効にすると、ノードはインターフェースにプレビュー画像を表示せず、合成結果を出力ポートから直接渡します。また、マスクの色は RGBA 形式をサポートしており、色自体に独立した透明度を指定できます。これは全体的な mask_opacity パラメータと組み合わせて作用します。