# FindMultiLine

Recherche plusieurs bords rectilignes dans une région d’image. FindMultiLine forme une projection unidimensionnelle de la région de l’image en additionnant les valeurs des pixels sur les segments radiaux balayés le sens des ordonnées positives par rapport au système de coordonnées locales de la région. Les transitions sont extraites à partir de l’image projetée.

## FindMultiLine – 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.
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 | 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.
Angle | Orientation du repère.
Courbure | Écart angulaire entre l’axe X de la région et la ligne de la limite opposée.
Remarque : Les paramètres Repère et Région doivent être ajustés en fonction des limites de l’image. S’ils sont hors limites, la fonction renvoie #ERR.
Nombre à chercher | Détermine le nombre maximum de bords que la fonction renvoie (1 à la largeur de l’image du capteur, moins 1 ; par défaut = 3). Le nombre maximum de bords détectables est inférieur d’une unité à la largeur d’image de la caméra In-Sight capturant l’image (par exemple, le maximum d’une caméra ISC 8402 est 1599, soit une unité de moins que la résolution d’image 1600×1200 du système de vision).
Seuil noir/blanc | Détermine le contraste minimum de transition noir/blanc acceptable (0 à 100 ; 25 par défaut). FindMultiLine rejette tous les bords noir/blanc dont le score est inférieur à Seuil noir/blanc. Le Contraste de la transition est imposé par l’histogramme des niveaux de gris de la région balayée.
Seuil blanc/noir | Détermine le contraste minimum de bord blanc/noir acceptable (0 à 100 ; par défaut = 25). FindMultiLine rejette tous les bords blanc/noir dont le score est inférieur à Seuil blanc/noir. Le Contraste de la transition est imposé par l’histogramme des niveaux de gris de la région balayée.
Normalisation du score | Indique si les scores des bords seront normalisés par rapport à l’histogramme des niveaux de gris de la région. Lorsque l’option Normalisation du score est activée, les scores bruts de bords sont normalisés par le contraste maximal trouvé dans la région de l’image à l’aide de la formule suivante : Score = (score brut de bord) x (100/contraste maximum) Le score brut du bord est la différence de niveau de gris au niveau du bord, tandis que le contraste maximum correspond à la différence entre le niveau de gris maximum et minimum (0 à 255) dans la région de l’image. Lorsque l’option Normalisation du score est désactivée, les bords à faible contraste obtiennent un score inférieur à celui des bords à fort contraste. La formule suivante est utilisée : Score = (score brut de bord) x (100/255)
0 = OFF | Ne normalise pas le score.
1 = ON (par défaut) | Normalise le score.
Remarque : Conseil : Ce paramètre permet de rechercher les bords dans des régions à faible contraste. Désactivez ce paramètre si vous êtes certains que les bords à détecter présentent un contraste élevé.
Chercher par | Indique la technique de sélection de bords utilisée par la fonction pour sélectionner un bord parmi plusieurs candidats.
0 = meilleur score (par défaut) | Indique que le bord avec le score le plus élevé est priorisé.
1 = premier bord | Indique que le premier bord détecté est priorisé.
2 = dernier bord | Indique que le dernier bord détecté est priorisé.
Gamme d’écart angulaire | Détermine la tolérance de la fonction par rapport à la rotation du bord (0 à 10 ; 0 par défaut). Cette fonction trouve les bords en dehors de la tolérance indiquée, mais sa précision peut être plus faible. Remarque : Définir une valeur supérieure à 0 pour ce paramètre réduit la vitesse de la fonction.
Largeur des bords | Détermine la distance de pixels (1 à 50 ; 3 par défaut) au delà de laquelle on est en présence d’une transition. La Largeur des transitions est utilisée pour filtrer l’image avant l’extraction des transitions.
Afficher | Détermine le mode d’affichage des graphiques superposés de FindMultiLine sur l’image.
0 = masquer tout (par défaut) | Tous les graphiques sont masqués, sauf si la cellule contenant la fonction FindMultiLine est la cellule active dans la feuille de calcul.
1 = graphiques de résultats uniquement | Les bords rectilignes trouvés sont toujours affichés.
2 = graphiques d’entrées et de résultats | La région d’image d’entrée et les bords rectilignes trouvés sont toujours affichés.
3 = afficher tout : entrée, résultat et graphique | La région d’image d’entrée, les bords rectilignes trouvés et le graphique de résultat de bord sont toujours affichés. Remarque : Le graphique de résultat de bord est une fenêtre ancrable. Pour plus d’informations, consultez la rubrique Éditeur de feuille de calcul – Graphiques.

## FindMultiLine – Sorties

Renvoie | Une structure de données Edge contenant plusieurs segments de bord rectilignes, ou #ERR si l’un des paramètres d’entrée est incorrect.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction FindMultiLine est insérée dans une cellule pour la première fois. Une des Vision Data Access functions Edges est automatiquement insérée dans la feuille de calcul pour créer le tableau de résultats :
Label | Fonction | Description
--- | --- | ---
NFound | GetNFound(Edges) | NFound est le nombre de bords trouvés.
Il est possible d’accéder à d’autres éléments avec les Vision Data Access functions Edges.