projective2d

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

projective2d は推奨されません。代わりに、projtform2d オブジェクトを使用してください。詳細については、バージョン履歴を参照してください。

説明

projective2d オブジェクトは、2 次元射影幾何学的変換をカプセル化します。

作成

projective2d オブジェクトは以下の方法を使用して作成できます。

• fitgeotrans — 2 つのイメージの間でコントロール ポイントのペアをマッピングする幾何学的変換を推定します

• ここで説明する関数 projective2d

構文

tform = projective2d

tform = projective2d(A)

説明

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

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

プロパティ

T — 2 次元フォワード射影変換

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

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

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

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

[a b c; ...
 d e f; ...
 g h i];

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

データ型: double | single

Dimensionality — 幾何学的変換の次元

読み取り専用: 2 (既定値)

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

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

オブジェクト関数

invert	幾何学的逆変換
outputLimits	与えられた入力空間範囲について出力空間範囲を求める
transformPointsForward	順方向の幾何学的変換の適用
transformPointsInverse	逆方向の幾何学的変換の適用

例

2 次元射影変換の作成

回転と傾きを結合して変換行列 tm を作成します。この変換行列を使用して projective2d 幾何学的変換オブジェクト tform を作成します。

theta = 10;
tm = [cosd(theta) -sind(theta) 0.001; ...
      sind(theta) cosd(theta) 0.01; ...
      0 0 1];
tform = projective2d(tm)

tform = 
  projective2d with properties:

                 T: [3×3 double]
    Dimensionality: 2

T プロパティの値を調べます。

tform.T

ans = 3×3

    0.9848   -0.1736    0.0010
    0.1736    0.9848    0.0100
         0         0    1.0000

拡張機能

C/C++ コード生成

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

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

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

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

GPU コード生成

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

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

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

スレッドベースの環境

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

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

バージョン履歴

R2013a で導入

R2022b: 非推奨

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

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

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

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

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

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

関数 fitgeotrans を使用して projective2d オブジェクトを作成することはできなくなりました。この関数は、2 次元射影変換を projtform2d オブジェクトとして返します。

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

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

参考

projtform2d

トピック

• 2 次元リフティングおよび 3 次元リフティング、ローカル多項式変換、ローラン多項式
• Migrate Geometric Transformations to Premultiply Convention