FC_CalculatePointOnCircle2D

 

FC_CalculatePointOnCircle2D - Allgemeine Informationen

Übersicht

Typ

Funktion

Verfügbar ab:

V1.0.3.0

Versionen:

Aktuelle Version

Aufgabe

Berechnung eines Punkts auf einem gegebenen Kreis, der einen vorgegebenen Richtungswinkel hat.

Beschreibung

Die Funktion berechnet die Koordinaten des Punkts auf dem Umfang des Kreises i_stCircle, der den Richtungswinkel i_lrAngle hat. Der Richtungswinkel wird in Grad gegen den Uhrzeigersinn gemessen. 0° entspricht der positiven X-Richtung (siehe Grafik unten).

G-SE-0068443.1.gif-high.gif

 

 

Schnittstelle

Eingang

Datentyp

Beschreibung

i_stCircle

ST_Circle2D

Kreis, auf dessen Umfang sich der zu berechnende Punkt befindet.

i_lrAngle

LREAL

Richtungswinkel des Punkts (in Grad, gegen den Uhrzeigersinn bezogen auf die positive X-Richtung)

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

Rückgabewert

Datentyp

Beschreibung

ST_Vector2D

Punkt auf dem Umfang des Kreises

Diagnosemeldungen

q_etDiag

q_etDiagExt

Enumerationswert

Beschreibung

OK

Ok

0

OK

InputParameterInvalid

RadiusRangeCircle

26

Der Radius des Kreises ist außerhalb des gültigen Bereichs.

Ok

Enumerationsname:

Ok

Enumerationswert:

0

Beschreibung:

OK

Die Schnittpunkte wurde erfolgreich berechnet.

RadiusRangeCircle

Enumerationsname:

RadiusRangeCircle

Enumerationswert:

26

Beschreibung:

Der Radius des Kreises ist außerhalb des gültigen Bereichs.

Problem

Ursache

Lösung

-

 Am Eingang i_stCircle.lrRadius wurde eine Zahl <= 0 übergeben.

Der Kreis muss einen Radius größer als null haben.