GetPositionEx

This method retrieves the following parameters, which define the camera position and orientation.

Using the Flags parameter you can set the altitude method to HEIGHT_ABSOLUTE to retrieve the height above the terrain database vertical datum. This is more efficient than calling the GetPosition method and translating the height to an absolute value using ITerrain5::GetGroundHeight().

HRESULT GetPosition(

[out] VARIANT* doubleX,

[out] VARIANT* doubleY,

[out] VARIANT* doubleHeight,

[out] VARIANT* doubleYaw,

[out] VARIANT* doublePitch,

[out] VARIANT* doubleRoll,

[out] VARIANT* doubleCameraDeltaYaw,

[out] VARIANT* doubleCameraDeltaPitch,

[in, optional, defaultvalue(0)] long Flags)

Parameters:

• doubleX – 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 a Lat-Long format, the Lat-Long values are presented in decimal degrees.

• doubleY – 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 a Lat-Long format, the Lat-Long values are presented in decimal degrees.

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

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

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

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

• doubleCameraDeltaYaw – The offset between the plane yaw and the camera yaw. See: “Camera and Plane”.

• doubleCameraDeltaPitch – The offset between the plane pitch and the camera pitch.
  See: “Camera and Plane”.

• Flags – Indicates what altitude method is used in the doubleHeight 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: