Prototype and description of the function getusercoordpar()

(Function of the unlock requiring group "User definitions")


Determination of the parameters designations of a projection method.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall getusercoordpar(
     unsigned short nProjNo,
     char **pszProjPar);

Prototype of the DLL function 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

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 parameters, fitting
to the projection method nProjNo, as formatted text in the variable
pszProjPar. 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

pszProjPar  The designations of the projection method parameters are
(ref)       returned as formatted text by reference.
            Note: "ref pszProjPar" corresponds to "char**" in C. 500 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

returnVal   In case of an error the function returns FALSE, otherwise TRUE.

The returned text string looks depending of the selected coordinate
projection e.g. like this:
   Latitude 1. standard parallel [degrees]
   Latitude 2. standard parallel [degrees]
   Longitude of grid origin [degrees]
   Latitude of grid origin [degrees]
   False easting [meter]
   False northing [meter]

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.