SE_shape_set_coordref

Sets the coordinate system of a shape

Usage syntax

LONG SE_shape_set_coordref (SE_SHAPE shape, SE_COORDREF coordref);

Parameters
shape A handle to an active shape object
coordref A pointer to a coordinate reference structure that defines the coordinate system
Description

SE_shape_set_coordref sets the coordinate reference system of a shape.

The existing geometry of the shape becomes indeterminate because is not recreated to the new coordinate reference system.
Since the interpretation of the shape's geometry depends on the shape's coordinate reference system, the shape's geometry must be recreated with a shape generation function (i.e. SE_shape_generate_point) to correct for the new coordinate reference system.

The SE_shape_change_coordref function recreates a shape's existing geometry from the previous coordinate reference system to a new coordinate reference system. Using SE_shape_change_coordref function avoids the need to manually recreate the shape's geometry since it automatically performs this task when it changes the shapes coordinate reference system.

Returns

SE_SUCCESS
SE_CAD_EXISTS

SE_INVALID_COORDREF_OBJECT

SE_INVALID_SHAPE_OBJECT

Notes

∙  If the source shape has a CAD entity, the SE_CAD_EXISTS error is returned.