# ComputeImageSharpness

Cette fonction permet de calculer une mesure de la netteté relative d’une image d’entrée, dans le cadre d’un processus itératif pour refaire la mise au point de l’objectif d’une caméra In-Sight.

## ComputeImageSharpness – Présentation

Le score de netteté de l’image indique le degré auquel l’image, ou la région d’intérêt (ROI) inclut les caractéristiques les plus petites pouvant être discernées dans une « scène » (c’est-à-dire l’objet et son arrière-plan, tels qu’ils ont été acquis dans l’image).

Son fonctionnement est simple : après avoir acquis une image, l’outil ComputeImageSharpness est utilisé pour obtenir le score de netteté de l’image. Ensuite, l’objectif fait l’objet d’une nouvelle mise au point. Rien d’autre n’est modifié dans la scène et une nouvelle image est acquise et notée. Plus le score est élevé, plus la mise au point est nette. Ce processus est répété jusqu’à ce que la mise au point soit considérée comme acceptable par l’utilisateur.

Remarque : Un seul score de netteté d’image ne donne aucune information utile sur la netteté absolue d’une image : il est nécessaire de le comparer à un autre score de netteté de l’image issu de la même scène. Les scènes doivent être identiques.

## ComputeImageSharpness – Entrées

Paramètre | Description
Image | Ce paramètre doit utiliser les Références à des cellules de la 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 de l’outil de vision.
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. Le paramètre par défaut est (0,0,0), le coin supérieur gauche de l’image.
X | L’offset en X (coordonnées de l’image).
Y | L’offset en Y (coordonnées de l’image).
Thêta | La rotation par rapport à l’axe X de l’image, dans le système de coordonnées de l’image (+/-360 degrés dans le sens horaire).
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 | Dimension de l’axe X de la région.
Hauteur | Dimension de l’axe Y de la région.
Angle | Orientation du repère.
Courbure | Angle entre les côtés, +/- 360 degrés dans le sens horaire
Opération | Énergie du gradient : Calcule la netteté de l’image en fonction de l’énergie du gradient local de niveaux de gris de l’image ou de la ROI. Le gradient local de niveaux de gris correspond à la variation des niveaux de gris pour une zone donnée. Une variation brusque des niveaux de gris se traduit par une grande magnitude du gradient de niveaux de gris et un score de netteté de l’image plus élevé.
Lissé | Définit une opération de lissage de l’image pour aider à éliminer le bruit de haute fréquence pouvant être présent dans la ROI. Trois réglages sont disponibles :
0 = aucun (par défaut) | Aucun lissage n’a lieu, performances optimales.
1 = lissage de niveau 1 | Un degré de lissage est appliqué à la ROI, éliminant le bruit de très haute fréquence dans celle-ci.
2 = lissage de niveau 2 | Un nouveau degré de lissage est appliqué à la ROI, éliminant le bruit de haute fréquence et très haute fréquence dans celle-ci.
Afficher | Indique les graphiques superposés visibles sur l’image.
0 = masquer tout (par défaut) | Les éléments graphiques disponibles sont masqués, sauf si la cellule contenant la fonction ComputeImageSharpness est en surbrillance dans la feuille de calcul.
1 = graphiques d’entrée uniquement | Les éléments graphiques associés à la région d’image d’entrée sont toujours affichés.

## ComputeImageSharpness – Sorties

Renvoie | Un score de netteté de l’image, sous la forme d’une valeur à virgule flottante, ou #ERR si l’un des paramètres d’entrée n’est pas valide.