Prototype and description of the function setcalcextra()

(This function needs no unlocking)

 

setcalcextra()
Switching the calculation of extra parameters during coordinate
transformations.

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

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


Additional (extra) parameters can be calculated during the execution of
coordinate transformations. Because the permanent calculation of the
additional parameters would slightly reduce the execution speed of GeoDLL,
these calculations can be switched on and off. The additional parameters
can be called by the function coordcalcextra(). For more information, see
the description of the function coordcalcextra().

The following extra parameters are available:
   Longitude of the Geographical Point coordinate in the source system.
   Latitude of the Geographical Point coordinate in the source system.
   Longitude of Origin Center in the source System.
   Meridian Convergence at the Geographical Point in the source system.
   Longitude of the Geographical Point coordinate in the target system.
   Latitude of the Geographical Point coordinate in the target system.
   Longitude of Origin Center in the target System.
   Meridian Convergence at the Geographical Point in the target system.

If the value TRUE is passed in lSwitch, the calculation of the additional
parameters is performed during all coordinate transformations.

If the value FALSE is passed in lSwitch, the calculation of the additional
parameters during the coordinate transformation is blocked.


The parameters are passed and/or returned as follows:
lSwitch       Switch for the calculation of additional parameters.
TRUE          Calculation on.
FALSE         Calculation off.
              (default)

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


Unlocking:
This function needs no unlocking.