# TransformImage

La función TransformImage genera una estructura de datos Image que tiene en cuenta las distorsiones a través de una estructura de datos Calib proporcionada por una función CalibratePoints.

Nota: Esta función genera únicamente imágenes en escala de grises.

## TransformImage Descripción general

La función TransformImage utiliza como argumentos una estructura de datos Calib proporcionada por CalibratePoints y la estructura de datos Image referenciada por la función ExtractCalibrationPoints para generar una estructura de datos Image que considera las distorsiones lineal, no lineal y de lente a fin de proporcionar una versión de la imagen libre de distorsiones. Esta nueva imagen de salida comprende una transformación 2D interna y está expresada en coordenadas mundo.

Nota: El período de entrenamiento de TransformImage, que tiene lugar cuando se agrega la función a la hoja de cálculo, cuando se modifica la región especificada o cuando se carga una tarea con la función, puede durar unos 3 segundos en un sistema de visión In-Sight con una resolución de 640 x 480 y hasta 30 segundos en un sistema de visión con una resolución de 1600 x 1200.

La dimensión de las herramientas 2D era de 640x480. Pero ha pasado a ser de 1430x1006 para 3D - A1000 y de 2880x8000 para 3D - L4000. De esta forma, el número máximo de líneas que capturan actualmente los sistemas de visión de la serie A1000 es de 1430, mientras que el número máximo de líneas que capturan los sistemas de visión de la serie L4000 es de 2880. La anchura máxima de los dispositivos A1000 In-Sight es de 1006, mientras que la de los dispositivos L4000 In-Sight es de 8000.

## TransformImage Entradas

Parámetro | Descripción
Imagen | This parameter must reference a spreadsheet cell that contains an Imagen data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the Image Vision Data Access functions or Funciones de transformación de coordenadas.
Calibración | Este argumento debe hacer referencia a una celda de la hoja de cálculo que contiene una estructura válida de datos Calib creada por una función Calibrate cualquiera.
Región | También conocida como región de interés (RDI), especifica la región de la imagen que se somete a análisis. Haga doble clic sobre el parámetro Región para crear un Modo gráfico interactivo que permite transformar y girar. Seleccione este parámetro y pulse el botón «Maximizar región» en la barra de herramientas de edición de tareas de la hoja de propiedades a fin de expandir automáticamente la región hasta cubrir toda la imagen.
X | El desplazamiento en X del origen, en coordenadas del elemento posicionador..
Y | El desplazamiento en Y del origen, en coordenadas del elemento posicionador.
Ancho | El tamaño de la región en la dirección del eje Y.
Altura | El tamaño de la región en la dirección del eje X.
Escala de imagen | Especifica la escala a la que se visualiza la imagen transformada. El valor de ajuste mínimo es de 0,01; el máximo de 10,00 y el ajuste predeterminado es de 1,000.
Punto de referencia | Especifica el punto de referencia de origen de la transformación.
0 = Centro de imagen (por defecto) | El punto de referencia será el centro de la imagen.
1 = Centro de la región | El punto de referencia será el centro de la RDI.
Mostrar | Especifica el modo de visualización de los gráficos de TransformImage sobre la imagen.
0 = ocultar todo | Se ocultarán todos los gráficos, excepto cuando la celda que contiene la función TransformImage está seleccionada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará en todo momento la imagen libre de distorsiones.
2 = gráficos de entrada y resultado | Se visualizará en todo momento la región de la imagen de entrada y la imagen libre de distorsiones.

## TransformImage Salidas

Devuelve | Una estructura de datos Image que contiene la imagen procesada, o #ERR si alguno de los parámetros de entrada no es válido. La nueva imagen de salida en coordenadas mundo; las herramientas de visión del In-Sight que hacen referencia a esta imagen proporcionarán resultados expresados en coordenadas mundo. Nota: No se guardan con la tarea los contenidos de la región procesada de la imagen que comprende la estructura de datos Image.