Funktion getcoordarea()

Prototyp und Beschreibung der Funktion getcoordarea()

(Funktion der freischaltpflichtigen Gruppe " Parameterermittlung")

 

getcoordarea()
Ermittlung des gültigen Bereichs eines Koordinatensystems.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall getcoordarea(
     unsigned short wCoordSys,
     short *iLonMin,
     short *iLonMax,
     short *iLatMin,
     short *iLatMax);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function getcoordarea(;
     wCoordSys as word,;                   // 2 Byte
     iLonMin ref short,;                   // 4 Byte
     iLonMax ref short,;                   // 4 Byte
     iLatMin ref short,;                   // 4 Byte
     iLatMax ref short);                   // 4 Byte
as logic pascal:geodll32.getcoordarea      // 4 Byte


Die Funktion gibt den für das in wCoordSys übergebene Koordinatensystem
gültigen Bereich als Gradangaben an das rufende Programm zurück.

Die Bereichsprüfung bei Koordinatentransformationen kann mithilfe der
Funktion setcoordarea() ein- oder ausgeschaltet werden.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
wCoordSys   Koordinatensystem, für das der gültige Bereich ermittelt
            werden sollen. Die verfügbaren Koordinatensysteme sind
            in der Liste "Koordinatenbezugssysteme" aufgeführt.

iLonMin     Die kleinstmögliche geographische Länge für das
(ref)       Koordinatensystem in Grad.

iLonMax     Die größtmögliche geographische Länge für das
(ref)       Koordinatensystem in Grad.

iLatMin     Die kleinstmögliche geographische Breite für das
(ref)       Koordinatensystem in Grad.

iLatMax     Die größtmögliche geographische Breite für das
(ref)       Koordinatensystem in Grad.

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


Freischaltung:
Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe
"Parameterermittlung". 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
keine Funktionsaufrufe möglich.