pe_geoxyzcs_to_string

Creates an extended string representation of a geocentric coordinate system

Usage syntax

void pe_geoxyzcs_to_string_ext (PE_GEOXYZCS geoxyzcs, int mode, char buffer[PE_BUFFER_MAX]);

Parameters

geoxyzcs	The geoxyzcs 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 geocentric coordinate system object. A geocentric coordinate system is a 3D Cartesian system. The X axis lies in the plane of the equator and points in the direction of the prime meridian (usually Greenwich). The Y axis is 90 degrees away in the plane of the equator, and the Z axis points north in a right-handed system.

Note: Currently, geocentric coordinate systems are not supported by the ArcSDE or ArcGIS software.

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_geoxyzcs_to_string_ext, the GEOXYZCS is considered the top-level object. Thus any subobjects like the GEOGCS 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:

GEOXYZCS["test",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]],UNIT["Meter",1.0,AUTHORITY["EPSG",9001]]]