Prototype and description of the function getusercoordtyp() (Function of the unlock requiring group "User definitions") |
getusercoordtyp() Determination of the designation of a projection method. Prototype of the DLL function in C++ syntax (attend lower case!): extern "C" __declspec(dllimport) unsigned long __stdcall getusercoordtyp( unsigned short nProjNo, char **pszProjName); Prototype of the DLL function in Visual Objects syntax: _DLL function getusercoordtyp(; nProjNo as word,; // 2 Byte pszProjName ref psz); // 4 Byte, char**, 80 alloc. as logic pascal:geodll32.getusercoordtyp // 4 Byte The allocation of memory for "ref psz" / "char**" is necessary only if setstringallocate(FALSE) is called before. The function returns the designations of the projection method fitting to nProjNo as formatted text in the variable pszProjName. The text is returned in the language set by the function setLanguage() before. The parameters are passed and/or returned as follows: nProjNo (Projection method) Designation of the projection method 1 Transverse Mercator Projection 2 Transversal Mercator meridian strip system 3 Lambert Conformal Conic Projection (1 standard parallel) 4 Lambert Conformal Conic Projection (2 standard parallel) 5 Oblique Conformal Conic Projection (e.g. Czech Republic) 6 Oblique Mercator Projection (e.g. Switzerland, Alaska) 7 Oblique Stereographic Projection (z.B. Netherlands) 8 Quasi Stereographic Projection (e.g. Poland) 9 Cassini Soldner Projection 10 Lambert Azimuthal Equal Area Projection 11 Orthogonal output device Projection 12 Equidistant Cylindrical Projection 13 Bonne Pseudoconical Equal Area Projection 14 Albers Equal Area Conic Projection 15 Mercator Projection (1 standard parallel) 16 American Polyconic Projection 99 Geographic Projection pszProjName The designations of the projection method is returned (ref) as formatted text as reference. Note: "ref pszProjName" corresponds to "char**" in C. 80 bytes of memory for the zero terminated string must be allocated with dependence to the call of the function setstringallocate(). Please consider the notes in the description of the function setstringallocate(). returnVal In case of an error the function returns FALSE, otherwise TRUE. The returned string looks depending upon the selected projection method e.g. like this: Transversal Mercator meridian strip system or Quasi Stereographic Projection Unlocking: This function is a component of the unlock requiring function group "user definitions". It is unlocked for unrestricted use together with the other functions of the group by passing the unlock parameters, acquired from the software distribution company, trough the function setunlockcode(). Without unlocking only a few function calls for test purposes (shareware principle) are possible. |