Prototype and description of the function setcoordarea()

(This function needs no unlocking)

 

setcoordarea()
Switching of the syntax check and range validity for the source and target
coordinates.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall setcoordarea(
     unsigned long lSwitch);

Prototype of the DLL function in Visual Objects syntax:
_DLL function setcoordarea(;
     lSwitch as logic);                    // 4 Byte
as logic pascal:geodll32.setcoordarea      // 4 Byte


The function switches the syntax check and range validity for the source
and target coordinates on or off. If in lSwitch TRUE is passed, the
syntax check and range validity are done with the calls of the functions
coordtrans?(), meritrans(), distance?() and point2point?(). Passing the
value FALSE switches the syntax check and range validity off.

The range limitations valid for a Coordinate System can be determined with
the function getcoordarea().

The range limitations of the source and target Coordinate Systems are
specified in the list "Defaults of the Coordinate Systems".

The following syntax examinations are accomplished:
Geographic coordinates [deg, min, sec]:
     Minute and second portion ‹ 60
Geographic coordinates [deg, min]:
     Minute portion ‹ 60
GEOREF-Code (Aircraft Navigation):
     Sequence and validity of the characters AAAAnnnn
QTH-Code (Maidenhead):
     Sequence and validity of the characters nnAAnnAAnn
UTMref:
     Sequence and validity of the characters nnAAAnnnnnnnnnn
British National grid:
     Sequence and validity of the characters AAnnnnnnnnnn
Irish National grid
     Sequence and validity of the characters AAnnnnnnnnnn

If the range validity results is below or above of the ranges set for the
respective Coordinate Systems or if a syntax error occurs, the called function
[coordtrans?(), meritrans(), distance?() or point2point?()] breaks off
with the return value FALSE. The description of the range injury can be queried
by a call to the function geterrorcode().


The parameters are passed and/or returned as follows:
lSwitch     Switch for the syntax check and range validity
TRUE        syntax check and range validity on
FALSE       syntax check and range validity off
              (default)

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


Unlocking
This function is a component of the unlock requiring function groups
"Coordinate Transformations", "distance calculations" and "notation
calculations". It is unlocked for unrestricted use together with the
other functions of these groups 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.