Prototyp und Beschreibung der Funktion getntvgridheader() (Funktion der freischaltpflichtigen Gruppe "NTv2-Werkzeuge") |
getntvgridheader() Ermittlung der Header-Parameter eines oder aller NTv2-Gitter. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall getntvgridheader( const char *pszFileNtv, unsigned long lAscii, unsigned short nGridNo, char **pszGridHeader); Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function getntvgridheader; (pszFileNtv as psz,; // 4 Byte, char* lAscii as logic,; // 4 Byte nGridNo as word,; // 2 Byte pszGridHeader ref psz); // 4 Byte, char**, x*600 alloc. as logic pascal:geodll32.getntvgridheader Die Allokation von Speicher für "ref psz" / "char**" ist nur notwendig, wenn zuvor setstringallocate(FALSE) aufgerufen worden ist. Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben: pszFileNtv Dateiname der ASCII- oder binär formatierten NTv2-Datei, für die die Parameter der Gitters 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 Header- Parameter ermittelt werden sollen. 0: Es werden die Parameter aller in der NTv2-Datei enthaltenen Gitter ermittelt. pszGridHeader Header-Parameter des NTv2-Gitters. (ref) Achtung: "ref pszGridHeader" entspricht "char**" in C. Es müssen die unten berechneten Bytes Speicher für den Null terminated string in Abhängigkeit vom Aufruf der Funktion setstringallocate() allokiert werden. Beachten Sie dazu die Hinweise im Kapitel "Prototyp und Beschreibung der Funktion setstringallocate()". nGridNo n: 600 Bytes Memory werden benötigt. nGridNo 0: 600 mal Anzahl der Gitter Bytes Memory werden benötigt. Mit der Funktion getntvgridcount() kann die Anzahl der Gitter ermittelt werden. returnWert Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE. Der zurückgegebene Text sieht je nach den übergebenen geodätischen Systemen z.B. so aus: Header des Gitters Nr. 1 Name des NTv2-Gitters: DHDN90 Name des Elterngitters: NONE Erstellungsdatum: 06-11-09 Letzte Änderung: 06-11-09 Südliche Begrenzung [Grad]: 47.00000 Nördliche Begrenzung [Grad]: 55.30000 Östliche Begrenzung [Grad]: 15.66667 Westliche Begrenzung [Grad]: 5.5000 Gitterabstand Breite [Grad]: 0.10000 Gitterabstand Länge [Grad]: 0.16667 Anzahl der Gitterwerte [Grad]: 5208 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. |