SetGroupLocation

Determines the location parameters for the specified group.

HRESULT SetGroupLocation(

 [in] long GroupID,

 [in] double X,

 [in] double Y,

 [in] double Height,

 [in] double Distance,

 [in, defaultvalue(0)] double Yaw,

 [in, defaultvalue(-50)] double Pitch,

 [in, defaultvalue(0)] long Flags)

Parameters:

• GroupID – Refers to the group whose location you are about to change. You can obtain the GroupID by one of the following methods:

• Create the group using IInformationTree5::CreateGroup.

• Find the group, if you know the name, using IInformationTree5::FindItem.

• Traverse the Tree using IInformationTree5 methods such as GetNextItem(), until you come to the desired GroupID.

• X – The East-West 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, the Lat-Long values are presented in Lat-Long decimals.

• Y – 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, the Lat-Long values are presented in Lat-Long decimals.

• Height – The height of the camera, in meters. The interpretation of this parameter depends on the Flags parameter

• 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”.

• Flags – Indicates what altitude method is used in the height parameter. This parameter can be any of the following values:

• HEIGHT_AGL = 4096
  The height is above the ground.

• HEIGHT_ABSOLUTE     = 8192
  The height is above the terrain database vertical datum base ellipsoid.

• Return Values:

The return value obtained from the returned HRESULT can be one of the following: