pe_geoxyzcs_new

Creates a new geocentric coordinate system

Usage syntax

PE_GEOXYZCS pe_geoxyzcs_new (const char *name, PE_GEOGCS geogcs, PE_UNIT unit);

Parameters
name Name of the new geocentric coordinate system
geogcs The geographic coordinate system
unit Geocentric coordinate system linear units
Description

This function defines a new geocentric coordinate system with the specified attributes. 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.

Returns

On success, the new coordinate system with the attributes equal to the corresponding arguments. On failure, a null pointer.

Examples
PE_GEOGCS wgs84;
PE_UNIT m;
m = pe_factory(PE_U_METER);
wgs84 = pe_factory(PE_GCS_WGS_1984);

PE_GEOXYZCS gcs = pe_geoxyzcs_new("GCS1", wgs84, m);