GEOarcTan

Berechnung der Steigung einer Linie.

Mit dieser Funktion wird die Steigung einer Linie, welche im Punkt (x1,y1) beginnt und im Punkt (x2,y2) endet, berechnet. Die Angabe der Steigung erfolgt im Bogenmaß. Beide Punkte dürfen nicht identisch sein.

Parameter

x1 (double)                                                  [IN]

y1 (double)                                                  [IN]

Startpunkt der Linie

x2 (double)                                                  [IN]

y2 (double)                                                  [IN]

Endpunkt der Linie

grad (double *)                                 [(IN)/OUT]

Berechnete Steigung. Die Angabe ist in Bogenmaß, d.h. 2π ist ein Vollkreis.

Ergebnis

int                                                               OUT

0     OK   : Steigung berechnet.

1     Fehler: Punkte sind identisch. Steigung nicht berechnet.

Deklaration

#include "basic.h"

double DLLENTRY  GEOarcTan (

     double      x1,

     double      y1,

     double      x2,

     double      y2,

     double * grad

);

Beispiel

status = GEOarcTan (100.0, 100.0, 300.0, 200.0, &grad)

Die Variable status erhält den Wert 0, d.h. die Berechnung wurde vollzogen. Die Steigung (grad ) hat den Wert 0.52 (p/6 = 30o ).

status = GEOarcTan (100.0, 100.0, 100.0, 100.0, &grad)

Die Variable status erhält den Wert 1, d.h. die Berechnung konnte nicht durchgeführt werden, da beide Punkte identisch sind.