# ExtractCalibrationPoints

La fonction ExtractCalibrationPoints extrait les points de calibrage d’une image dans une grille de calibrage en damier. Les points de calibrage peuvent être utilisés par d’autres outils de calibrage.

## ExtractCalibrationPoints – Présentation

Une image de calibrage, une grille en damier avec un point de calibrage et une échelle connus, permet d’entraîner la fonction ExtractCalibrationPoints. Pendant l’analyse, elle trouve les emplacements, en pixels, des intersections des cellules de la grille, puis les reporte sur un modèle de grille. La fonction renvoie une structure de données CalibPoints ainsi que le nombre de points trouvés dans la grille. L’ensemble des points de calibrage peut être utilisé ultérieurement par d’autres outils de calibrage, tels que CalibratePoints, pour corriger une déformation, pour faire correspondre les coordonnées de l’image à des coordonnées réelles, ou inversement.

Remarque : Utilisez une grille de calibration en damier avec des points de calibrage. Le calibrage avec une grille de points ou des grilles sans point de calibrage n’est pas prise en charge pour le moment.

## ExtractCalibrationPoints – entrées

Paramètre | Description
--- | ---
Image | Cet argument doit faire référence à une cellule de feuille de calcul contenant une structure de données Image valide. Par défaut, la cellule référencée est $A$0, et elle contient la structure de données Image renvoyée par la fonction .
Repère | Définit la région d’intérêt (ROI) par rapport à l’entrée d’un Fixture ou à la sortie du système de coordonnées de l’image d’une fonction Outils de vision. En définissant la ROI par rapport à un Repère, toute rotation ou translation de ce dernier entraînera systématiquement une rotation/translation de la ROI, le cas échéant.
X | L’offset en X (coordonnées de l’image).
Y | L’offset en Y (coordonnées de l’image).
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 x de la région.
Hauteur | La dimension le long de l’axe des y de la région.
Événement Extract | Cliquez ici pour extraire les points de calibrage de l’image.
Unités d’espacement de la grille | Indique l’unité de mesure réelle pour l’espacement de la grille de calibrage.
Microns = 0 | "µm"
Millimètres = 1 (par défaut) | "mm"
Centimètres = 2 | "cm"
Pouces = 3 | "in"
Espacement de la grille X | La mesure réelle de l’espacement de la grille de calibrage le long de l’axe X.
Espacement de la grille Y | La mesure réelle de l’espacement de la grille de calibrage le long de l’axe X.
Gamme d’écart angulaire | Sélectionnez cette option pour activer la Recherche de tolérances et limitez la gamme angulaire utilisée pour la recherche de la grille. (Valeur par défaut = 0, non coché) Astuce : Limiter la gamme angulaire permet d’accélérer l’extraction des points lorsque l’orientation relative entre la grille et la caméra est connue.
Recherche de tolérances | La gamme d’angles de début et de fin utilisée pour la recherche de grille.
Angle de départ | Angle minimum possible entre l’axe horizontal de la grille et l’axe horizontal de la caméra. (Min = -180, Max = 180, Par défaut = -180)
Angle de fin | Angle maximum possible entre l’axe horizontal de la grille et l’axe horizontal de la caméra. (Min = -180, Max = 180, Par défaut = +180)
Remarque : Par défaut, la gamme angulaire n’est pas restreinte. La case Gamme d’écart angulaire doit être cochée pour permettre de limiter les angles de début et de fin définis dans le paramètre Recherche de tolérances.
Délai d’attente | Indique la durée (en millisecondes) pendant laquelle la fonction ExtractCalibrationPoints s’exécute. L’exécution de la fonction s’arrête lorsque le délai d’attente est dépassé. (Minimum = 0, Maximum = 9999999, Par défaut = 120000) Remarque : Le délai d’attente est utilisé comme système de sécurité pour provoquer l’arrêt des traitements potentiellement très longs une fois cette durée dépassée. Le délai d’attente n’est pas précis, car l’exécution peut s’effectuer pendant quelques secondes au-delà de la durée spécifiée.
Afficher | Détermine le mode d’affichage des graphiques superposés de ExtractCalibrationPoints sur l’image.
0 = masquer tout (par défaut) | Tous les graphiques sont masqués, sauf lorsque la cellule contenant la ExtractCalibrationPointsfonction est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | Affiche les emplacements des points extraits superposés à l’image d’entrée.
2 = graphiques d’entrées et de résultats | Affiche les emplacements des points extraits et la région de recherche.

## ExtractCalibrationPoints – Sorties

Renvoie | Une structure de données CalibPoints, ou #ERR si l’un des paramètres d’entrée est incorrect. Les Vision Data Access functions Calibrate suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats.
Étiquette | Fonction | Description
Points | GetNFound() | Renvoie le nombre de points trouvés dans l’image de la grille de calibrage.