| SE_shape_change_coordref | |
Projects a shape to a new coordinate system.
LONG SE_shape_change_coordref (const SE_SHAPE src_shape, SE_COORDREF coordref, PE_GEOGTRAN geogtran, SE_SHAPE tgt_shape);
| src_shape | A handle to an active shape object |
| coordref | A pointer to a coordinate reference structure that defines the new coordinate system for the shape |
| geogtran | A pointer to a Projection Engine geographic (datum) transformation object. Can be a null pointer. |
| tgt_shape | A handle to an active shape object, returned as the new shape |
Projects a shape to a new coordinate system. If geogtran is null, the two coordinate systems are assumed to be based on the same datum. If they aren’t and geogtran is null, the error SE_PROJECTION_ERROR is returned. If the two coordinate systems are on different datums, you must create a geographic transformation object which specifies how to convert the datums. Consider using the predefined transformations with the pe_factory functions.
For example,
PE_GEOGTRAN gt = pe_factory(PE_GT_NAD_1927_TO_WGS_1984_4);
creates a geographic transformation object that converts between NAD27 and WGS84 in the contiguous United States.
SE_SUCCESS
SE_CAD_EXISTS
SE_COORD_OUT_OF_BOUNDS
SE_INCOMPATIBLE_COORDREFS
SE_INVALID_COORDREF_OBJECT
SE_INVALID_SHAPE
SE_INVALID_SHAPE_OBJECT
SE_OUT_OF_CLMEM
SE_PROJECTION_ERROR
SE_READ_ONLY_SHAPE
SE_SHAPE_INTEGRITY_ERROR
SE_TOO_FEW_POINTS
• If you pass a shape returned from SE_stable_search or SE_stable_get_shape to ‘tgt_shape’, the SE_READ_ONLY_SHAPE error is returned. See ‘Shape table functions’ for more information.
• If the source shape has a CAD entity, the SE_CAD_EXISTS error is returned.