imrotate

イメージの回転

構文

J = imrotate(I,angle)

J = imrotate(I,angle,method)

J = imrotate(I,angle,method,bbox)

説明

J = imrotate(I,angle) は、中心点を中心にしてイメージ I を反時計回りに angle 度回転します。イメージを時計回りに回転させるには、angle に負の値を指定します。imrotate は、回転したイメージ全体が出力イメージ J に含まれるようにします。既定では、imrotate は最近傍内挿法を使用して、回転したイメージの外側の J のピクセルの値を、数値イメージおよび論理イメージの場合は 0 に、categorical イメージの場合は missing に設定します。

J = imrotate(I,angle,method) は、method で指定された内挿法を使用して、イメージ I を回転します。

J = imrotate(I,angle,method,bbox) は、bbox 引数も使用して、出力イメージのサイズを定義します。入力イメージと同じサイズになるように出力をトリミングすることも、回転したイメージ全体を返すこともできます。

例

イメージを水平に合わせるための時計回りの回転

イメージをワークスペースに読み取った後、グレースケール イメージに変換します。

I = fitsread('solarspectra.fts');
I = rescale(I);

元のイメージを表示します。

figure
imshow(I)
title('Original Image')

イメージを時計回りの方向に 1 度回転し、水平に合わせます。この例では、双一次内挿を指定し、結果が元のイメージと同じサイズにトリミングされるように要求しています。

J = imrotate(I,-1,'bilinear','crop');

回転させたイメージを表示します。

figure
imshow(J)
title('Rotated Image')

入力引数

I — 回転するイメージ

数値配列 | logical 配列 | categorical 配列

回転するイメージ。数値配列、logical 配列、または categorical 配列として指定します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical

angle — 回転量 (度単位)

数値スカラー

回転量 (度単位)。数値スカラーとして指定します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

method — 内挿法

"nearest" (既定値) | "bilinear" | "bicubic"

内挿法。次のいずれかの値に指定します。

値	説明
"nearest"	最近傍内挿。出力ピクセルには、対象の点が含まれるピクセルの値が代入されます。周りの他のピクセルは、考慮に入れません。 最近傍内挿は、categorical イメージでサポートされている唯一のメソッドです。
"bilinear"	双一次内挿。出力ピクセル値は、最近傍の 2×2 のピクセルの加重平均です。
"bicubic"	双三次内挿。出力ピクセル値は、最近傍の 4×4 のピクセルの加重平均です。 メモ 双三次内挿は、元の範囲外のピクセル値を生成します。

データ型: char | string

bbox — 出力イメージのサイズを定義する境界ボックス

"loose" (既定値) | "crop"

出力イメージのサイズを定義する境界ボックス。次のいずれかの値に指定します。

値	説明
"crop"	出力イメージ J と入力イメージ I のサイズが同じになるように、回転したイメージが適合するように切り取ります。
"loose"	回転したイメージ全体が出力イメージ J に含まれます。J は I より大きくなっています。

データ型: char | string

出力引数

J — 回転したイメージ

数値配列 | logical 配列 | categorical 配列

回転したイメージ。入力イメージ I と同じデータ型の数値配列、logical 配列、または categorical 配列として返されます。

ヒント

• 場合によって、この関数は、uint8、uint16、single および double の各データ型に対し、ハードウェア最適化を利用して実行を高速化します。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• imrotate では C コードの生成がサポートされています (MATLAB^® Coder™ が必要)。汎用の MATLAB Host Computer ターゲット プラットフォームを選択した場合、プリコンパイルされたプラットフォーム固有の共有ライブラリを使用するコードが、imrotate によって生成されます。共有ライブラリを使用するとパフォーマンスの最適化は維持されますが、コードを生成できるターゲット プラットフォームが限定されます。詳細については、Image Processing Toolbox でサポートされているコード生成のタイプを参照してください。

• データ型 categorical の入力イメージはサポートされていません。

• 引数 method および bbox はコンパイル時の定数でなければなりません。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

• データ型 categorical の入力イメージはサポートされていません。

• 引数 method および bbox はコンパイル時の定数でなければなりません。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数は、スレッドベースの環境を完全にサポートします。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

使用上の注意および制限:

• gpuArray 入力は uint8 型、uint16 型、single 型、または logical 型でなければなりません。

• この関数の GPU 実装で使用される "bicubic" 内挿モードは、既定の (CPU) 双三次モードとは異なります。この関数の GPU 版および CPU 版では、若干異なる結果が得られることが予想されます。

詳細については、GPU でのイメージ処理を参照してください。

バージョン履歴

R2006a より前に導入

R2021b: スレッドベース環境のサポート

imrotate は、スレッドベースの環境をサポートするようになりました。

R2015b: 新しい空間命名規則

この関数は Version 9.3 (R2015b) で変更されました。以前のバージョンの Image Processing Toolbox™ は異なる空間規則を使用しています。以前の実装時と同じ結果を得る必要がある場合、関数 imrotate_old を使用してください。

参考

imcrop | imrotate3 | imresize | imtransform | tformarray

トピック

• イメージの回転
• イメージの回転とスケーリングの検出