FC_DistancePointFromLine3D

 

FC_DistancePointFromLine3D - Allgemeine Informationen

Übersicht

Typ

Funktion

Verfügbar ab:

V1.0.3.0

Versionen:

Aktuelle Version

Aufgabe

Berechnung des Abstands eines Punkts von einer Geraden im 3-dimensionalen Raum.

Beschreibung

Berechnet den Abstand des Punkts i_stPoint von der Geraden i_stLine. Zusätzlich wird das Lot des Punkts auf die Gerade berechnet.

Schnittstelle

Eingang

Datentyp

Beschreibung

i_stPoint

ST_Vector3D

Punkt

i_stLine

ST_Line3D

Gerade

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

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 iq_stPerpendicular in der allgemeinen Parameterdarstellung der Geraden i_stLine (siehe ST_Line3D).

q_stPerpendicular

ST_Vector3D

Lot des Punkts i_stPoint auf die Gerade i_stLine.

Diagnosemeldungen

q_etDiag

q_etDiagExt

Enumerationswert

Beschreibung

OK

Ok

0

OK

InputParameterInvalid

DefinitionLine

31

Die Definition von Line ist nicht korrekt.

DefinitionLine

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.

Ok

Enumerationsname:

Ok

Enumerationswert:

0

Beschreibung:

OK

Der Abstand wurde erfolgreich berechnet.