affine2d

(No recomendado) Transformación geométrica afín 2D mediante la convención de la posmultiplicación

No se recomienda el uso de affine2d. Utilice el objeto affinetform2d en su lugar. Para obtener más información, consulte Historial de versiones.

Descripción

Un objeto affine2d almacena información sobre una transformación geométrica afín 2D mediante la convención de la posmultiplicación y permite las transformaciones directas e inversas.

Creación

Sintaxis

tform = affine2d

tform = affine2d(t)

Descripción

tform = affine2d crea un objeto affine2d con valores predeterminados de propiedad que se corresponden con la transformación identidad.

tform = affine2d(t) establece la propiedad T como la matriz de transformación afín 2D especificada t.

Propiedades

T — Transformación afín 2D directa

Matriz identidad de 3 por 3 (predeterminado) | Matriz numérica de 3 por 3 no única

Transformación afín 2D directa, especificada como matriz numérica de 3 por 3 no única. La matriz T utiliza la convención:

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

en la que T tiene la forma:

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

El valor predeterminado de T es la transformación identidad.

Tipos de datos: double | single

Dimensionality — Dimensionalidad de la transformación geométrica

Solo lectura: 2 (predeterminado)

Esta propiedad o parámetro es de solo lectura.

Dimensionalidad de la transformación geométrica tanto para puntos de entrada como de salida, especificada como el valor 2.

Funciones del objeto

invert	Invertir la transformación geométrica
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	Encontrar los límites espaciales de salida dados los límites espaciales de entrada
transformPointsForward	Aplicar transformación geométrica directa
transformPointsInverse	Aplicar la transformación geométrica inversa

Ejemplos

Definir transformación afín 2D a partir de la matriz de transformación

Cree un objeto affine2d que defina una rotación de 30 grados en sentido contrario a las agujas del reloj alrededor del origen.

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

tform = 
  affine2d with properties:

                 T: [3×3 double]
    Dimensionality: 2

Aplique la transformación geométrica directa a un punto (10,0).

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

x = 
8.6603

y = 
5

Valide la transformación representando el punto original (color azul) y el punto transformado (color rojo).

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

Transformar imagen utilizando un objeto de transformación afín 2D

Lea una imagen en el área de trabajo.

A = imread('pout.tif');

Cree un objeto affine2d que defina una transformación geométrica afín. En este ejemplo se combina el corte vertical con el estiramiento horizontal.

tform = affine2d([2 0.33 0; 0 1 0; 0 0 1])

tform = 
  affine2d with properties:

                 T: [3×3 double]
    Dimensionality: 2

Aplique la transformación geométrica a la imagen utilizando imwarp.

B = imwarp(A,tform);

Muestre la imagen resultante.

figure
imshow(B);
axis on equal;

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• affine2d es compatible con la generación de código C y C++ (requiere MATLAB^® Coder™). Para obtener más información, consulte Code Generation for Image Processing.

• Cuando se genera código, puede especificar únicamente objetos determinados, ya que los arreglos de objetos no son compatibles.

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• Cuando se genera código, puede especificar únicamente objetos determinados, ya que los arreglos de objetos no son compatibles.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con los entornos basados en hilos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Historial de versiones

Introducido en R2013a

R2022b: No recomendado

A partir de la versión R2022b, la mayoría de funciones de Image Processing Toolbox™ crean y realizan transformaciones geométricas utilizando la convención de la premultiplicación. Por lo tanto, no se recomienda el objeto affine2d porque utiliza la convención de la posmultiplicación. Aunque no está previsto eliminar el objeto affine2d por el momento, puede simplificar sus flujos de transformación geométrica cambiando al objeto affinetform2d, que es compatible con la convención de la premultiplicación. Para obtener más información, consulte Migrate Geometric Transformations to Premultiply Convention.

Para actualizar su código:

• Cambie las instancias del nombre de la función affine2d a affinetform2d.

• Especifique la matriz de transformación como la traspuesta de la matriz T, donde T es o bien el valor de la propiedad T del objeto affine2d o bien la matriz de transformación usada para crear el objeto affine2d.

Uso no recomendado	Reemplazo recomendado
Este ejemplo crea un objeto affine2d a partir de la matriz de transformación T en la convención de la posmultiplicación. T = [2 0.33 0; 0 1 0; 0 0 1]; tformPost = affine2d(T);	Este ejemplo crea un objeto affinetform2d a partir de la traspuesta de la matriz de transformación T. T = [2 0.33 0; 0 1 0; 0 0 1]; tform = affinetform2d(T'); Este ejemplo empieza con un objeto affine2d llamado tformPost y crea un objeto affinetform2d a partir de la traspuesta de la propiedad T de tformPost. T = tformPost.T; tform = affinetform2d(T');

R2022b: Menos funciones crean objetos affine2d

Ya no puede crear un objeto affine2d mediante las funciones imregtform, imregcorr, fitgeotrans o randomAffine2d. Estas funciones devuelven transformaciones afines 2D como un objeto affinetform2d, un objeto rigidtform2d, un objeto simtform2d o un objeto transltform2d.

R2021b: Compatibilidad con entornos basados en hilos

Ahora affine2d es compatible con los entornos basados en hilos.

Consulte también

affinetform2d

Temas

• Visión general del proceso de transformación geométrica 2D y 3D
• Migrate Geometric Transformations to Premultiply Convention