Prototyp und Beschreibung der Funktion getntvminmaxshift() (Funktion der freischaltpflichtigen Gruppe "NTv2-Werkzeuge") |
getntvminmaxshift() Ermittlung der Min- / Max-Shiftwerte eines oder aller NTv2-Gitter. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall getntvminmaxshift( const char *pszFileNtv, unsigned long lAscii, unsigned short nGridNo, double *fMinShift, double *fMaxShift) Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function getntvminmaxshift; (pszFileNtv as psz,; // 4 Byte, char* lAscii as logic,; // 4 Byte nGridNo as word,; // 2 Byte fMinShift ref real8,; // 4 Byte fMaxShift ref real8); // 4 Byte as logic pascal:geodll32.getntvminmaxshift Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben: pszFileNtv Dateiname der ASCII- oder binär formatierten NTv2-Datei, für die minimale und maximale Shiftwerte ermittelt werden sollen. Der Dateiname darf einen Laufwerksbuchstaben, eine Verzeichniskette und eine Dateinamenserweiterung enthalten. lAscii TRUE: Die NTv2-Datei ist ASCII-formatiert. FALSE: Die NTv2-Datei ist binär formatiert. nGridNo n: Nummer des Gitters in der NTv2-Datei, für das die die minimalen und maximalen Shiftwerte ermittelt werden sollen. 0: Es werden die die minimalen und maximalen Shiftwerte aller in der NTv2-Datei enthaltenen Gitter zusammenaddiert. fMinShift Kleinster (minimaler) Shiftwert eines oder aller NTv2-Gitter. (ref) Der Wert ist der Absolutbetrag des kleinsten ermittelten Shiftwertes in geodätischen Sekunden, der aus den Verschiebungen auf der Breite und der Länge nach Pytagoras errechnet wird. fMaxShift Größter (maximaler) Shiftwert eines oder aller NTv2-Gitter. (ref) Der Wert ist der Absolutbetrag des größten ermittelten Shiftwertes in geodätischen Sekunden, der aus den Verschiebungen auf der Breite und der Länge nach Pytagoras errechnet wird. returnWert Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE. Freischaltung: Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe "NTv2-Werkzeuge". Sie wird zusammen mit den anderen Funktionen der Gruppe durch die Eingabe der bei der Vertriebsfirma erworbenen Freischaltparameter per Aufruf der Funktion setunlockcode() zur uneingeschränkten Nutzung frei geschaltet. Ohne die Freischaltung sind mit dieser Funktion keine Funktions- aufrufe zu Testzwecken (Sharewareprinzip) möglich. |