projtform2d

Transformación geométrica proyectiva 2D

Desde R2022b. Recomendado en lugar de projective2d.

Descripción

Un objeto projtform2d almacena información sobre una transformación geométrica proyectiva 2D y permite transformaciones directas e inversas.

Creación

Puede crear un objeto projtform2d de los modos siguientes:

• fitgeotform2d: estima una transformación geométrica que asigna pares de puntos de control entre dos imágenes.

• La función projtform2d aquí descrita.

Sintaxis

tform = projtform2d

tform = projtform2d(projMat)

tform = projtform2d(tformIn)

Descripción

tform = projtform2d crea un objeto projtform2d que realiza una transformación identidad.

tform = projtform2d(projMat) crea un objeto projtform2d a partir de una matriz de transformación proyectiva 2D válida, projMat.

tform = projtform2d(tformIn) crea un objeto projtform2d a partir de otro objeto de transformación geométrica, tformIn, que representa una transformación geométrica proyectiva 2D válida.

Argumentos de entrada

projMat — Transformación proyectiva 2D directa

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

Transformación proyectiva 2D directa, especificada como matriz numérica de 3 por 3.

Este argumento establece la propiedad A.

Tipos de datos: double | single

tformIn — Transformación geométrica proyectiva 2D

objeto affinetform2d | objeto rigidtform2d | objeto simtform2d | objeto transltform2d | objeto projtform2d

Transformación geométrica proyectiva 2D, especificada como objeto affinetform2d, rigidtform2d, simtform2d, transltform2d o projtform2d.

Argumentos de salida

tform — Transformación geométrica proyectiva 2D

objeto projtform2d

Transformación geométrica proyectiva 2D, devuelta como un objeto projtform2d.

Propiedades

A — Transformación proyectiva 2D directa

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

Transformación proyectiva 2D directa, especificada como matriz numérica de 3 por 3. El valor predeterminado de A es la matriz identidad.

La matriz A transforma el punto (u, v) del espacio de coordenadas de entrada en el punto (x, y) del espacio de coordenadas de salida utilizando la convención:

$$\left[\begin{array}{c}{x}^{\prime }\\ y^{\prime }\\ k\end{array}\right]={\rm A}\times \left[\begin{array}{c}u\\ v\\ 1\end{array}\right]$$

donde x = xʹ / k y y = yʹ / k.

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, devuelta como el valor 2.

Tipos de datos: double

Funciones del objeto

invert	Invertir la transformación geométrica
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

Crear una transformación proyectiva 2D

Defina una matriz de transformación geométrica de 3 por 3. Esta matriz especifica una transformación proyectiva que consiste en rotación e inclinación.

theta = 30;
A = [cosd(theta) -sind(theta) 0; ...
     sind(theta)  cosd(theta) 0; ...
     0.001        0.001       1];

Cree un objeto projtform2d a partir de la matriz de transformación.

tform = projtform2d(A)

tform = 
  projtform2d with properties:

    Dimensionality: 2

                 A: [0.8660   -0.5000         0
                     0.5000    0.8660         0
                     0.0010    0.0010    1.0000]

Examine el valor de la propiedad A.

tform.A

ans = 3×3

    0.8660   -0.5000         0
    0.5000    0.8660         0
    0.0010    0.0010    1.0000

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• projtform2d 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 genera código, solo puede especificar objetos singulares. 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 R2022b

R2022b: Recomendado en lugar de projective2d

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. El objeto projtform2d almacena información sobre transformaciones geométricas proyectivas 2D en un formato coherente con la convención de premultiplicación.

No se recomienda el objeto projective2d porque utiliza la convención de posmultiplicación. Aunque no está previsto eliminar el objeto projective2d por el momento, puede simplificar sus flujos de transformación geométrica cambiando al objeto projtform2d. Para obtener más información, consulte Migrate Geometric Transformations to Premultiply Convention.

Consulte también

fitgeotform2d | affinetform2d | rigidtform2d | simtform2d | transltform2d | imwarp

Temas

• Visión general del proceso de transformación geométrica 2D y 3D
• Representación matricial de transformaciones geométricas