GEOarcFrom2PointsAndRadius

Berechnung von Mittelpunkt, Anfangs- und Endwinkel eines Kreisbogens.

Diese Funktion berechnet aus dem Anfangs-, Endpunkt und dem Radius eines Kreisbogens sowie einem Indikatorflag seinen Mittelpunkt und den Anfangs- und Endwinkel. Der Kreisbogen verläuft vom Anfangs- zum Endpunkt im mathematisch positiven Sinne (gegen den Uhrzeigersinn).

Parameter

xa (DOUBLE)                                              [IN]

ya (DOUBLE)                                              [IN]

Anfangspunkt des Kreisbogens

xe (DOUBLE)                                              [IN]

ye (DOUBLE)                                              [IN]

Endpunkt des Kreisbogens

r (DOUBLE)                                                 [IN]

Radius des Kreisbogens

flag (DOUBLE)                                            [IN]

Indikator ob der kleinere der zwei möglichen Kreisbögen (flag=-1) oder der größere (flag=1) berechnet werden soll.

xc (DOUBLE *)                                        [OUT]

Berechnete x-Koordinate des Kreismittelpunktes.

yc (DOUBLE *)                                        [OUT]

Berechnete y-Koordinate des Kreismittelpunktes.

alpha (DOUBLE *)                                  [OUT]

Berechneter Startwinkel in Radiant, Wertebereich 0 bis 2 Pi.

beta (DOUBLE *)                                    [OUT]

Berechneter Endwinkel in Radiant, Wertebereich 0 bis 2 Pi.

Ergebnis

(int)                                                           [OUT]

0 – OK            : erfolgreiche Berechnung

-1 – Fehler : Berechnung nicht möglich.

Deklaration

#include "basic.h2

int DLLENTRY GEOarcFrom2PointsAndRadius (

     DOUBLE      xa,

     DOUBLE      ya,

     DOUBLE      xe,

     DOUBLE      ye,

     DOUBLE      r ,

     DOUBLE      flag,

     DOUBLE * xc,

     DOUBLE * yc,

     DOUBLE * alpha,

     DOUBLE * beta

);

Beispiel

status = GEOarcFrom2PointsAndRadius (-200.0, 100.0, 100.0, 400.0, 300.0, 1, &xc, &yc, &alpha, &beta);

Die Variable status erhält den Wert 0, d.h. die Berechnung konnte durchgeführt werden. Der Mittelpunkt liegt bei (100/100) der Anfangswinkel (alpha ) hat den Wert Pi, der Endwinkel (beta ) hat den Wert Pi/2.

status = GEOarcFrom2PointsAndRadius (-200.0, 100.0, 100.0, 400.0, 300.0, -1, &xc, &yc, &alpha, &beta)

Die Variable status erhält den Wert 0, d.h. die Berechnung konnte durchgeführt werden. Der Mittelpunkt liegt bei (-200/400) der Anfangswinkel (alpha ) hat den Wert 3Pi/2, der Endwinkel (beta ) hat den Wert 0.