GeoDLL

Geodetic Development Kit for WINDOWS

 

Contents

 

 

Wenn Sie lieber in Deutscher Sprache lesen möchten, benutzen Sie bitte die Datei GEODLL_D.CHM!

If you prefer to read in German language, please use the GEODLL_D.CHM file!

 

This manual you can also read online at https://www.killetsoft.de/h_geodll_e/handbuch_e.htm

 

 

Select the topic of interest!

 

What you need to know about the Geodetic Development Kit GeoDLL

Characteristics

Hardware requirements

Installation

Test version and full version - Terms of Use

Current Versions and Updates

Imprint

 

What do you need the Geodetic Development Kit GeoDLL for?

Description of the DLL

Reference System Transition

Calculations accuracy

Calculation accuracy with NTv2

Performance Speed

2D / 3D Coordinate Transformations

EPSG Coordinate Reference Systems

INSPIRE - Europe-wide uniform Coordinate Reference Systems

UTM - Universal Transversal Mercator Coordinate System

ETRS89 - the European Terrestrial Reference System 1989

WGS84 / ITRS Epochs / Continental Drift

Explanation of Terms / Glossary

Bibliography

 

Questions and Answers on the Web

FAQ - Questions and Answers

 

Templates for interfaces in various programming languages

Definition and interface files

Operating in a multithreading environment

Template of a C# Visual Studio Project

Template of a C / C++ Visual Studio Project

Sample of a C++ interface

Sample of a C# interface (NET Framework)

Sample of a Visual Basic interface

Sample of a Delphi interface

Sample of a CA-Visual Objects interface

 

Sample programs in various programming languages

Sample program in C++

Sample program in Delphi

Sample program in CA-Visual Objects

Sample program in Python / Spider

Sample of function call in C++ syntax

Sample of function call in Visual Basic syntax

 

Lists of the supported CRS with GeoDLL System Numbering

List with Coordinate Reference Systems sorted by countries for all GeoDLL functions

List with Coordinate Reference Systems sorted alphabetically for all GeoDLL functions

List with default settings of the Coordinate Systems for all GeoDLL functions

List with supported EPSG-Codes for the functions coordtransepsg() and getepsg??()

Syntax of the coordinates

 

"Coordinate Transformations" function group

Function coordtrans() - 2D Coordinate transform. / Reference System Transition, num. / alphanum. (char**)

Function coordtrans2() - 2D Coordinate transform. / Reference System Transition, num. / alphanum. (char*)

Function coordtrans3() - 2D Coordinate Transformation / Reference System Transition, only numeric, notations

Function coordtrans4() - 2D Coordinate Transformation / Reference System Transition, only numeric, no notations

Function coordtransex() - 2D Coordinate transform. / Reference System Transition, reduced eastings

Function coordtrans3d() - 3D Coordinate transf. / Reference System Transition, num. / alphanum. (char**)

Function coordtrans3d2() - 3D Coordinate transf. / Reference System Transition, num. / alphanum. (char*)

Function coordtrans3d3() - 3D Coordinate Transformation / Reference System Transition, only numeric

Function coordtrans3d4() - 3D Coordinate Transformation / Reference System Transition, only numeric, no notations

Function coordtrans3dex() - 3D Coordinate transform. / Reference System Transition, reduced eastings

Function coordtransepsg() - EPSG code Coordinate Transformation / Reference System Transition

Function meritrans() - Meridian strip change with GK und UTM coordinates

Function setcoordarea() - Coordinate System range validity check on / off

Function setcalcextra() - Calculation of extra parameters on / off

Function coordcalcextra() - Calculation of extra parameters during coordinate transformations

Function coordcalcextraind() - Calculation of extra parameters independent from coordinate transformations

 

"NTv2 Transformations" function group

(requires the unlocked function group "Coordinate Transformations")

Information about the supported NTv2 grid files

Calculation accuracy

Polygonal Validity Scopes

Function getntvbinaryfile() - Determination of NTv2 file names matching a reference system

Function getntvdirmatch() - Determination of a matching NTv2 file in a common directory

Function getntvrefbelong() - Determination of the second NTv2 Reference System

Function getntvrefequiv() - Determination of an NTv2 equivalent Reference System

Function getntvrefstatus() - Determination of the NTv2 membership of a Reference System

Function setntvbinaryfile() - Initializes a NTv2 grid data binary file for Reference System Transitions

Function setntvbinautodir() - Sets a directory for the automatically use of NTv2 binary files

Function setntvbinautofile() - Sets a NTv2 grid binary file for automatically call in a wait position

Function setntvpolyvalid() - Sets Polygonal Validity Check in NTv2 files

Function closentvbinaryfile() - Close NTv2 binary file and free NTv2 instance

 

"NTv2 Tools" function group

Function convntvascii2bin() - Converts a NTv2 ASCII file to a binary file

Function convntvbin2ascii() - Converts a NTv2 binary file to an ASCII file

Function convntvbin2area() - Copies an area of a NTv2 grid file to a new binary file

Function convntvbin2gridexport() - Exports a NTv2 grid from a NTv2 binary to a new binary file

Function convntvbin2gridimport() - Imports a NTv2 grid from a NTv2 binary into an existing binary file

Function convntvbin2polyvalid() - Adds Polygonal Validity Scopes to NTv2 binary files

Function getntvgridarray() - Writes the parameters of one or all NTv2 grids to arrays

Function getntvgridcount() - Gets count of grids contained in a NTv2 file

Function getntvgridheader() - Gets the header parameter of one or all NTv2 grids

Function getntvheader() - Gets the header parameter of a NTv2 file

Function getntvminmaxshift() - Gets the min / max shift values of one or all NTv2 grids

 

"User Definitions" function group

Function setusercoordsys1() - Setup of a user defined Coordinate System

Function setusercoordsys2() - Setup of a 2nd user defined Coordinate System

Function setuserrefsys() - Setup of a user defined Reference System

Function setuserellsource() - Setup of a user defined source ellipsoid

Function setuserelltarget() - Setup of a user defined target ellipsoid

Function getusercoordpar() - Get parameter names of a user defined Coordinate System

Function getusercoordtyp() - Get type name of a user defined Coordinate System

 

"Parameter Determination" function group

Function getepsg2geodll() - Determine GeoDLL codes equivalent to EPSG code

Function getepsgcrsname() - Determine designation of an EPSG CRS

Function getcoordname() - Coordinate System name

Function getcoordsys() - Formatted Coordinate System parameters

Function getcoordform() - 2D Coordinate System coordinates notation

Function getcoordform3d() - 3D Coordinate System coordinates notation

Function getcoordaxis() - 2D Coordinate System axes names

Function getcoordaxis3d() - 3D Coordinate System axes names

Function getcoordarea() - Range validity of a Coordinate System

Function getcoordfixref() - Determining Coordinate System has fixed Reference System

Function getcoordstdrefsys() - Default Reference System of a Coordinate System

Function getcoordstdunitpar() - Default Measurement Unit of a Coordinate System

Function getcoordproj() - Projection method number of a Coordinate System

Function getcoordstrstatus() - Determining Coordinate System is a strip system

Function getrefname() - Reference System name

Function getrefsys() - Formatted Reference System parameters

Function getellname() - Ellipsoid name

Function getellsys() - Formatted ellipsoid parameters

Function getellsource() - Source ellipsoid demi-axes

Function getelltarget() - Target ellipsoid demi-axes

Function getunitname() - Measurement unit name

Function getunitpar() - Calculation constants of a measurement unit

 

"Distance Calculations" function group

Function distancegeo() - Distance between geographic coordinates on the ellipsoid

Function distancesphere() - Distance between geographic coordinates on the sphere

Function distanceutm() - Distance between UTM coordinates

Function point2pointgeo() - Dest. point on ellipsoid from start point, bearing, distance

Function point2pointsphere() - Dest. point on sphere from start point, bearing, distance

Function point2pointutm() - UTM dest. point from UTM start point, bearing and distance

Function vincentydirect() - Vincentys Direct Position Computation

Function vincentyinverse() - Vincentys Inverse Position Computation

 

"Notation Calculations" function group

Function umfd2g() - Translates decimal notation to degrees notation

Function umfd2gn() - Translates decimal notation to gonal notation

Function umfd2n() - Translates decimal notation to nautical notation

Function umfd2s() - Translates decimal notation to seconds notation

Function umfg2d() - Translates degrees notation to decimal notation

Function umfgn2d() - Translates gonal notation to decimal notation

Function umfn2d() - Translates nautical notation to decimal notation

Function umfs2d() - Translates seconds notation to decimal notation

Function umfroundg() - Accurate rounding of degrees coordinates

Function umfroundn() - Accurate rounding of nautical coordinates

 

"Map Calculations" function group

Function kartgeo2tk() - Determine TK25 number from geographic coordinates

Function karttk2geo() - Determine corner map coordinates from TK25 number

Function karttknum() - Determine TK50, TK100 und TKÜ200 from a TK25 number

 

"Elevation Calculations" function group

Information about the used Digital Elevation Models

Function getelevation03() - Elevation from the 3 sec. elevation model CGIAR

Function getelevation30() - Elevation from the 30 sec. elevation model GLOBE

Function getelevation33() - Elevation from 3/30 sec. elevation model CGIAR/GLOBE

Function setelev03datapath() - Sets the data path for the elevation model CGIAR

Function setelev30datapath() - Sets the data path for the elevation model GLOBE

Function convelev03ascii2bin() - Convert a CGIAR ASCII file to a binary file

 

"Transformation Parameter" function group

Information about Helmert / Molodensky Parameter Sets

Function gettranshelmert() - Calculation of seven Helmert parameters

Function gettransmolodensky() - Calculation of three Molodensky parameters

Function gettransoutliers() - Calculation of outliers in a group of identical points

Function gettransresiduals() - Calculation of the residuals from identical points

Function gettransresidualcoord() - Correction of coordinates with Residual Gaps Distribution

Function gettransresidualmax() - Calculation of the "Maximum Spatial Residual"

Function gettransresidualaverage() - Calculation of the "Average Spatial Residual"

Function gettransresidualrms() - Calculation of the "Root Mean Square Residual" (RMS)

 

"Time zone calculations" function group

Information about Time Zones and Maritime Zones

List with Time Zones sorted by designations for the following functions

Function settzgridfile() - Initialize and test a gridfile for time zone calculations

Function settzshapefile() - Initialize and test a shapefile for time zone calculations

Function gettzcurrentbynum() - Determ. of current time zone param. from GeoDLL index

Function gettznamebynum() - Determ. of a time zone designation from a GeoDLL index

Function gettznumbycoordexact() - Exact determination of GeoDLL index from a coordinate

Function gettznumbycoordfast() - Fast determination of GeoDLL index from a coordinate

Function gettzparbynum() - Determination of common time zone param. from GeoDLL index

 

Miscellaneous functions

Function getauthor() - Copyright and program author’s address

Function getdisclaimer()) - Disclaimer reference for GeoDLL

 

Function getdllversion() - GeoDLL version number

Function geterrorcode() - Latest error description

Function getlicensee() - Licensee identification

Function setcoordarea() - Coordinate System range validity check on / off

Function setdllinit() - Initializing and functional readiness test of the GeoDLL

Function setdllworkdir() - Directory for geodllbn.bin and other files

Function seteventloop() - Event-handling in time-intensive functions on / off

Function setinternerrsys() - Internal error handler on / off

Function setlanguage() - Language selection for all text returns

Function setmultithreading() - Usage in a multithreading environment on / off

Function setsilence() - Output of messages to the EventLog on / off

Function setstaticuse() - Usage of fast Static Variables on / off

Function setstringallocate() - Automatic memory management on / off

Function setunlockcode() - Input of the unlock parameter

 

Additional information

Important Internet Links