# CalibrateImage

Asocia una calibración con una imagen. La función CalibrateImage asocia una estructura de datos Calib con una estructura de datos Imagen para crear una nueva estructura de datos Image. 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, en la estructura Calib recién creada por la función Calibrate. Entonces, otra herramienta de Vision Tools como DetectBlobs establece su parámetro Image como una referencia de celda a la estructura de datos CalibrateImage, por lo que las coordenadas de los resultados de DetectBlobs se expresen en las coordenadas mundo de la imagen calibrada.

Nota: La salida de una herramienta de Vision Tools que está expresada en coordenadas mundo no puede ser utilizada 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 Imagen válida. This parameter must reference a spreadsheet cell that contains an Imagen data structure; by default, this parameter references A0, the cell containing the Image data structure returned by function. This parameter can also reference other Imagen data structures, such as those returned by the Vision Tool Funciones Image or 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 Image que contiene la imagen procesada, o #ERR si alguno de los parámetros de entrada no es válido.