SIMCONNECT_DATA_CAMERA
The SIMCONNECT_DATA_CAMERA structure is a response containing data on the current camera.
Syntax
SIMCONNECT_STRUCT SIMCONNECT_DATA_CAMERA
{
SIMCONNECT_DATA_XYZ Position;
SIMCONNECT_POSITION_REFERENTIAL PositionReferential;
DWORD PositionReferentialObjectId;
SIMCONNECT_DATA_XYZ TargetedPos;
SIMCONNECT_DATA_PBH Pbh;
SIMCONNECT_POSITION_REFERENTIAL RotationReferential;
DWORD RotationReferentialObjectId;
double Fov;
};Members
| Member | Description |
|---|---|
Position | The camera position expressed as a SIMCONNECT_DATA_XYZ struct. The units and values returned will depend of the selected Referential. |
PositionReferential | The reference used to define the position value. One of the following:SimObject - The position is an offset from the simobject position (expressed in meters).SimObject Datum - The position is an offset from the simobject Datum Reference Point (expressed in meters).Eyepoint - The position is an offset from the aircraft pilot eyepoint (expressed in meters).World - The position is expressed using latitude, longitude, and altitude. |
PositionReferentialObjectId | Ignored if is positionReferential set to World.The object Id of the simobject that will be used to set position by SimObject, SimObject Datum and Eyepoint referential.Set to 0 to focus user’s aircraft. If the object Id is invalid, user’s aircraft will be used instead. |
TargetedPos | A 3 value vector (x, y, z) defining the “target” position for the camera. This is used to define a “look at” point for the camera direction/orientation. The units and values returned will depend of the selected Referential. Note that if you set a target position, it will override any values given for Pbh. |
Pbh | The camera pitch, bank, and heading, expressed as a SIMCONNECT_DATA_PBH struct. Note when setting values, if TargetedPos is set, it will override the values given here. |
RotationReferential | The reference used to define the pbh and targetedPosition values. One of the following:SimObject - The position is an offset from the simobject position (expressed in meters).SimObject Datum - The position is an offset from the simobject Datum Reference Point (expressed in meters).Eyepoint - The position is an offset from the aircraft pilot eyepoint (expressed in meters).World - The position is expressed using latitude, longitude, and altitude. |
RotationReferentialObjectId | Ignored if is rotationReferential set to World.The object Id of the simobject that will be used to set rotation by SimObject, SimObject Datum and Eyepoint referential.Set to 0 to focus user’s aircraft. If the object Id is invalid, user’s aircraft will be used instead. |
Fov | The camera field of view, in radians. |
Remarks
This struct will be included in the SIMCONNECT_RECV_CAMERA_DATA struct as a response to to the SimConnect_CameraGet function.