# TransformImage

TransformImage génère une structure de données Image qui tient compte de la déformation à l’aide d’une structure de données Calib produite par une fonction CalibratePoints.

Remarque : Cette fonction ne génère que des images en niveaux de gris.

## TransformImage – Présentation

TransformImage génère une structure de données Image à l’aide d’une structure de données Calib CalibratePoints et une structure de données Image référencée par une ExtractCalibrationPoints passées en arguments. Cette transformation tient compte de la déformation linéaire, non linéaire et de l’objectif pour renvoyer une version « non déformée » de l’image. Cette nouvelle image de sortie présente une transformation 2D interne et est en coordonnées réelles.

Remarque : La période d’apprentissage de TransformImage, qui a lieu lorsque la fonction est ajoutée à la feuille de calcul, lorsque la région spécifiée est modifiée ou lorsqu’un projet avec la fonction est chargé, peut prendre jusqu’à 3 secondes sur un système de vision In-Sight avec une résolution de 640 x 480, et jusqu’à 30 secondes avec une résolution de 1600 x 1200.

Les dimensions des outils 2D sont 640 × 480. Cependant, elles sont désormais 1430 × 1006 pour le 3D - A1000, et 2880 × 8000 pour le 3D - L4000. Ainsi, le nombre maximum de lignes actuellement acquises par les systèmes de vision Série A1000 est 1430, et 2880 pour la Série L4000. La largeur maximale pour les périphériques In-Sight A1000 est 1006, et 8000 pour les périphériques In-Sight L4000.

## TransformImage – entrées

Paramètre | Description
Image | This parameter must reference a spreadsheet cell that contains an Image 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 Fonctions de conversion de coordonnées.
Calibrage | Cet argument doit faire référence à une cellule de feuille de calcul contenant une structure de données Calib valide créées par une fonction Calibrate.
Région | Aussi appelé région d’intérêt (ROI), spécifie la région de l’image qui fait l’objet d’une analyse. Effectuez un double-clic sur le paramètre Région pour créer un Mode Graphiques interactifs que vous pouvez transformer et faire pivoter. Sélectionnez ce paramètre et cliquez sur le bouton Agrandir la région dans la barre d’outils Modification du projet de la feuille de propriétés pour agrandir automatiquement la région pour qu’elle couvre l’intégralité de l’image.
X | L’offset en X de l’origine (coordonnées du repère)..
Y | L’offset en Y de l’origine (coordonnées du repère).
Largeur | La dimension le long de l’axe des y de la région.
Hauteur | La dimension le long de l’axe des x de la région.
Échelle de l’image | Indique l’échelle à laquelle l’image transformée est affichée. Le paramètre minimum est 0,01, le maximum est 10,00 et le paramètre par défaut est 1,000.
Point de référence | Indique le point de référence de l’origine pour la transformation.
0 = Centre de l’image (par défaut) | Le point de référence sera le centre de l’image.
1 = Centre de la région | Le point de référence sera le centre de la ROI.
Afficher | Détermine le mode d’affichage des graphiques TransformImage superposés à l’image.
0 = masquer tout | Tous les graphiques sont masqués, sauf lorsque la cellule contenant la fonction TransformImage est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | L’image non déformée est toujours affichée.
2 = graphiques d’entrées et de résultats | La région d’image d’entrée et l’image non déformée sont toujours affichées.

## TransformImage – Sorties

Renvoie | Une structure de données Image contenant l’image traitée, ou #ERR si un paramètre d’entrée est incorrect. La nouvelle image de sortie est basée sur des coordonnées réelles. Les outils de vision In-Sight qui font référence à cette image indiquent les résultats avec des valeurs de coordonnées réelles. Remarque : Le contenu de la région de l’image traitée dans la structure de données Image n’est pas enregistré avec le projet.