Prototype and description of the function setelev03datapath()

(Function of the unlock requiring group "Elevation calculations")

 

setelev03datapath()
Sets the data path for the 3 sec. elevation model CGIAR.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall setelev03datapath(
     const char *pszDataPath);

Prototype of the DLL function in Visual Objects syntax:
_DLL function setelev03datapath(;
     pszDataPath as psz);                   // 4 Byte, char*
as logic pascal:geodll32.setelev03datapath  // 4 Byte


The function sets the data path to a directory, in which the data of the
3 seconds elevation model (90 m raster) CGIAR are stored.

As default the directory of the application using the GeoDLL functions or the
directory set with the function setdllworkdir() is pre defined. If the
elevation data are administrated in any directory or on a network server,
GeoDLL must be informed about the path to the data directory. The path may
contain a drive letter and the directory path with or without a pending
backslash.
Example: "c:\program_elevation\03_sec".
Attention, in C syntax double backslashes must be used!

Detailed descriptions of the elevation models and information for free
downloading of the elevation data from the Internet you find in the
documentation of the following functions:
CGIAR:  Function getelevation03()
GLOBE:  Function getelevation30()


The parameters are passed and/or returned as follows:
pszDataPath Path to the files of the 3 seconds elevation model CGIAR. The
            path may contain a drive letter and the directory path with or
            without a pending backslash.
            Default: Application path or with the function setdllworkdir().

returnVal   In case of an error the function returns FALSE, otherwise TRUE.


Unlocking:
This function is a component of the unlock requiring function group
"Elevation calculations". It is unlocked for unrestricted use together with
the other functions of the group by passing the unlock parameters, acquired
from the software distribution company, trough the function setunlockcode().
Without unlocking only a few function calls for test purposes (shareware
principle) are possible.