画像のクロップ (CropImage)
概要 (What is it?)
CropImage ノードは、画像の切り抜き（クロップ）、ズーム、および回転を精密にコントロールします。画像の特定領域の選択、ズームによる拡大/縮小、画像の向きを修正するための回転を行い、ワークフローに最適な構図を作り出すことができます。
使用する場面 (When would I use it?)
以下のような場面でこのノードを使用します：
- 画像を特定の寸法やアスペクト比に切り抜きたい場合
- 画像内の特定の被写体や領域にフォーカスしたい場合
- ズーム効果を適用してディテールを拡大したい場合
- 画像の傾きや向きを回転させて修正したい場合
- ワークフロー全体で画像サイズの一貫性を保ちたい場合
- 不要な背景領域や余白をトリミングしたい場合
- 特定の出力仕様やアスペクト比に合わせて画像を整形したい場合
使い方 (How to use it)
基本セットアップ
- ワークフローに CropImage ノードを追加します
- 画像ソースを "input_image" 入力に接続します
- クロップの開始座標と寸法（幅・高さ）を設定します
- 必要に応じてズーム倍率と回転角度を調整します
- 処理された画像が "output" パラメータから出力されます
パラメータ一覧 (Parameters)
クロップ設定 (Crop Settings)
- left（0 以上、デフォルト: 0）: 切り抜き領域の左端の X 座標（ピクセル単位）
- top（0 以上、デフォルト: 0）: 切り抜き領域の上端の Y 座標（ピクセル単位）
- width（1 以上、デフォルト: 100）: 切り抜き領域の幅（ピクセル単位）
- height（1 以上、デフォルト: 100）: 切り抜き領域の高さ（ピクセル単位）
変形設定 (Transform Settings)
-
zoom（1.0 以上、デフォルト: 1.0）: クロップ領域のズーム倍率
- 1.0: ズームなし（等倍）
- 1.0 超: ズームイン（拡大）
- 1.0 未満: ズームアウト（縮小）
-
rotate（度数、デフォルト: 0）: 回転角度（度単位）
- 正の値: 時計回りに回転
- 負の値: 反時計回りに回転
出力 (Outputs)
- output: クロップおよび変形が適用された画像
使用例 (Example)
一般的なクロップワークフローの例：
- LoadImage を使用して画像を読み込みます
- その画像を CropImage ノードの "input_image" パラメータに接続します
- クロップ領域を設定します：
- 左端から 100 ピクセル離れた位置から開始するため left を 100 に設定
- 上端から 50 ピクセル離れた位置から開始するため top を 50 に設定
- 幅 400 ピクセルで切り抜くため width を 400 に設定
- 高さ 300 ピクセルで切り抜くため height を 300 に設定
- 必要に応じて変形エフェクトを追加：
- クロップ領域を 20% 拡大するため zoom を 1.2 に設定
- 時計回りに 15 度傾けるため rotate を 15 に設定
- "output" を DisplayImage に接続して結果を確認します
重要な注意点 (Important Notes)
- リアルタイムプレビュー: パラメータを調整するとリアルタイムに結果が反映されます
- 境界チェック: ノードはクロップ領域が元画像の境界内に収まるように自動的に安全性を確保します
- 高品質リサンプリング: ズームや回転処理には高品質な補間リサンプリングアルゴリズムが使用されます
- RGBA のサポート: RGBA 画像の透過チャンネルはそのまま保持されます
よくある問題 (Common Issues)
- クロップ領域が空: width と height が 0 より大きな値になっていることを確認してください
- 画像外へのクロップ:
left + widthおよびtop + heightが元画像の解像度を超えていないか確認してください - 意図しない切り抜き: クロップ座標が画像の有効範囲内にあるか再度確認してください
技術的な詳細 (Technical Details)
このノードは以下の処理を実行します：
- Crop（切り抜き）: 画像から指定された矩形領域を抽出
- Zoom（ズーム）: 高品質リサンプリングを用いてクロップ領域をスケーリング
- Rotate（回転）: 画像の中心点を基準に指定角度で回転
- 境界管理: すべての操作が有効な画像境界内で完結するように制御
これにより、プロ品質の画像クロップおよび変形機能を提供します。