affine3d

(권장되지 않음) 후위곱 규칙을 사용하는 3차원 아핀 기하 변환

페이지 내 모두 확장

affine3d는 권장되지 않습니다. 대신 affinetform3d 객체를 사용하십시오. 자세한 내용은 호환성 관련 고려 사항 항목을 참조하십시오.

설명

affine3d 객체는 3차원 아핀 기하 변환에 대한 정보를 저장하며, 순방향 및 역방향 변환을 적용합니다.

생성

구문

tform = affine3d

tform = affine3d(t)

설명

tform = affine3d는 항등 변환에 해당하는 디폴트 속성 설정을 사용하여 affine3d 객체를 만듭니다.

예제

tform = affine3d(t)는 속성 T를 지정된 3차원 아핀 변환 행렬 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`	Determine if geometric transformation is rigid transformation
`isSimilarity`	Determine if geometric transformation is similarity transformation
`isTranslation`	Determine if geometric transformation is pure translation
`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™가 필요함). 자세한 내용은 Code Generation for Image Processing 항목을 참조하십시오.
코드 생성 시 단일 객체만 지정할 수 있으며, 객체로 구성된 배열은 지원되지 않습니다.
생성된 코드는 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');

이 예제에서는 후위곱 규칙의 변환 행렬 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 객체를 만들 수 없습니다. 이러한 함수는 3차원 아핀 변환을 affinetform3d, rigidtform3d, simtform3d 또는 transltform3d 객체로 반환합니다.

R2021b: 스레드 기반 환경 지원

affine3d 함수는 이제 스레드 기반 환경을 지원합니다.

참고 항목

affinetform3d

affine3d

설명

생성

구문

설명

속성

T — 순방향 3차원 아핀 변환 4×4 단위 행렬 (디폴트 값) | 4×4 숫자형 정칙 행렬

Dimensionality — 기하 변환의 차원 수 3 (디폴트 값)