Prototyp und Beschreibung der Funktion setelev03datapath() (Funktion der freischaltpflichtigen Gruppe "Höhenberechnungen") |
setelev03datapath() Setzen des Datenpfads für das 3 Sek. Höhenmodell CGIAR. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall setelev03datapath( const char *pszDataPath); Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function setelev03datapath(; pszDataPath as psz); // 4 Byte, char* as logic pascal:geodll32.setelev03datapath // 4 Byte Die Funktion setzt den Datenpfad eines Verzeichnisses, in dem die Daten des 3 Sekunden Höhenmodells (90 m Raster) CGIAR abgelegt sind. Standardmäßig ist das Aufrufverzeichnis der die GeoDLL nutzenden Applikation oder das mit der Funktion setdllworkdir() festgelegte Verzeichnis eingestellt. Damit die Höhendaten in einem beliebigen Verzeichnis oder auf einem Netzwerkserver verwaltet werden können, kann GeoDLL der Verzeichnispfad mitgeteilt werden. Der Pfad darf einen Laufwerksbuchstaben und die Verzeichniskette mit oder ohne abschließenden Backslash enthalten. Beispiel: "c:\programm_hoehendaten\03_sec". Achtung, in C-Syntax müssen doppelte Backslashes verwendet werden! Ausführliche Beschreibungen der Höhenmodelle und Informationen zum kostenlosen Herunterladen der Höhendaten vom Internet finden Sie in der Dokumentation folgender Funktionen: CGIAR: Funktion getelevation03() GLOBE: Funktion getelevation30() Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben: pszDataPath Datenpfad zu den Dateien des 3 Sekunden Höhenmodells CGIAR. Der Pfad darf einen Laufwerksbuchstaben und die Verzeichniskette mit oder ohne einen abschließenden Backslash enthalten. Default: Aufrufverzeichnis des Programms oder mit setworkdirectoy() eingestelltes Verzeichnis. returnWert Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE. Freischaltung: Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe "Höhenberechnungen". 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. |