Prototyp und Beschreibung der Funktion getusercoordpar() (Funktion der freischaltpflichtigen Gruppe "Benutzerdefinitionen") |
getusercoordpar() Ermittlung der Parameterbezeichnungen einer Projektionsmethode. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall getusercoordpar( unsigned short nProjNo, char **pszProjPar); Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function getusercoordpar(; nProjNo as word,; // 2 Byte pszProjPar ref psz); // 4 Byte, char**, 500 alloc. as logic pascal:geodll32.getusercoordpar // 4 Byte Die Allokation von Speicher für "ref psz" / "char**" ist nur notwendig, wenn zuvor setstringallocate(FALSE) aufgerufen worden ist. Die Funktion gibt die zu der in nProjNo übergebenen Projektionsmethode passenden Bezeichnungen der Projektionsparameter als formatierten Text im Parameter pszProjPar zurück. Der Text wird in der zuvor mit der Funktion setLanguage() gesetzten Sprache zurückgegeben. Die Parameter werden folgendermaßen übergeben: nProjNo (Projektionsmethode) Bezeichnung der Projektionsmethode 1 Transversale Mercator Projektion 2 Transversales Mercator Meridianstreifensystem 3 Lambert Conformal Conic Projektion (1 Standard Parallele) 4 Lambert Conformal Conic Projektion (2 Standard Parallele) 5 Oblique Conformal Conic Projektion (z.B. Tschechei) 6 Oblique Mercator Projektion (z.B. Schweiz, Alaska) 7 Oblique Stereographic Projektion (z.B. Niederlande) 8 Quasi Stereographic Projektion (z.B. Polen) 9 Cassini Soldner Projektion 10 Lambert Azimuthal Equal Area Projektion 11 Rechtwinklige Ausgabegeräte-Projektion 12 Equidistant Cylindrical Projektion 13 Bonne Pseudoconical Equal Area Projektion 14 Albers Equal Area Conic Projektion 15 Mercator Projektion (1 Standard Parallele) 16 American Polyconic Projektion 99 Geographische Projektion pszProjPar Die Bezeichnungen der Projektions-Parameter werden als (ref) formatierter Text per Referenz zurückgegeben. Achtung: "ref pszProjPar" entspricht "char**" in C. Es müssen 500 Byte Speicher für den Null terminated string in Abhängigkeit vom Aufruf der Funktion setstringallocate() allokiert werden. Beachten Sie dazu die Hinweise in der Beschreibung der Funktion setstringallocate()". returnWert Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE. Der zurückgegebene String sieht in Abhängigkeit von der gewählten Projektionsmethode z.B. so aus: Breitengrad 1. Standard-Paral. [Grad] Breitengrad 2. Standard-Paral. [Grad] Längengrad des Gitterursprungs [Grad] Breitengrad des Gitterursprungs [Grad] Östliche Verschiebung [Meter] Nördliche Verschiebung [Meter] Freischaltung: Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe "Benutzerdefinitionen". 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 nur wenige Funktionsaufrufe zu Testzwecken (Sharewareprinzip) möglich. |