(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_GetCameraPosition

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

Header File

Syntax

SDL_CameraPosition SDL_GetCameraPosition(SDL_CameraID instance_id);

Function Parameters

SDL_CameraID

instance_id

the camera device instance ID.

Return Value

(SDL_CameraPosition) 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 distinction 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.1.3.