CAMERA API
The Camera API is used for manipulating and controlling the camera using SimConnect SDK. There is also a corresponding API for WASM, which you can find here:
The camera these functions access is a unique camera instance that exists only to be used by add-ons, and it can be acquired using the functions listed below. Camera acquisition is based on a queue, which means that if a client A has acquired the camera, another client B can later "steal" the camera, in which case client A will receive a message informing them that another client possesses the camera. Once client B releases the camera, it will be given back to client A, unless that client has also released it.
It is important to note that just because a client has acquired the camera, it does not mean that the client as all rights on the simulation's cameras and the following circumstances can revoke that control, either temporarily or permanently:
- The simulation can temporarily take back control of the cameras during specific parts of the flow (during menu interactions, when the simulation is paused, during RTC's etc…). Outside of these specific situations, control of cameras will be given back to the add-on which had acquired the dedicated camera previously.
- The user has all rights over the cameras. Through the simulation camera UI panel, the user can revoke the acquisition of the add-on camera and/or forbid its future acquisition.
Under either of the above circumstances, appropriate information will be sent to all clients which have subscribed to the camera event, even if they haven't acquired the camera, so that measures can be taken.
| Function | Description |
|---|---|
SimConnect_CameraAcquire |
Used to acquire the add-on camara, if possible. |
SimConnect_CameraDisableFlag |
Used to disable camera specific features, but only if the camera has been correctly acquired. |
SimConnect_CameraEnableFlag |
Used to enable camera specific features, but only if the camera has been correctly acquired. |
SimConnect_CameraGet |
Used to get the add-on camera settings, regardless of whether it has been acquired or not. |
SimConnect_CameraGetStatus |
Used to get the add-on camera status. |
SimConnect_CameraRelease |
Release a previously acquired camera when no longer required or for other systems to acquire it. |
SimConnect_CameraSet |
Used to set the add-on camera settings, if it has been correctly acquired. |
SimConnect_CameraSetUsingCameraDefinition |
Used to set the add-on camera settings using parameters taken from a predefined camera. |
SimConnect_EnumerateCameraDefinitions |
Used to retrieve an array of all the defined camera names. |
SimConnect_SubscribeToCameraStatusUpdate |
Used to subscribe to camera status update messages. |
SimConnect_UnsubscribeToCameraStatusUpdate |
Used to unsubscribe from camera update messages. |
Related Topics