# CalibrateImage

Asocia una calibración con una imagen. CalibrateImage asocia una estructura de datos Calib con una estructura de datos de Imagen para crear una nueva estructura de datos de imagen. La estructura de datos resultante puede ser objeto de referencia de otras herramientas del conjunto Vision Tools con el fin de visualizar sus resultados en el sistema de coordenadas mundo definido por la calibración a la que se hace referencia.

Por ejemplo, supongamos que se calibra un sensor mediante la función Calibrate. A continuación, se inserta la función CalibrateImage con el parámetro Calib configurado como Referencias de celda a la estructura Calib recién creada por la función Calibrate. Entonces, otra herramienta de Vision Tools como DetectBlobs establece su parámetro de Imagen como una referencia de celda a la estructura de datos de CalibrateImage, lo que hace que las coordenadas de los resultados de DetectBlobs se expresen en las coordenadas mundo de la imagen calibrada.

Nota: La salida de cualquier herramienta de Vision Tools que se exprese en coordenadas mundo real no puede utilizarse como entrada de un elemento posicionador o de una región para otra herramienta de Vision Tools.

## CalibrateImage Entradas

Parámetros | Descripción
Imagen | Este argumento debe hacer referencia a una celda de la hoja de cálculo que contenga una estructura de datos de Imagen válida. Este parámetro debe hacer referencia a una celda de la hoja de cálculo que contiene una estructura de datos de Imagen; por defecto, este parámetro hace referencia a A0, la celda que contiene la estructura de datos de imagen devuelta por la función. Este parámetro puede hacer también referencia a otras estructuras de datos de Imagen, como las devueltas por las Funciones Image del conjunto Vision Tools o por las Funciones de transformación de coordenadas.
Calib | Este argumento debe hacer referencia a una celda de la hoja de cálculo que contenga una estructura de datos Calib válida.

## CalibrateImage Salidas

Devuelve | Una estructura de datos de Imagen que contiene la imagen procesada o #ERR si alguno de los parámetros de entrada no es válido.