affine3d

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

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

説明

affine3d オブジェクトは、3 次元アフィン幾何学的変換に関する情報を格納し、フォワード変換と逆変換を可能にします。

作成

構文

tform = affine3d

tform = affine3d(t)

説明

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

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

プロパティ

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

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

3 次元フォワード アフィン変換。正則な 4 行 4 列の数値行列として指定します。

行列 T は次の規則を使用します。

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

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

 [a b c 0;
  d e f 0;
  g h i 0;
  j k l 1];

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

データ型: double | single

Dimensionality — 幾何学的変換の次元

3 (既定値)

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

オブジェクト関数

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

例

異方性スケーリングのための 3 次元アフィン変換オブジェクトの作成

次元ごとに異なる倍率で 3 次元イメージをスケーリングする affine3d オブジェクトを作成します。

Sx = 1.2;
Sy = 1.6;
Sz = 2.4;
T = [Sx 0 0 0; 0 Sy 0 0; 0 0 Sz 0; 0 0 0 1];
tform = affine3d(T)

tform = 
  affine3d with properties:

                 T: [4x4 double]
    Dimensionality: 3

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

tform.T

ans = 4×4

    1.2000         0         0         0
         0    1.6000         0         0
         0         0    2.4000         0
         0         0         0    1.0000

拡張機能

C/C++ コード生成

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

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

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

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

• 生成されたコードは affine3d オブジェクトを返すことができません。代わりに、T プロパティの値など、数値配列を返すことができます。

スレッドベースの環境

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

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

バージョン履歴

R2013a で導入

R2022b: 非推奨

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

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

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

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

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

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

関数 imregtform または randomAffine3d を使用して affine3d オブジェクトを作成することはできなくなりました。これらの関数は、affinetform3d、rigidtform3d、simtform3d、または transltform3d オブジェクトとして 3 次元アフィン変換を返します。

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

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

参考

affinetform3d

トピック

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

×

例を開く

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

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