• BetaDLL - NTv2 datum shift with BeTA2007
•  Brief Description of the Current Version
•  Development Tool Description
•  Specification Function coordtransbeta() as example
•  NTv2 Support with BetaDLL
•  Screenshots
•  Download BetaDLL test version
•  Prices BetaDLL full version
•  Order BetaDLL full version

BetaDLL - Description of the function coordtransbeta()
An example for a function description from the user manual

coordtransbeta()
2D coordinate transformation and BeTA2007 datum shift between Gauss-
Krueger, UTM and Geographical coordinates. Gauss-Krueger and UTM
coordinates can be used with or without leading meridian strip numbers.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" BOOL PASCAL EXPORT coordtransbeta(
     double nCoordXQ, 
     double nCoordYQ, 
     unsigned short nCoordSysQ, 
     unsigned short nRefSysQ,
     unsigned short nStripQ,
     unsigned long lNoStripQ,
     double *nCoordXZ, 
     double *nCoordYZ,
     unsigned short nCoordSysZ,
     unsigned short nRefSysZ, 
     unsigned short nStripZ,
     unsigned long lNoStripZ);

Prototype of the DLL function in CAVO syntax (attend lower case!):
_DLL function coordtransbeta(;
     nCoordXQ as real8,;                   // 8 Byte
     nCoordYQ as real8,;                   // 8 Byte
     nCoordSysQ as word,;                  // 2 Byte
     nRefSysQ as word,;                    // 2 Byte
     nStripQ as word,;                     // 2 Byte
     lNoStripQ as logic,;                  // 4 Byte
     nCoordXZ ref real8,;                  // 4 Byte
     nCoordYZ ref real8,;                  // 4 Byte
     nCoordSysZ as word,;                  // 2 Byte
     nRefSysZ as word,;                    // 2 Byte
     nStripZ as word,;                     // 2 Byte
     lNoStripZ as logic);                  // 4 Byte
as logic pascal:betadll32.coordtransbeta   // 4 Byte


The function converts the numeric source coordinates nCoordXQ and
nCoordYQ from the source coordinate system nCoordSysQ to the numeric 
target coordinates nCoordXZ and nCoordYZ of the target coordinate system
nCoordSysZ. The transformation is accomplished with high exactness and 
great speed.

The passed source coordinates and the calculated target coordinates are
examined for the range validity within their coordinate systems and for
syntactic correctness.

With the coordinates transformation a datum shift from the geodetic
reference system nRefSysQ of the source coordinate system to the 
geodetic reference system nRefSysZ of the target coordinate system can 
be considered with  NTv2 grid data of the german BeTA2007 standard.

For transformations from the source coordinate systems Gauss-Krueger and
UTM the meridian strip nStripQ, to which the source coordinates refer, 
can be given. The given meridian strip should not deviate more than
3 strips from the native meridian strip of the source coordinate. If in 
nStripZ the value 0 is passed, the leading digits of the eastings are 
used for automatic calculations of the geographical lengths of the
native meridian strip.

If the parameter nStripQ contains a meridian strip number, with the value
TRUE in the parameter lNoStripQ the input of reduced eastings is made 
possible. The eastings then may not contain leading meridian strip 
numbers.
Example: nStripQ = 32,
         lNoStripQ = TRUE,
         UTM Easting 32564410 can be passed as 564410.

For transformations to the target coordinate systems Gauss-Krueger and
UTM the meridian strip nStripZ, to which the target coordinates refer, 
can be given. The given meridian strip should not deviate more than
3 strips from the native meridian strip of the target coordinate. If in 
nStripZ the value 0 is passed, an automatic calculation of the
native meridians strip from the geographical length results.

If the parameter nStripZ contains a meridian strip number, with the value
TRUE in the parameter lNoStripZ the output of reduced Eastings can be 
determined. The eastings then do not contain leading meridian strip 
numbers.
Example: nStripZ = 32,
         lNoStripZ = TRUE,
         UTM Easting 32564410 will be passed back as 564410.

The following transformations are possible:
Coordinate transformations with maintaining the reference system.
Coordinate transformations with change of the geodetic reference system.
Change of the geodetic ref. system with maintaining the coordinate system.
Change of the notation (way of writing) with geographical coordinates.
Change of the meridian strip with Gauss-Krueger and UTM coordinates.
Input and output of reduced Gauss-Krueger and UTM coordinates.
Conversion in the native meridian strip with Gauss-Krueger and UTM
coordinates.

The parameters are passed and/or returned as follows:
nCoordXQ    Longitude, East or Right component of the numeric source
            coordinate.

nCoordYQ    Latitude, North or Heigh component of the numeric source
            coordinate.

nCoordSysQ  coordinate system of the source coordinates.
  3         UTM coordinates (northern hemisphere)
  2         Gauss-Krueger (3 degrees wide strips)
  1         Geographic coordinates (Greenwich) [deg,min,sec]
  6         Geographic coordinates (Greenwich) [deg]

nRefSysQ    Geodetic reference system of the source coordinates.
162         DHDN90 (NTv2 BeTA2007 <±0.5m), Rauenberg, Bessel
163         ETRS89 (NTv2 BeTA2007 <±0.5m), geocentric, GRS80
 10         WGS84 (GPS NTv2 BeTA2007 <±0.5m), geocentric, WGS84

nStripQ     Meridian strip to use with the source coordinate system.
            This parameter has only an effect, if a "Transversal Mercator
            meridian strip system" is registered in nCoordSysQ.
0           Using of the leading digits of the easting for the calculation
            of the natural meridian strip.
> 0         Using of the value in nStripQ for the calculation of the 
            natural meridian strip.

lNoStripQ   Setting for the suppressing of the meridian strip number in 
            the eastings. This parameter has only an effect, if a 
            "Transversal Mercator meridian strip system" is registered in 
            nCoordSysQ.
TRUE        Eastings must be passed without leading meridian strip numbers.
FALSE       Eastings must be passed with leading meridian strip numbers. 

nCoordXZ    Longitude, East or Riight component of the numeric target
(ref)       coordinate.

nCoordYZ    Latitude, North or Heigh component of the numeric target
(ref)       coordinate.

nCoordSysZ  coordinate system of the target coordinates.
  3         UTM coordinates (northern hemisphere)
  2         Gauss-Krueger (3 degrees wide strips)
  1         Geographic coordinates (Greenwich) [deg,min,sec]
  6         Geographic coordinates (Greenwich) [deg]

nRefSysZ    Geodetic reference system of the target coordinates.
162         DHDN90 (NTv2 BeTA2007 <±0.5m), Rauenberg, Bessel
163         ETRS89 (NTv2 BeTA2007 <±0.5m), geocentric, GRS80
 10         WGS84 (GPS NTv2 BeTA2007 <±0.5m), geocentric, WGS84

nStripZ     Meridian strip to use with the target coordinate system.
            This parameter has only an effect, if a "Transversal Mercator
            meridian strip system" is registered in nCoordSysZ.
0           Calculation of the native meridian strip from the geographic
            longitude.
> 0         Calculation of the easting with the strip number nStripZ as
            native meridian strip.

lNoStripZ   Setting for the suppressing of the meridian strip number in 
            the eastings. This parameter has only an effect, if a 
            "Transversal Mercator meridian strip system" is registered in 
            nCoordSysZ.
TRUE        Eastings are returned without leading meridian strip numbers.
FALSE       Eastings are returned with leading meridian strip numbers. 

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


Unlocking
This function requires unlocking. It is unlocked for unrestricted use
together with the other functions of BetaDLL 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.