Prototype and description of the function umfd2g()

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

 

umfd2g()
Converting of a geographic coordinate in [degrees] notation to the
[deg, min, sec] notation.

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

Prototype of the DLL function in Visual Objects syntax:
_DLL function umfd2g(;
     nGeoCoord ref real8);                 // 4 Byte
as logic pascal:geodll32.umfd2g            // 4 Byte


The function transforms a geographic coordinate in [degrees] notation
(ggg.nnn) to a geographic coordinate in [deg, min, sec] notation
(gggmmss.nnn).


The parameters are passed and/or returned as follows:
nGeoCoord   Geographic coordinate (longitude or latitude) by reference.
(ref)       The original coordinate is overwritten with the result of the
            calculation.

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


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