FC_DistancePointFromLine2D - Allgemeine Informationen
Typ |
Funktion |
Verfügbar ab: |
V1.0.3.0 |
Versionen: |
Aktuelle Version |
Berechnung des Abstands eines Punkts von einer Geraden im 2-dimensionalen Raum.
Berechnet den Abstand des Punkts i_stPoint von der Geraden i_stLine. Der berechnete Abstand ist vorzeichenbehaftet. Das Vorzeichen gibt an, in welcher der durch die Geradei_stLine definierten Halbebenen der Punkt i_stPoint liegt. Zusätzlich wird das Lot des Punkts auf die Gerade berechnet.
Eingang |
Datentyp |
Beschreibung |
---|---|---|
i_stPoint |
Punkt |
|
i_stLine |
Gerade |
Ausgang |
Datentyp |
Beschreibung |
---|---|---|
q_etDiag |
Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung. |
|
q_etDiagExt |
POU-spezifischer, diagnosebezogener Ausgang. q_etDiag = ET_Diag.Ok -> Statusmeldung q_etDiag <> ET_Diag.Ok -> Diagnosemeldung |
|
q_lrDistance |
LREAL |
Berechneter Abstand des Punkts i_stPoint von der Geraden i_stLine. |
q_lrParameter |
LREAL |
Parameter des Lots des Punkts i_stPoint auf die Gerade i_stLine in der allgemeinen Parameterdarstellung von i_stLine (siehe ST_Line2D). |
q_stPerpendicular |
Lot des Punkts i_stPoint auf die Gerade i_stLine. |
q_etDiag |
q_etDiagExt |
Enumerationswert |
Beschreibung |
---|---|---|---|
OK |
0 |
OK |
|
InputParameterInvalid |
31 |
Die Definition von Line ist nicht korrekt. |
Enumerationsname: |
DefinitionLine |
Enumerationswert: |
31 |
Beschreibung: |
Die Definition von Line ist nicht korrekt. |
Problem |
Ursache |
Lösung |
---|---|---|
- |
Am Eingang i_stLine.stPoint1 und i_stLine.stPoint2 wurde der gleiche Punkt übergeben. |
Die Punkte stPoint1 und stPoint2, mit denen die Gerade i_stLine definiert wird, müssen mindestens Gc_lrZeroTolerance voneinander entfernt sein. |
Enumerationsname: |
Ok |
Enumerationswert: |
0 |
Beschreibung: |
OK |
Der Abstand wurde erfolgreich berechnet.