画像変換 KJ(ImageTransformKJ)

説明

画像変換 KJ ノードは、プレビュー内で対話的にクロップ、リサイズ、パディング、回転（およびオプションのマスク）を行うためのインターフェースを提供します。
画像入力を接続すると自動的にプレビューが表示され、プレビュー上で直接クロップ領域の描画、パディング位置の調整、回転の適用が可能です。

クロップ

• クリック＆ドラッグでクロップ領域を描画します。
• 領域内をドラッグして移動、端または角をドラッグしてリサイズします。
• 右クリックで領域を削除します。
• Ctrl キーを押しながら操作するとグリッドにスナップします。
• リサイズ中に Shift キーを押しながら操作するとアスペクト比が固定されます。
• リサイズ中に Alt キーを押しながら操作すると、中心対称にリサイズされます。

パディング

• Shift キーを押しながらプレビュー内のコンテンツをドラッグすると、パディング位置（pad_x、pad_y に相当）を調整できます。

回転

• 回転 ボタンをクリックすると回転クロスが有効になります。ドラッグで回転、右クリックで回転をリセットします。

入力

注意：対話型プレビューはリアルタイムで更新されます。pad_x、pad_y、width_mult、height_mult、回転の変更は即座に反映されます。

出力

使用上の注意

• 対話型クロッピング が主要なワークフローです。プレビューを使って直感的にクロップ領域を選択できます。bboxes 入力を使用すると、プログラム的に領域を指定または上書きできます。
• リサイズ動作：target_width と target_height が両方とも 0 の場合、出力はクロップ/パディング後のサイズを維持し、追加のアップスケーリングは行われません。特定の解像度にリサイズするには、片方または両方のターゲットを設定し、upscale_method を選択します。keep_proportion オプションは、画像を引き伸ばすか、ターゲットに合わせてクロップするか、パディングで埋めるかを決定します。
• パディング は、extra_padding が有効な場合のみ適用されます。pad_x / pad_y でコンテンツの位置を指定し、edge_mode でパディング領域の塗りつぶし方法を制御します。
• 回転 はクロップ後、リサイズ/パディング前に適用されます。プレビューの回転クロスで細かく調整できます。回転は内部的に保存され、セッションごとに調整可能です。
• divisible_by パラメータは、寸法をモデルに適したサイズ（例：8、16、32の倍数）に揃えるのに便利です。0 に設定すると制約が無効になります。
• 座標スナップ：Ctrl キーを押しながらクロップ矩形を描画または移動すると、位置とサイズがグリッドにスナップします（グリッド間隔はノード内部のステップに依存）。これにより、クロップを規則的なタイルに揃えることができます。

最終出力に影響を与えるすべてのパラメータは入力として公開されているため、このノードは対話的使用と、適切な値（たとえば、バウンディングボックスや寸法を出力する他のノードからの値）を接続する完全自動パイプラインの両方で使用できます。