SDL_GetCameraPermissionState(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_GetCameraPermissionState — the SDL3 functions era 💖

okay bestie, welcome to the SDL_GetCameraPermissionState(3) page, it's giving permission check and it's lowkey the most important lil function in your camera arc ✨

🌸 NAME 🌸

SDL_GetCameraPermissionState — query if camera access has been approved by the user 🎀

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_camera.h>

SDL_CameraPermissionState SDL_GetCameraPermissionState(SDL_Camera *camera);

✨ DESCRIPTION ✨

so here's the tea, bestie: cameras will not function between when the device is opened by the app and when the user permits access to the hardware. the way that works is platform-dependent, like:

  • 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:

  • SDL_CAMERA_PERMISSION_STATE_PENDING if waiting for user response ⏳
  • SDL_CAMERA_PERMISSION_STATE_APPROVED if the camera is approved for use ✅
  • SDL_CAMERA_PERMISSION_STATE_DENIED 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. no cap 🔥

If a camera is declined, there's nothing to be done but call SDL_CloseCamera() to dispose of it. that's it, that's the whole vibe check 😭

🎀 FUNCTION PARAMETERS 🎀

  • camera — the opened camera device to query. that's your main character right there 👑

🌈 RETURN VALUE 🌈

Returns an SDL_CameraPermissionState value indicating if access is granted, or SDL_CAMERA_PERMISSION_STATE_PENDING if the decision is still pending. like, the suspense is real bestie ⭐

💜 THREAD SAFETY 💜

It is safe to call this function from any thread. periodt. go off, multithreaded icon 💅

🫶 AVAILABILITY 🫶

This function is available since SDL 3.2.0. so if you're on something older… yeah no, it's not there, sorry bestie 🍓

👑 SEE ALSO 👑

and that's the whole page!! 💖 this lil beauty came to you from Simple Directmedia Layer, version SDL 3.4.18, and it's the SDL_GetCameraPermissionState(3) page — go ask your users for permission, bestie, it's literally the polite thing to do 🌸✨🎀

📦 where this page comes from