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 give the X and Y coordinates, elevation relative to the terrain database vertical datum base ellipsoid (absolute height), Yaw Pitch and Roll values, in doubleX, doubleY, doubleElevation, doubleYaw, Pitch and Roll respectively. To define the movement, give 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). After the method is completed, the doubleX,doubleY, doubleElevation, and doubleYaw returns the new coordinate.
HRESULT MoveCoordEx(
[in, out] VARIANT* doubleX,
[in, out] VARIANT* doubleY,
[in, out] VARIANT* doubleElevation,
[in, out] VARIANT* doubleYaw,
[in] double Pitch,
[in] double Roll,
[in] double moveForward,
[in] double moveRight,
[in] double moveUp)
Parameters:
doubleX – X coordinate.
doubleY – Y coordinate.
doubleElevation – Elevation value relative to the terrain database vertical datum base ellipsoid (absolute height).
doubleYaw – The Yaw angle of the direction.
Pitch – The pitch angle of the direction.
Roll – The roll angle of the direction.
moveForward – The offset in meters to move the point forward. Positive values move the forward, negative values move backwards.
moveRight – The offset in meters 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 in meters to move the point up and down. Positive values move the point up, negative values move the point down.
Return Values:
The return value obtained from the returned HRESULT can be one of the following:
Return value |
Meaning |
S_OK |
Success. |
TE_E_INTERNAL |
TerraExplorer internal error. |