このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

affine2d

(非推奨) 右から乗算する規則を使用した 2 次元アフィン幾何学的変換

affine2d は推奨されません。代わりに、affinetform2d オブジェクトを使用してください。詳細については、互換性の考慮事項を参照してください。

説明

affine2d オブジェクトは、右から乗算する規則を使用して 2 次元アフィン幾何学的変換に関する情報を格納し、フォワード変換と逆変換を可能にします。

作成

構文

tform = affine2d

tform = affine2d(t)

説明

tform = affine2d は、恒等変換に該当する既定のプロパティ設定を使用して affine2d オブジェクトを作成します。

tform = affine2d(t) は、指定された 2 次元アフィン変換行列 t をプロパティ T に設定します。

プロパティ

T — 2 次元フォワード アフィン変換

3 行 3 列の単位行列 (既定値) | 正則な 3 行 3 列の数値行列

2 次元フォワード アフィン変換。正則な 3 行 3 列の数値行列として指定します。行列 T は次の規則を使用します。

[x y 1] = [u v 1] * T

ここで、T の形式は次のとおりです。

 [a b 0;
  c d 0;
  e f 1];

T の既定の設定は、恒等変換です。

データ型: double | single

Dimensionality — 幾何学的変換の次元

2 (既定値)

この プロパティ は読み取り専用です。

入力点と出力点の両方の幾何学的変換の次元。値 2 として指定します。

オブジェクト関数

invert	Invert geometric transformation
isRigid	幾何学的変換が剛体変換かどうかの判別
isSimilarity	幾何学的変換が相似変換かどうかの判別
isTranslation	幾何学的変換が純粋な平行移動かどうかの判別
outputLimits	Find output spatial limits given input spatial limits
transformPointsForward	Apply forward geometric transformation
transformPointsInverse	Apply inverse geometric transformation

例

変換行列からの 2 次元アフィン変換の定義

原点回りの反時計方向に 30 度の回転を定義する affine2d オブジェクトを作成します。

theta = 30;
tform = affine2d([ ...
    cosd(theta) sind(theta) 0;...
    -sind(theta) cosd(theta) 0; ...
    0 0 1])

tform = 
  affine2d with properties:

                 T: [3x3 double]
    Dimensionality: 2

フォワード幾何学的変換を点 (10,0) に適用します。

[x,y] = transformPointsForward(tform,10,0)

x = 8.6603

y = 5

元の点 (青色) と変換された点 (赤色) をプロットして変換を検証します。

plot(10,0,'bo',x,y,'ro')
axis([0 12 0 12])
axis square

拡張機能

C/C++ コード生成

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

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

• affine2d では C コードの生成がサポートされています (MATLAB^® Coder™ が必要)。詳細については、イメージ処理のコード生成を参照してください。

• コードを生成するとき、特異オブジェクトだけを指定できます。オブジェクトの配列はサポートされていません。

GPU コード生成

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

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

• コードを生成するとき、特異オブジェクトだけを指定できます。オブジェクトの配列はサポートされていません。

スレッドベースの環境

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

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

バージョン履歴

R2013a で導入

R2022b: 非推奨

R2022b 以降、ほとんどの Image Processing Toolbox™ 関数は、左から乗算する規則を使用して幾何学的変換を作成し、実行します。そのため、affine2d オブジェクトは右から乗算する規則を使用していることから推奨されません。現時点では、affine2d オブジェクトを削除する予定はありませんが、左から乗算する規則をサポートする affinetform2d オブジェクトに切り替えることで、幾何学的変換のワークフローを効率化できます。詳細については、Migrate Geometric Transformations to Premultiply Conventionを参照してください。

コードを更新するには、次を行います。

• 関数名 affine2d のインスタンスを affinetform2d に変更します。

• 行列 T の転置として変換行列を指定します。ここで、T は affine2d オブジェクトの T プロパティの値または affine2d オブジェクトの作成に使用した変換行列のいずれかです。

非推奨の使用方法	推奨される代替案
この例では、右から乗算する規則で変換行列 T から affine2d オブジェクトを作成します。 T = [2 0.33 0; 0 1 0; 0 0 1]; tformPost = affine2d(T);	この例では、変換行列 T の転置から affinetform2d オブジェクトを作成します。 T = [2 0.33 0; 0 1 0; 0 0 1]; tform = affinetform2d(T'); この例では、tformPost という名前の affine2d オブジェクトから開始し、tformPost の T プロパティの転置から affinetform2d オブジェクトを作成します。 T = tformPost.T; tform = affinetform2d(T');

R2022b: affine2d オブジェクトを作成する関数の減少

関数 imregtform、imregcorr、fitgeotrans、または randomAffine2d を使用して affine2d オブジェクトを作成することはできなくなりました。これらの関数は、affinetform2d オブジェクト、rigidtform2d オブジェクト、simtform2d オブジェクト、または transltform2d オブジェクトとして 2 次元アフィン変換を返します。

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

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

参考

affinetform2d

トピック

• 2 次元および 3 次元の幾何学的変換プロセスの概要
• Migrate Geometric Transformations to Premultiply Convention

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい