FC_DistancePointFromPlane

 

FC_DistancePointFromPlane - Allgemeine Informationen

Übersicht

Typ

Funktion

Verfügbar ab:

V1.0.3.0

Versionen:

Aktuelle Version

Aufgabe

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

Beschreibung

Berechnet den Abstand des Punkts i_stPoint von der Ebene i_stPlane. Der berechnete Abstand ist vorzeichenbehaftet. Das Vorzeichen gibt an, in welchem der durch die Ebene i_stPlane definierten Halbräume der Punkt i_stPoint liegt. Zusätzlich wird das Lot des Punkts auf die Ebene berechnet.

Schnittstelle

Eingang

Datentyp

Beschreibung

i_stPoint

ST_Vector3D

Punkt

i_stPlane

ST_Plane

Ebene

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 Ebene i_stPlane.

q_lrParameter1

LREAL

Erster Parameter des Lots q_stPerpendicular in der allgemeinen Parameterdarstellung der Ebene i_stPlane (siehe ST_Plane).

q_lrParameter2

LREAL

Zweiter Parameter des Lots q_stPerpendicular in der allgemeinen Parameterdarstellung der Ebene i_stPlane (siehe ST_Plane).

q_stPerpendicular

ST_Vector3D

Lot des Punkts i_stPoint auf die Ebene i_stPlane.

Diagnosemeldungen

q_etDiag

q_etDiagExt

Enumerationswert

Beschreibung

OK

Ok

0

OK

InputParameterInvalid

DefinitionPlane

45

Die Definition von Plane ist nicht korrekt.

DefinitionPlane

Enumerationsname:

DefinitionPlane

Enumerationswert:

45

Beschreibung:

Die Definition von Plane ist nicht korrekt.

Problem

Ursache

Lösung

-

Am Eingang i_stPlane.stSpanPoint1 und i_stPlane.stBasePoint wurde der gleiche Punkt übergeben.

Der Abstand zwischen i_stPlane.stSpanPoint1 und i_stPlane.stBasePoint muss mindestens Gc_lrZeroTolerance betragen.

-

Am Eingang i_stPlane.stSpanPoint2 und i_stPlane.stBasePoint wurde der gleiche Punkt übergeben.

Der Abstand zwischen i_stPlane.stSpanPoint2 und i_stPlane.stBasePoint muss mindestens Gc_lrZeroTolerance betragen.

-

Die Punkte i_stPlane.stSpanPoint1, i_stPlane.stSpanPoint2 und i_stPlane.stBasePoint liegen auf einer Geraden.

Die Punkte i_stPlane.stSpanPoint1, i_stPlane.stSpanPoint2 und i_stPlane.stBasePoint dürfen nicht auf einer gemeinsamen Geraden liegen.

Ok

Enumerationsname:

Ok

Enumerationswert:

0

Beschreibung:

OK

Der Abstand wurde erfolgreich berechnet.