FlyTo

This method instructs the plane to fly to the point of interest specified by X, Z and Height. The Distance parameter specifies at which distance from the point of interest the plane should stop. The Yaw and Pitch parameters are interpreted according to the last parameter.

HRESULT FlyTo(

[in] double X,

[in] double Z,

[in] double Height,

[in] double Distance,

[in] double Yaw,

[in] double Pitch,

[in] BSTR Pattern)

Parameters:

• X – The West-East coordinate of the camera position represented in MPT units. You can use the ITerrain interface to retrieve information about the MPT units. If you are working in Lat-Long format, the Lat-Long values are presented in Lat-Long.

• Z – The North-South coordinate of the camera position represented in MPT units. You can use the ITerrain interface to retrieve information about the MPT units. If you are working in Lat-Long format, the Lat-Long values are in decimal Lat-Long.

• Height – The height of the camera, in meters.

• Distance – The distance from the camera to the point of interest.

• Yaw – The Yaw angle of the plane. See: “Yaw, Pitch and Roll Angles”.

• Pitch – The Pitch angle of the plane. See: “Yaw, Pitch and Roll Angles”.

• Pattern – A string that instructs the plane on how to approach and focus in on the object. The Pattern parameter can be one of the following:

• “FlyToLocation”–The Yaw parameter specifies from which direction the point of interest is to be viewed and the Pitch parameter specifies what should be the Pitch of the camera at that point.

• “JumpToLocation”– Immediately jumps to the end point of a “FlyToLocation” pattern.

• “FlyToTerrain” – The Pitch parameter is ignored. The pitch of the camera at the destination is always -30 degrees. The Yaw parameter is ignored and the plane’s yaw is determined by the direction from which the plane arrives at the point of interest

• “Circle” – Makes the plane circle the point of interest at the given distance. The Yaw and Pitch parameters are ignored.

• "Oval"  – Makes the plane move around the point of interest in an oval pattern. The Yaw and Pitch parameters are ignored.

•  “Line” – Makes the plane move around the point of interest in a line pattern. The Yaw and Pitch parameters are ignored.

• “Arc” – Makes the plane move around the point of interest in an arc pattern. The Yaw and Pitch parameters are ignored.

Return Values:

S_OK if the method call succeeded.