logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_GetCameraPermissionState - Query if camera access has been approved by the user.

Availability

       This function is available since SDL 3.2.0.

Description

       Cameras  will  not function between when the device is opened by the app and when the user permits access
       to the hardware. On some platforms, this presents as a popup dialog where  the  user  has  to  explicitly
       approve access; on others the approval might be implicit and not alert the user at all.

       This  function  can  be  used to check the status of that approval. It will return 0 if still waiting for
       user response, 1 if the camera is approved for use, and -1 if the user denied access.

       Instead of  polling  with  this  function,  you  can  wait  for  a  SDL_EVENT_CAMERA_DEVICE_APPROVED  (or
       SDL_EVENT_CAMERA_DEVICE_DENIED) event in the standard SDL event loop, which is guaranteed to be sent once
       when permission to use the camera is decided.

       If a camera is declined, there's nothing to be done but call SDL_CloseCamera() to dispose of it.

Function Parameters

camera the opened camera device to query.

Name

       SDL_GetCameraPermissionState - Query if camera access has been approved by the user.

Return Value

       Returns -1 if user denied access to the camera, 1 if user approved access, 0 if no decision has been made
       yet.

See Also

SDL_OpenCamera(3), SDL_CloseCamera(3)

Simple Directmedia Layer                           SDL 3.2.20                    SDL_GetCameraPermissionState(3)

Synopsis

#include<SDL3/SDL_camera.h>intSDL_GetCameraPermissionState(SDL_Camera*camera);

Thread Safety

       It is safe to call this function from any thread.

See Also