pe_coordsys_to_string_ext

Creates an extended string representation of a coordsys object

Usage syntax

void pe_coordsys_to_string_ext (PE_COORDSYS coordsys, int mode, char buffer[PE_BUFFER_MAX]);

Parameters
coordsys A horizontal coordinate system object
mode The mode of the string representation
buffer The string representation of the object
Description

This function creates an extended string representation of a coordinate system object.

The values for the mode parameter are:

   PE_STR_AUTH_NONE   0  /* No authority information */
   PE_STR_AUTH_TOP    1  /* Only include authority information for the top-level object */
   PE_STR_AUTH_ALL    2  /* Include authority information for all objects */

In pe_coordsys_to_string_ext, the coordinate system is considered the top-level object. Thus, any subobjects, such as the DATUM and SPHEROID in a geographic coordinate system, would not include authority information if the mode is set to PE_STR_AUTH_TOP.

Returns

None

Examples

Mode is set to PE_STR_AUTH_ALL:

GEOGCS["GCS_Deutsches_Hauptdreiecksnetz",DATUM["D_Deutsches_Hauptdreiecksnetz",SPHEROID["Bessel_1841",6377397.155,299.1528128,AUTHORITY["EPSG",7004]],AUTHORITY["EPSG",6314]],PRIMEM["Greenwich",0.0,AUTHORITY["EPSG",8901]],UNIT["Degree",0.0174532925199433,AUTHORITY["EPSG",9102]],AUTHORITY["EPSG",4314]]

Mode is set to PE_STR_AUTH_TOP:

GEOGCS["GCS_Deutsches_Hauptdreiecksnetz",DATUM["D_Deutsches_Hauptdreiecksnetz",SPHEROID["Bessel_1841",6377397.155,299.1528128]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433],AUTHORITY["EPSG",4314]]