Prototyp und Beschreibung der Funktion setusercoordsys1()

(Funktion der freischaltpflichtigen Gruppe "Benutzerdefinitionen")

 

setusercoordsys1()
Konfiguration des ersten von zwei benutzerdefinierten Koordinatensystemen.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall setusercoordsys1(
     unsigned short nProjNum,
     double nPar1,
     double nPar2,
     double nPar3,
     double nPar4,
     double nPar5,
     double nPar6,
     double nPar7,
     double nPar8);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function setusercoordsys1(;
     nProjNum as word,;                    // 2 Byte
     nPar1 as real8,;                      // 8 Byte
     nPar2 as real8,;                      // 8 Byte
     nPar3 as real8,;                      // 8 Byte
     nPar4 as real8,;                      // 8 Byte
     nPar5 as real8,;                      // 8 Byte
     nPar6 as real8,;                      // 8 Byte
     nPar7 as real8,;                      // 8 Byte
     nPar8 as real8);                      // 8 Byte
as logic pascal:geodll32.setusercoordsys1  // 4 Byte


Die Funktion speichert die Parameter des ersten benutzerdefinierten
Koordinatensystems. Mit der Funktion setusercoordsys2() kann ein
weiteres Koordinatensystem konfiguriert werden.

Nutzung der Koordinatensystem-Parameter:
In den Funktionen coordtrans?() werden die hier definierten Parameter
des benutzerdefinierten Koordinatensystems genutzt, indem als Kennung
für das Koordinatensystem (nCoordQ) die Zahl 1000 übergeben wird.


Die Parameter werden folgendermaßen übergeben:
nProjNum (Projektionmethode des benutzerdefinierten Koordinatensystems)
   Parameter-Variable
          Bezeichnung der Projektionsmethode oder des Parameters
            Bezeichnung der Projektionsparameter

0         Erstes benutzerdefiniertes Koordinatensystem zurücksetzen
   nPar1    0.0 oder beliebiger Wert ohne Auswirkung
   nPar2    0.0 oder beliebiger Wert ohne Auswirkung
   nPar3    0.0 oder beliebiger Wert ohne Auswirkung
   nPar4    0.0 oder beliebiger Wert ohne Auswirkung
   nPar5    0.0 oder beliebiger Wert ohne Auswirkung
   nPar6    0.0 oder beliebiger Wert ohne Auswirkung
   nPar7    0.0 oder beliebiger Wert ohne Auswirkung
   nPar8    0.0 oder beliebiger Wert ohne Auswirkung

1         Transversale Mercator Projektion
   nPar1    Longitude of natural origin (Central meridian) [degrees]
   nPar2    Latitude of natural origin [degrees]
   nPar3    False easting [meter]
   nPar4    False nothing [meter]
   nPar5    Scale factor at natural origin (Central meridian)
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

2         Transversales Mercator Streifensystem
   nPar1    Longitude of first meridian strips natural origin [degrees]
   nPar2    Width of meridian strips [degrees]
   nPar3    False easting [meter]
   nPar4    False northing [meter]
   nPar5    Scale factor at natural origin
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

3         Lambert Conformal Conic Projektion (eine Standard-Parallele)
   nPar1    Longitude at grid origin [degrees]
   nPar2    Latitude of standard parallel [degrees]
   nPar3    Easting at grid origin [meter]
   nPar4    Northing at grid origin [meter]
   nPar5    Scale Factor on standard parallel
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

4         Lambert Conformal Conic Projektion (zwei Standard-Parallelen)
   nPar1    Latitude of first standard parallel [degrees]
   nPar2    Latitude of second standard parallel [degrees]
   nPar3    Longitude at grid origin [degrees]
   nPar4    Latitude at grid origin [degrees]
   nPar5    False easting at grid origin [meter]
   nPar6    False northing at grid origin [meter]
   nPar7    Scale factor
   nPar8    0.0

5         Oblique Conformal Conic Projektion (z.B. Tschechei)
   nPar1    Longitude of projection center [degrees]
   nPar2    Latitude of projection center [degrees]
   nPar3    Azimuth of center line [degrees]
   nPar4    Latitude of pseudo standard parallel [degrees]
   nPar5    Scale factor on pseudo standard parallel
   nPar6    False easting at projection center [meter]
   nPar7    False northing at projection center [meter]
   nPar8    0.0

6         Oblique Mercator Projektion (z.B. Schweiz, Alaska)
   nPar1    Longitude of projection center [degrees]
   nPar2    Latitude of projection center [degrees]
   nPar3    Azimuth of initial line [degrees]
   nPar4    Rectified bearing of initial line [degrees]
   nPar5    Easting at projection center [meter]
   nPar6    Northing at projection center [meter]
   nPar7    Scale factor at initial line
   nPar8    0.0

7         Oblique Stereographic Projektion (z.B. Niederlande)
   nPar1    Longitude of natural origin [degrees]
   nPar2    Latitude of natural origin [degrees]
   nPar3    False easting at natural origin [meter]
   nPar4    False northing at natural origin [meter]
   nPar5    Scale factor at natural origin
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

8         Quasi Stereographic Projektion (z.B. Polen)
   nPar1    Longitude of natural origin [degrees]
   nPar2    Latitude of natural origin [degrees]
   nPar3    False easting at natural origin [meter]
   nPar4    False northing at natural origin [meter]
   nPar5    Scale factor at natural origin
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

9         Cassini Soldner Projektion
   nPar1    Longitude of projection center [degrees]
   nPar2    Latitude of projection center [degrees]
   nPar3    False easting [meter]
   nPar4    False nothing [meter]
   nPar5    0.0
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

10        Lambert Azimuthal Equal Area Projektion
   nPar1    Longitude of origin [degrees]
   nPar2    Latitude of origin [degrees]
   nPar3    False easting [meter]
   nPar4    False nothing [meter]
   nPar5    0.0
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

11        Rechtwinklige Ausgabegeräte-Projektion
   nPar1    Smallest possible longitude [degrees]
   nPar2    Smallest possible latitude [degrees]
   nPar3    Largest possible longitude [degrees]
   nPar4    Largest possible latitude [degrees]
   nPar5    Smallest value on the X-axis [point]
   nPar6    Smallest value on the Y-axis [point]
   nPar7    Largest value on the X-axis [point]
   nPar8    Largest value on the Y-axis [point]

12        Equidistant Cylindrical Projektion
   cPar1    Longitude of central meridian [degrees]
   cPar2    Latitude of standard parallel [degrees]
   nPar3    False easting [meter]
   nPar4    False nothing [meter]
   nPar5    0.0
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

13        Bonne Pseudoconical Equal Area Projektion
   cPar1    Longitude of origin [degrees]
   cPar2    Latitude of origin [degrees]
   nPar3    False easting [meter]
   nPar4    False nothing [meter]
   nPar5    0.0
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

14        Albers Equal Area Conic Projektion
   nPar1    Latitude of first standard parallel [degrees]
   nPar2    Latitude of second standard parallel [degrees]
   nPar3    Longitude at grid origin [degrees]
   nPar4    Latitude at grid origin [degrees]
   nPar5    False easting at grid origin [meter]
   nPar6    False northing at grid origin [meter]
   nPar7    0.0
   nPar8    0.0

15        Mercator Projektion (1 Standard Parallele)
   nPar1    Longitude of origin [degrees]
   nPar2    Latitude of origin [degrees]
   nPar3    False easting [meter]
   nPar4    False northing [meter]
   nPar5    Scale factor
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

16        American Polyconic Projektion
   cPar1    Longitude of origin [degrees]
   cPar2    Latitude of origin [degrees]
   nPar3    False easting [meter]
   nPar4    False nothing [meter]
   nPar5    0.0
   nPar6    0.0
   nPar7    0.0
   nPar8    0.0

returnWert  Bei erfolgreicher Speicherung der Parameter für das erste
            benutzerdefinierte Koordinatensystem gibt die Funktion TRUE
            zurück, sonst FALSE.


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.