# CalibrateImage

La fonction CalibrateImage associe une calibration à une image. Autrement dit, elle associe une structure de données Calib à une structure de données Image, pour créer une nouvelle structure de données Image. La structure de données qui en résulte peut être référencée par d’autres fonctions de l’outil de vision, afin notamment d’afficher leurs résultats dans les coordonnées réelles définies par la calibration référencée.

Par exemple, un capteur est calibré à l’aide de la fonction Calibration. Ensuite, une fonction CalibrateImage est ajoutée, avec le paramètre Calib réglé sur Références à des cellules, à la structure Calib récemment créée via la fonction Calibration. Enfin, le paramètre Image d’un autre outil de vision (DetectBlobs) est défini comme une référence de cellule à la structure de données CalibrateImage, à l’origine des résultats de coordonnées de DetectBlobs dans les coordonnées réelles de l’image calibrée.

Remarque : La sortie d’un outil de vision, lorsqu’il s’agit d’un rapport en coordonnées réelles, ne peut pas être utilisée comme une entrée de repère ou de région d’un autre outil de vision.

## CalibrateImage – Entrées

Paramètres | Description
Image | Cet argument doit faire référence à une cellule de feuille de calcul contenant une structure de données Image valide. Ce paramètre doit faire référence à une cellule de feuille de calcul contenant une structure de données Image. Par défaut, le paramètre fait référence à A0, la cellule contenant la structure de données Image renvoyée par la fonction. Ce paramètre peut également faire référence à d’autres structures de données Image, telles que celles renvoyées par les Fonctions Image ouFonctions de conversion de coordonnées de l’outil de vision.
Calib | Cet argument doit faire référence à une cellule de feuille de calcul contenant une structure de données Calib valide.

## CalibrateImage – Sorties

Renvoie | Une structure de données Image contenant l’image traitée, ou #ERR si un paramètre d’entrée est incorrect.