FC_DistanceTwoLines3D

FC_DistanceTwoLines3D - Allgemeine Informationen

Übersicht

Typ	Funktion
Verfügbar ab:	V1.0.3.0
Versionen:	Aktuelle Version

Aufgabe

Berechnung des Abstands zweier Geraden im 3-dimensionalen Raum.

Beschreibung

Berechnet den Abstand der Geraden i_stLine1 und i_stLine2 im 3-dimensionalen Raum. Zusätzlich wird für beide Geraden der Fußpunkt des gemeinsamen Lots berechnet.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_stLine1	ST_Line3D	Gerade 1
i_stLine2	ST_Line3D	Gerade 2

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 zwischen den Geraden i_stLine1 und i_stLine2.
q_lrParameterLine1	LREAL	Parameter des Punkts q_stPerpendicularLine1 in der allgemeinen Parameterdarstellung der Geraden i_stLine1 (siehe ST_Line3D).
q_stPerpendicularLine1	ST_Vector3D	Fußpunkt des gemeinsamen Lots der beiden Geraden auf der Geraden 1.
q_lrParameterLine2	LREAL	Parameter des Punkte q_stPerpendicularLine2 in der allgemeinen Parameterdarstellung der Geraden i_stLine2 (siehe ST_Line3D).
q_stPerpendicularLine2	ST_Vector3D	Fußpunkt des gemeinsamen Lots der beiden Geraden auf der Geraden 2.

Diagnosemeldungen

q_etDiag	q_etDiagExt	Enumerationswert	Beschreibung
OK	Ok	0	OK
InputParameterInvalid	DefinitionLine1	32	Die Definition von Line1 ist nicht korrekt.
InputParameterInvalid	DefinitionLine2	33	Die Definition von Line2 ist nicht korrekt.

DefinitionLine1

Enumerationsname:	DefinitionLine1
Enumerationswert:	32
Beschreibung:	Die Definition von Line1 ist nicht korrekt.

Problem	Ursache	Lösung
-	Am Eingang i_stLine1.stPoint1 und i_stLine1.stPoint2 wurde der gleiche Punkt übergeben.	Die Punkte stPoint1 und stPoint2, mit denen die Gerade i_stLine1 definiert wird, müssen mindestens Gc_lrZeroTolerance voneinander entfernt sein.

DefinitionLine2

Enumerationsname:	DefinitionLine2
Enumerationswert:	33
Beschreibung:	Die Definition von Line2 ist nicht korrekt.

Problem	Ursache	Lösung
-	Am Eingang i_stLine2.stPoint1 und i_stLine2.stPoint2 wurde der gleiche Punkt übergeben.	Die Punkte stPoint1 und stPoint2, mit denen die Gerade i_stLine2 definiert wird, müssen mindestens Gc_lrZeroTolerance voneinander entfernt sein.

Enumerationsname:	Ok
Enumerationswert:	0
Beschreibung:	OK

Der Abstand wurde erfolgreich berechnet.