|
Prototyp und Beschreibung der Funktion setunlockcode() (Nicht freischaltpflichtige Funktion) |
|
setunlockcode()
Freischalten von GeoDLL-Funktionsgruppen mittels Freischaltparameter.
Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall setunlockcode(
const char *pszUnlockkey,
const char *pszLicensee);
Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function setunlockcode(;
pszUnlockkey as psz,; // 4 Byte, char*
pszLicensee as psz); // 4 Byte, char*
as logic pascal:geodll32.setunlockcode // 4 Byte
Die Funktion schaltet alle DLL-Funktionen einer freischaltpflichtigen Gruppe
zur uneingeschränkten Nutzung frei. Dazu müssen für jede frei zuschaltende
Gruppe die Freischaltparameter aus dem Lizenzvertrag mit der Funktion
setunlockcode() an die DLL übergeben werden. Es ist wichtig, dass die
Parameter in derselben Schreibweise übergeben werden, wie sie im Lizenzvertrag
eingetragen sind. Wenn Funktionen aus verschiedenen Gruppen genutzt werden
sollen, muss setunlockcode() mehrmals nacheinander aufgerufen werden.
Die geodätischen Funktionen der DLL sind folgendermaßen in
freischaltpflichtige Gruppen zusammengefasst:
Die Gruppe "Koordinatentransformationen" enthält Funktionen zur Durchführung
von Koordinatentransformationen und Bezugssystemwechsel.
coordtrans() 2D-Koordinatentransf., numerisch / alphanum. (char**)
coordtrans2() 2D-Koordinatentransf., numerisch / alphanum. (char*)
coordtrans3() 2D-Koordinatentransformation, numerisch
coordtrans4() 2D-Koordinatentransf., numerisch, keine Notationen
coordtransex() 2D-Koordinatentransformationen, reduzierte Ostwerte
coordtrans3d() 3D-Koordinatentransf., numerisch / alphanum. (char**)
coordtrans3d2() 3D-Koordinatentransf., numerisch / alphanum. (char*)
coordtrans3d3() 3D-Koordinatentransformation, numerisch
coordtrans3d4() 3D-Koordinatentransformation, numerisch, keine Notationen
coordtrans3dex() 3D-Koordinatentransformationen, reduzierte Ostwerte
coordtransepsg() - EPSG-kodierte Koordinatentransformation
meritrans() Meridianstreifenwechsel bei GK- und UTM-Koordinaten
setcoordarea() Ein-/Ausschalten der Bereichsüberprüfung
setcalcextra() Ein-/Ausschalten der Berechnung von Extra-Parametern
coordcalcextra() Berechnung von Extra-Parametern während Koordinatentransf.
coordtransextraind() Berechnung von Extra-Parametern unabhängig von
Koordinatentransformationen
Die Gruppe "NTv2-Transformationen" enthält Funktionen zum Bezugssystemwechsel
mit Gitterdateien nach dem NTv2-Standard.
getntvbinaryfile() Erm. der zu einem Bezugssys. passenden NTv2-Dateinamen
getntvdirmatch() Ermittlung einer NTv2-Datei aus einem Sammelverzeichnis
getntvrefbelong() Ermitteln des zweiten NTv2-Bezugssystems
getntvrefequiv() NTv2-äquivalentes Bezugssystem
getntvrefstatus() NTv2-Zugehörigkeit eines Bezugssystems
setntvbinaryfile() NTv2-Binärdatei prüfen und initialisieren
setntvbinautodir() Verzeichnis zur autom. Verwendung von NTv2-Dateien setzen
setntvbinautofile() NTv2-Binärdatei in die Warteposition setzen
setntvpolyvalid() Polygonale Gültigkeitsprüfung in NTv2-Dateien setzen
closentvbinaryfile() NTv2-Binärdatei schließen und NTv2-Instanz freigeben
Die Gruppe "NTv2-Werkzeuge" enthält Funktionen zur Manipulation von und zur
Datengewinnung aus NTv2 ASCII-Gitterdateien und NTv2 Binär-Dateien.
convntvascii2bin() NTv2-ASCII-Datei nach Binärdatei konvertieren
convntvbin2ascii() NTv2-Binärdatei nach ASCII-Datei konvertieren
convntvbin2area() Bereich einer NTv2-Gitterdatei in Binärdatei übertragen
convntvbin2polyvalid() NTv2-Datei mit polygonalen Gültigkeitsber. ergänzen
getntvgridarray() Numerische Parameter der NTv2-Gitter in Arrays schreiben
getntvgridcount() Anzahl der Gitter in einer NTv2-Datei
getntvgridheader() Header-Parameter eines NTv2-Gitters
getntvheader() Header-Parameter einer NTv2-Datei
getntvminmaxshift() Ermittlung der Min- / Max-Shiftwerte von NTv2-Gittern
Die Gruppe "Benutzerdefinitionen" enthält Funktionen zur Eingabe von
selbst definierten Koordinatensystemen, Bezugssystemen und Erdellipsoiden,
die mit den Funktionen der Gruppe "Koordinatentransformationen" neben den
in GeoDLL vordefinierten Systemen genutzt werden können.
setusercoordsys1() Definition eines Benutzer-Koordinatensystems
setusercoordsys2() Definition eines zweiten Benutzer-Koordinatensystems
setuserrefsys() Definition eines Benutzer-Bezugssystems
setuserellsource() Definition eines Benutzer-Quellellipsoids
setuserelltarget() Definition eines Benutzer-Zielellipsoids
getusercoordpar() Parameter eines Benutzer-Koordinatensystems
getusercoordtyp() Bezeichnung eines Benutzer-Koordinatensystems
Die Gruppe "Parameterermittlung" enthält Funktionen zur Rückgabe von
Parametern der in GeoDLL vordefinierten und benutzerdefinierten
Koordinatensysteme, Bezugssysteme und Ellipsoide.
getepsg2geodll() Ermittlung zu EPSG-Code äquivalenten GeoDLL-Codes
getepsgcrsname() Ermittlung der Bezeichnung eines EPSG-CRS
getcoordname() Bezeichnung eines Koordinatensystems
getcoordsys() Formatierte Parameter eines Koordinatensystems
getcoordform() Notation der Koordinaten eines 2D-Koordinatensystems
getcoordform3d() Notation der Koordinaten eines 3D-Koordinatensystems
getcoordaxis() Achsenbezeichnungen eines 2D-Koordinatensystems
getcoordaxis3d() Achsenbezeichnungen eines 3D-Koordinatensystems
getcoordarea() Bereichsgrenzen eines Koordinatensystems
getcoordstdrefsys() Standard-Bezugssystem eines Koordinatensystems
getcoordstdunitpar() Standard-Maßeinheit eines Koordinatensystems
getcoordproj() Projektionsmethodennummer eines Koordinatensystems
getcoordproj() Projektionsmethodennummer eines Koordinatensystems
getcoordstrstatus() Feststellen ob Koordinatensystem ein Streifensystem
getrefname() Bezeichnung eines Bezugssystems
getrefsys() Formatierte Parameter eines Bezugssystems
getellname() Bezeichnung eines Ellipsoids
getellsys() Formatierte Parameter eines Ellipsoids
getellsource() Halbachsen eines Quellellipsoids
getelltarget() Halbachsen eines Zielellipsoids
getunitname() Bezeichnung einer Maßeinheit
getunitpar() Umrechnungskontante einer Maßeinheit
Die Gruppe "Entfernungsberechnungen" enthält Funktionen zur Ermittlung
der Entfernung zwischen zwei Koordinaten.
distancegeo() Entfernung zw. geogr. Koordinaten auf dem Ellipsoid
distancesphere() Entfernung zw. geogr. Koordinaten auf der Erdkugel
distanceutm() Entfernung zwischen UTM-Koordinaten
point2pointgeo() Zielpunkt auf Ellipsoid aus Startpunkt, Winkel, Entfernung
point2pointsphere() Zielpunkt auf Erdkugel aus Startpunkt, Winkel, Entfernung
point2pointutm() UTM-Zielpunkt aus UTM-Startpunkt, Winkel und Entfernung
vincentydirect() Erste geodätische Hauptaufgabe
vincentyinverse() Zweite geodätische Hauptaufgabe
Die Gruppe "Notationsberechnungen" enthält Funktionen zur Umrechnung der
geographischen Koordinaten von einer Notation in eine andere und zum
korrekten Runden der geographischen Koordinaten verschiedener Notationen.
umfd2g() Umformung dezimale Notation in graduelle Notation
umfd2gn() Umformung dezimale Notation in gonale Notation
umfd2n() Umformung dezimale Notation in nautische Notation
umfd2s() Umformung dezimale Notation in Sekunden-Notation
umfg2d() Umformung graduelle Notation in dezimale Notation
umfgn2d() Umformung gonale Notation in dezimale Notation
umfn2d() Umformung nautische Notation in dezimale Notation
umfs2d() Umformung Sekunden-Notation in dezimale Notation
umfroundg() Exakte Rundung gradueller Koordinaten
umfroundn() Exakte Rundung nautischer Koordinaten
Die Gruppe "Kartenberechnungen" enthält Funktionen zum Umrechnen von
Koordinaten in TK-Nummern der topographischen Karten und zum Ermitteln der
Eckkoordinaten der topographischen Karten.
kartgeo2tk() Zu geographischen Koordinaten passende TK25-Nummer
karttk2geo() Eckkoordinaten einer Karte aus TK25-Nummer ermitteln
karttknum() TK50, TK100 und TKÜ200 aus TK25-Nummer ermitteln
Die Gruppe "Höhenberechnungen" enthält Funktionen zum Ermitteln von
Geländehöhen über dem Meeresspiegel aus digitalen Höhenmodellen.
getelevation03() Geländehöhe aus dem 3 Sek. Höhenmodell CGIAR ermitteln
getelevation30() Geländehöhe aus dem 30 Sek. Höhenmodell GLOBE ermitteln
getelevation33() Geländehöhe aus dem 3/30 Sek. Höhenmodell CGIAR/GLOBE
setelev03datapath() Datenpfad für das 3 Sek. Höhenmodell CGIAR setzen
setelev30datapath() Datenpfad für das 30 Sek. Höhenmodell GLOBE setzen
convelev03ascii2bin() CGIAR ASCII-Datei nach Binärdatei konvertieren
Die Gruppe "Transformationsparameter" enthält Funktionen zur Berechnung von
Helmert- und Molodensky-Parametersätzen, Ausreißern und Klaffungen aus
identischen Punkten der Quell- und Ziel-Koordinatenbezugssysteme.
gettranshelmert() Berechnnen von sieben Helmert-Parametern
gettransmolodensky() Berechnen von drei Molodensky-Parametern
gettransoutliers() Berechnen der Ausreißer von identischen Punkten
gettransresiduals() Berechnen der Klaffungen von identischen Punkten
gettransresidualmax() Berechnen der "Maximalen Räumlichen Klaffung"
gettransresidualaverage() Berechnen der "Mittleren Räumlichen Klaffung"
gettransresidualrms() Berechnen der "Quadratischen Mittleren Klaffung" (RMS)
Die Gruppe "Zeitzonenberechnungen" enthält Funktionen zur Ermittlung und
Berechnung von Zeitzonen, UTC, DST, Sommerzeitdaten und anderen Zeitzonen-
Parametern aus Koordinaten und aus GeoDLL-Zeitzonen-Indexen.
settzgridfile() Zeitzonen-Gitterdatei prüfen und initialisieren
settzshapefile() Zeitzonen-Shapedatei prüfen und initialisieren
gettzcurrentbynum() Ermittlung aktueller Zeitzonen-Parameter aus GeoDLL-Index
gettznamebynum() Ermittlung der Zeitzonenbezeichnung aus einem GeoDLL-Index
gettznumbycoordexact() Genaue Ermittlung des GeoDLL-Index aus Koordinate
gettznumbycoordfast() Schnelle Ermittlung des GeoDLL-Index aus Koordinate
gettzparbynum() Ermittlung allgemeiner Zeitzonen-Parameter aus GeoDLL-Index
Sonstige Funktionen, die nicht freischaltpflichtig sind und mit allen
Gruppen genutzt werden können.
getauthor() Urheberhinweis und Anschrift des Programmautoren
getdisclaimer() Hinweis zum Haftungsausschluss der GeoDLL
getdllversion() Versionsnummer der vorliegenden GeoDLL
geterrorcode() Beschreibung des zuletzt aufgetretenen Fehlers
getlicensee() Bezeichnung des Lizenznehmers
setdllinit() Initialisierung und Test Funktionsbereitschaft der GeoDLL
setdllworkdir() Verzeichnis für geodllbn.bin und andere Dateien
seteventloop() Ein-/Ausschalten der Event-Verarbeitung
setinternerrsys() Ein-/Ausschalten der internen Fehlerbehandlung
setlanguage() Wahl der Sprache für alle textlichen Rückgaben
setmultithreading() Ein-/ Ausschalten einer Multithreading-Umgebung
setsilence() Ein-/Ausschalten der EventLog-Ausgabe
setstaticuse() Ein-/Ausschalten der Verwendung interner Statics
setstringallocate() Ein-/Ausschalten des internen Speichermanagements
setunlockcode() Eingabe der Freischaltparameter
Beim Aufruf der Funktion setunlockcode() müssen die übergebenen
Freischaltparameter korrekt sein. Bei der Übergabe eines einzigen ungültigen
Freischaltparameters werden die Funktionen aller freischaltbaren Gruppen von
weiteren Funktionsaufrufen ausgeschlossen.
Falls noch keine Freischaltparameter bei der Vertriebsfirma erworben worden
sind, können die Funktionen freischaltpflichtiger Gruppen pro Programmlauf
einige Mal zu Testzwecken aufgerufen werden (Sharewareprinzip). Die
Testversion zeigt außerdem ein kleines Hinweisfenster an und gibt eine
Dreitonfolge aus. Die Funktion setunlockcode() darf in diesem Fall nicht
aufgerufen werden (siehe vorherigen Absatz).
Die Parameter werden folgendermaßen übergeben:
pszUnlockkey Freischaltcode aus dem beim Lizenzgeber erworbenen
Lizenzvertrag als ein mit Null abschließender
Characterstring (nullterminated string). Sollte die
verwendete Programmiersprache keine nullterminated strings
unterstützen, so kann auch ein normaler String mit einem
angehängten Null-Character übergeben werden.
pszLicensee Bezeichnung des Lizenznehmers aus dem Lizenzvertrag als ein
mit Null abschließender Characterstring (nullterminated
string). Sollte die verwendete Programmiersprache keine
nullterminated strings unterstützen, so kann auch ein
normaler String mit einem angehängten Null-Character
übergeben werden. Die Lizenznehmerbezeichnung kann später mit
der Funktion getlicensee() abgefragt werden.
returnWert Bei ungültigen Freischaltparametern gibt die Funktion FALSE
zurück, sonst TRUE.
Freischaltung:
Die Funktion ist nicht freischaltpflichtig.
|