# PointToLine

Berechnet den minimalen Abstand zwischen einem Punkt und einer Geraden.

Beispiel

In diesem Beispiel misst die PointToLine-Funktion den Abstand zwischen einem Punkt und einer Geraden. Der Punkt ist der Ursprung, und der Winkel wird anhand seiner relativen Position zur Geraden berechnet.

## PointToLine – Eingaben

Parameter | Beschreibung
Punkt | Gibt die Koordinaten des Punkts an, der als Ursprung verwendet werden soll.
X | Die x-Koordinate des Punkts.
Y | Die y-Koordinate des Punkts.
Linie | Definiert die Koordinaten der Geraden.
X 0 | Die x-Koordinate des ersten Punkts der Geraden.
Y 0 | Die y-Koordinate des ersten Punkts der Geraden.
X 1 | Die x-Koordinate des zweiten Punkts der Geraden.
Y 1 | Die y-Koordinate des zweiten Punkts der Geraden.
Anzeigen | Legt den Anzeigemodus für die Überlagerung von Grafiken auf dem Bild fest.
0 = Nichts | Alle Grafiken werden nur angezeigt, wenn die Zelle mit der Funktion in der Tabelle markiert ist.
1 = Nur Ergebnis-Grafik | Eine Strecke mit dem minimalen Abstand zwischen dem Punkt und der Eingangsgeraden wird immer angezeigt.
2 = Eingabe- und Ergebnis-Grafik | Der Punkt und die Eingangsgerade und die Strecke zwischen den beiden werden immer angezeigt.

## PointToLine – Ausgaben

Rückgabewert | Eine Dist-Datenstruktur, die den gerichteten Abstand zwischen dem Punkt und dem nächstgelegenen Punkt auf der Linie enthält.
Ergebnisse | Wenn die Funktion erstmals in eine Zelle eingefügt wird, wird in der Tabelle eine Ergebnistabelle erstellt.

## PointToLine – Vision-Datenzugriffsfunktionen

Die folgenden Dist Vision Data Access functions werden zum Erstellen der Ergebnistabelle automatisch in die Tabelle eingefügt.

Label | Funktion | Beschreibung
--- | --- | ---
X0 | GetX(Abstand, 0) | Die x-Koordinate des Punkts.
Y0 | GetY(Abstand, 0) | Die y-Koordinate des Punkts.
X1 | GetX(Abstand, 1) | Die x-Koordinate des nächstgelegenen Punkts auf der Geraden.
Y1 | GetY(Abstand, 1) | Die y-Koordinate des nächstgelegenen Punkts auf der Geraden.
Winkel | GetAngle(Abstand) | Der Winkel zwischen dem Punkt und der Geraden.
Abstand | GetDistance(Abstand) | Der Abstand zwischen dem Punkt und der Geraden.