MoveByOrientation

With this method you can define an orientation for a coordinate system and move a 3D-coordinate along it by a specified Forward-Backward, Right-Left and Up-Down offset. To define the point and orientation, set the X and Y coordinates, altitude relative to the terrain database vertical datum base ellipsoid (absolute height), Yaw Pitch and Roll values, in the IPosition80 properties. To define the movement, set the forward, right, and up values in moveForward, moveRight and moveUp respectively. Use negative values to move in the opposite direction (e.g., negative value for moveForward performs a backward movement). This method replaces the deprecated ICoordServices80.MoveCoordEx method.

Note: The rotation parameters are applied to the 3D coordinate in the following order: Roll, Pitch, Yaw.

JavaScript

MoveByOrientation(

moveForward,

moveRight,

moveUp)

IPosition80 MoveByOrientation (

double moveForward,

double moveRight,

double moveUp)

C++

HRESULT MoveByOrientation (

double moveForward,

double moveRight,

double moveUp

IPosition80** pVal)

Parameters

moveForward

The offset to move the point forward. Positive values move the forward, negative values move backwards.

moveRight

The offset to move the point to the right and left. Positive values move the point to the right, negative values move the point to the left.

moveUp

The offset to move the point up and down. Positive values move the point up, negative values move the point down.

Return Value

Position

An IPosition80 representing the 3D coordinate being moved.

Exceptions

See: HRESULT Return Values for a list of possible values returned by the HRESULT.