SimConnect_RequestCameraWorldLocker
The SimConnect_RequestCameraWorldLocker function is used to set a locker in the world to load the terrain, scenery and objects around it, but only if you have acquired the camera first. This is useful if you wish to move the camera far from the user aircraft where the world data may have been unloaded from memory.
Syntax
HRESULT SimConnect_RequestCameraWorldLocker(
HANDLE hSimConnect,
SIMCONNECT_DATA_XYZ lockerPosition,
SIMCONNECT_POSITION_REFERENTIAL referential,
DWORD objectId
);
Parameters
| Parameter | Description | Type |
|---|---|---|
hSimConnect | Handle to a SimConnect object. | Integer |
lockerPosition | Coordinates of the locker, depending of the selected referential | SIMCONNECT_DATA_XYZ |
referential | The reference used to define the
| SIMCONNECT_POSITION_REFERENTIAL |
objectId | Ignored if is 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. | Integer |
Return Values
The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return value | Description |
|---|---|
| S_OK | The function succeeded. |
| E_FAIL | The function failed. If the camera locker failed to be setup, SimConnect will raise a SIMCONNECT_EXCEPTION_CAMERA_API exception to let you know that the operation failed (refer to the SIMCONNECT_EXCEPTION enum for more details). |
Example
HANDLE hSimConnect = NULL;
SIMCONNECT_DATA_XYZ LFPG_LLA{ 49.0083899664, 2.53844117956, 320 };
SimConnect_RequestCameraWorldLocker(hSimConnect, LFPG_LLA, SIMCONNECT_POSITION_REFERENTIAL_WORLD, 0);
Remarks
The sim will send a SIMCONNECT_RECV_CAMERA_WORLD_LOCKER to the client at the end of acquisition which you can use to check the camera has been properly acquired. It’s handled through SimConnect_CallDispatch.