Translates a point from one coordinate system to another.

See Also | Example

Signature

RetVal = object.TranslateCoordinates(OriginalPoint, From, To, Disp[, OCSNormal])

Object

Utility
The object or objects this method applies to.

OriginalPoint

Variant (three-element array of doubles); input-only
The 3D WCS coordinates specifying the original coordinates to be translated. This parameter can be treated as a point or a displacement vector depending on the value of Disp.

From

AcCoordinateSystem enum; input-only
The coordinate system from which the point originates.

acWorld

acUCS

acOCS

acDisplayDCS

acPaperSpaceDCS

To

AcCoordinateSystem enum; input-only
The coordinate system to which the point will be converted.

acWorld

acUCS

acOCS

acDisplayDCS

acPaperSpaceDCS

Disp

Integer; input-only
A displacement vector flag.

TRUE: OriginalPoint is treated as a displacement vector.

FALSE: OriginalPoint is treated as a point.

OCSNormal

Variant (three-element array of doubles); input-only;optional
The normal for the OCS.

RetVal

Variant (three-element array of doubles)
The translated 3D coordinate.

Remarks

You cannot directly translate a coordinate from one OCS to another OCS. To do this, first translate the coordinate from one OCS to an intermediary coordinate system such as the WCS. Then translate that coordinate into the second OCS.

To translate a point on a Polyline or LightWeightPolyline object from OCS to WCS:

1. Get the X and Y coordinates of the OCS point from the Coordinate or Coordinates property.

2. Get the Z coordinate of the OCS point from the Elevation property.

3. Get the Normal for the polyline from the Normal property.

4. Call TranslateCoordinates using the X, Y, Z coordinates and the Normal.