Prototyp und Beschreibung der Funktion distanceutm()

(Funktion der freischaltpflichtigen Gruppe "Entfernungsberechnungen")

distanceutm()
Entfernung auf dem Erdellipsoid in Metern zwischen zwei UTM-Koordinaten.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall distanceutm(
     double nUtmEast1,
     double nUtmNorth1,
     double nUtmEast2,
     double nUtmNorth2,
     double *nDistance,
     unsigned short nEllipsoid);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function distanceutm(;
     nUtmEast1 as real8,;                 // 8 Byte
     nUtmNorth1 as real8,;                // 8 Byte
     nUtmEast2 as real8,;                 // 8 Byte
     nUtmNorth2 as real8,;                // 8 Byte
     nDistance ref real8,;                // 4 Byte
     nEllipsoid as word);                 // 4 Byte
as logic pascal:geodll32.distanceutm      // 4 Byte


Die Funktion rechnet die Entfernung auf dem Erdellipsoid zwischen
zwei UTM-Koordinaten aus und gibt sie als Meterangabe zurück.

Es wird die Vincenty Inverse Formel zur Entfernungsberechnung auf dem
Erdellipsoid verwendet, die das Ergebnis mit hoher Genauigkeit berechnet.

Der Funktion müssen zwei UTM-Koordinatenpaare nUtmEast1 / nUtmNorth1 und
nUtmEast2 / nUtmNorth2 übergeben werden. Die Ost-Werte müssen die UTM-
Meridianstreifennummer enthalten. Die Koordinatenpaare dürfen auf dem
selben Meridianstreifen oder auf benachbarten Meridianstreifen liegen.
Sie müssen jedoch auf derselben Erdhalbkugel liegen.

In nEllipsoid wird das benötigte Ellipsoid übergeben. Wenn in nEllipsoid
der Wert 0 eingetragen ist, wird das WGS84-Ellipsoid zugrunde gelegt.
Wenn in nEllipsoid der Wert 1000 übergeben wird, benutzt die Funktion die
zuvor mit der Funktion setuserellsource() eingegebenen benutzerdefinierten
Halbachsen des Quellellipsoiden.

Das Ergebnis der Streckenberechnung wird in Metern im Parameter nDistance
von der Funktion zurückgegeben.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
nUtmEast1   UTM-Rechtswert des ersten Punktes.

nUtmNorth1  UTM-Hochwert des ersten Punktes.

nUtmEast2   UTM-Rechtswert des zweiten Punktes.

nUtmNorth2  UTM-Hochwert des zweiten Punktes.

nDistance   Distanz zwischen den Punkten in Meter als Ergebnis der
(ref)       Berechnung

nEllipsoid  Geodätisches Ellipsoid.
            Die Ellipsoide sind im unteren Bereich der Liste
            "Systeme alphabetisch sortiert" aufgeführt. Es können auch
            die Nummern der in der Liste "Systeme nach Ländern sortiert"
            aufgeführten Bezugssysteme verwendet werden.

returnWert  Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE.


Freischaltung:
Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe
"Entfernungsberechnungen". Sie wird zusammen mit den anderen Funktionen
der Gruppe durch die Eingabe der bei der Vertriebsfirma erworbenen
Freischaltparameter per Aufruf der Funktion setunlockcode() zur
uneingeschränkten Nutzung frei geschaltet. Ohne die Freischaltung sind nur
wenige Funktionsaufrufe zu Testzwecken (Sharewareprinzip) möglich.