Prototype and description of the function getcoordarea()

(Function of the unlock requiring group "Parameter determination")

 

getcoordarea()
Determination of the the valid range of a Coordinate System.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall getcoordarea(
     unsigned short wCoordSys,
     short *iLonMin,
     short *iLonMax,
     short *iLatMin,
     short *iLatMax);

Prototype of the DLL function 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


The function returns the valid range of a Coordinate System fitting to
wCoordSys as degrees data to the calling program.

The range check with Coordinate Transformations can be switched on or off
by the function setcoordarea().


The parameters are passed and/or returned as follows:
wCoordSys   Coordinate System, for which the valid range is to be
            determined. The available Coordinate Systems are specified in
            the list "Coordinate Reference Systems".

iLonMin     The smallest possible geographical longitude for the
(ref)       Coordinate System in degrees.

iLonMax     The largest possible geographical longitude for the
(ref)       Coordinate System in degrees.

iLatMin     The smallest possible geographical latitude for the
(ref)       Coordinate System in degrees.

iLatMax     The largest possible geographical latitude for the
(ref)       Coordinate System in degrees.

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


Unlocking
This function is a component of the unlock requiring function group
"parameter determination". 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.