Prototyp und Beschreibung der Funktion getcoordfixref() (Funktion der freischaltpflichtigen Gruppe " Parameterermittlung") |
getcoordfixref() Feststellen ob ein Koordinatensystem ein fest zugeordnetes Bezugssystem hat. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall getcoordfixref( unsigned short wCoordSys, unsigned long *lIsFixed); Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function getcoordfixref(; wCoordSys as word,; // 2 Byte lIsFixed ref logic); // 4 Byte as logic pascal:geodll32.getcoordfixref // 4 Byte Die Funktion ermittelt, ob das in wCoordSys übergebene Koordinatensystem ein fest zugeordnetes Bezugssystem hat und gibt den Status im Parameter lIsFixed zurück. Fest zugeordnete Bezugssysteme sind zum Beispiel bei den deutschen "Lagestatus"-Systemen oder bei den Google Weltkoordinaten-Systemen üblich. Das für das Koordinatensystem fest eingestellte Bezugssystem kann durch Abfrage des voreingestellten Standard-Bezugssystems mit der Funktion getcoordstdrefsys() ermittelt werden. GeoDLL verwendet das fest eingestellte Bezugssystem nicht automatisch. Auch wenn das Flag lIsFixed gesetzt ist, können beliebige Bezugssysteme in den Funktionen coordtrans???() eingestellt werden. Durch Abfrage des Status "Fest zugeordnetes Bezugssystem" mit der Funktion getcoordfixref() kann das aufrufende Programm aber reagieren. So kann das Programm beispielsweise nur das mit der Funktion getcoordstdrefsys() zu ermittelnde Standard- Bezugssystem zulassen. Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben: wCoordSys Koordinatensystem, für das der Status eines fest zugeordneten Bezugssystems ermittelt werden soll. Die verfügbaren Koordinatensysteme sind in der Liste "Koordinatenbezugssysteme" aufgeführt. lIsFixed Status "Fest zugeordnetes Bezugssystem". Der Status wird per (ref) Referenz zurückgegeben. TRUE Das Koordinatensystem hat ein fest zugeordnetes Bezugssystem. FALSE Das Koordinatensystem hat kein fest zugeordnetes Bezugssystem. 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 nur wenige Funktionsaufrufe zu Testzwecken (Sharewareprinzip) möglich. |