Prototyp und Beschreibung der Funktion convntvbin2gridexport() (Funktion der freischaltpflichtigen Gruppe "NTv2-Werkzeuge") |
convntvbin2gridexport() NTv2-Gitter aus binärer Quelldatei in neue binäre Zieldatei exportieren. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall convntvbin2gridexport( const char *pszFileSource, const char *pszFileTarget, unsigned short nGridSource); Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function convntvbin2gridexport(; pszFileSource as psz,; // 4 Byte, char* pszFileTarget as psz,; // 4 Byte, char* nGridSource word); // 2 Byte as logic pascal:geodll32.convntvbin2gridexport // 4 Byte Die Dateinamen der NTv2-Quelldatei und der neu zu generierenden NTv2- Zieldatei dürfen jeweils einen Laufwerksbuchstaben und eine Verzeichniskette enthalten. Beispiel: Quellddatei "c:\programm_ntv2\BeTA2007.gsb" Zieldatei "c:\programm_ntv2\Export.gsb" Achtung, in C-Syntax müssen doppelte Backslashes verwendet werden! Die Funktion exportiert das NTv2-Gitter mit der Nummer nGridSource einer binären NTv2-Quelldatei in eine neue binäre NTv2-Zieldatei. Dabei wird der Datei-Header der Quelldatei in die Zieldatei kopiert. Die Anzahl der Gitter NUM_FILE wird darin auf "1" gesetzt und der Name des Elterngitters PARENT wird auf "NONE" gesetzt. Hinter dem Datei-Header wird das exportierte Gitter mit dem Gitter-Header und den Gitterdaten eingetragen. Die Nummer nGridSource des zu exportierenden Gitter kann mit der Funktion getBinGridHeader() ermittelt werden. Die Dateinamen der NTv2-Quelldatei und der neu zu generierenden NTv2- Zieldatei dürfen jeweils einen Laufwerksbuchstaben und eine Verzeichniskette enthalten. Beispiel: Quellddatei "c:\programm_ntv2\BeTA2007.gsb" Zieldatei "c:\programm_ntv2\Export.gsb" Achtung, in C-Syntax müssen doppelte Backslashes verwendet werden! Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben: pszFileSource Dateiname der als Quelle verwendeten NTv2-Binärdatei aus der ein NTv2-Gitter exportiert werden soll. Der Dateiname darf einen Laufwerksbuchstaben und eine Verzeichniskette enthalten. Der Dateiname sollte die Dateinamens erweiterung ".gsb" haben. pszFileTarget Dateiname der zu neu erzeugenden Zielddatei zur Aufnahme des exportierten NTv2-Gitters. Der Dateiname darf einen Laufwerks- buchstaben und eine Verzeichniskette enthalten. Der Dateiname sollte die Dateinamenserweiterung ".gsb" haben. nGridSource Nummer des aus der Quelldatei zu exportierenden NTv2-Gitters. 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. |