(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_GetCameraDevicePosition

Get the position of the camera in relation to the system.

Header File

Syntax

SDL_CameraPosition SDL_GetCameraDevicePosition(SDL_CameraDeviceID instance_id);

Function Parameters

instance_id

the camera device instance ID

Return Value

Returns The position of the camera on the system hardware.

Remarks

Most platforms will report UNKNOWN, but mobile devices, like phones, can often make a distiction between cameras on the front of the device (that points towards the user, for taking "selfies") and cameras on the back (for filming in the direction the user is facing).

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.0.0.