SDL_GetNumCameraDrivers(3)

💖 SDL_GetNumCameraDrivers 💖

okay bestie, so this one is from the SDL3 functions crew (that's the manual name, keeping it cute up top for you 🫶) — and it's literally just "how many camera drivers did we bake into this build?" energy. no cap.

---

✨ NAME ✨

SDL_GetNumCameraDrivers — use this function to get the number of built-in camera drivers. that's it, that's the whole job 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_camera.h>

int SDL_GetNumCameraDrivers(void);

---

🦋 DESCRIPTION 🦋

so the tea is: this function returns a hardcoded number. not vibes-based, not vibing with your hardware, just the literal count.

it never returns a negative value. like, ever. if there are literally no drivers compiled into this build of SDL, you get zero. a whole zero. iconic in its own sad way 😭

⚠️ and here's the part we need to talk about: the presence of a driver in this list does not mean it will function. it just means SDL is capable of interacting with that interface. bestie, that is a whole different thing.

for example — and this is the example, fr fr — a build of SDL might have v4l2 support, but if there's no kernel support available, SDL's v4l2 driver would fail if used. see? listed ≠ working. the vibe check happens later 🧚

by default, SDL tries all drivers, in its preferred order, until one is found to be usable. main character energy: it just keeps going down the list until someone shows up 🔥

---

⭐ RETURN VALUE ⭐

returns the number of built-in camera drivers. a number. that's the whole thing 👑

---

🌈 THREAD SAFETY 🌈

it is safe to call this function from any thread. multitask slay, no locks needed 💜

---

🎀 AVAILABILITY 🎀

this function is available since SDL 3.2.0. so if you're on something older, sorry babe, you're out of luck 🙈

---

💜 SEE ALSO 💜

• SDL_GetCameraDriver(3) — the sibling function, go say hi

---

Simple Directmedia Layer · SDL 3.4.18 · SDL_GetNumCameraDrivers — mwah, that's a wrap bestie, go count some drivers 💅✨🦋