SDL_GetMaxHapticEffects(3)

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

💖 SDL_GetMaxHapticEffects 💖

okay bestie, welcome to the SDL_GetMaxHapticEffects(3) page, straight out of the SDL3 FUNCTIONS shelf 🎀 this one lives in the manual, and it's literally about how many haptic effects your lil rumbly device can hold in its brain at once. slay.

✨ NAME ✨

SDL_GetMaxHapticEffects — get the number of effects a haptic device can store. no cap, that's the whole job 💅

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_haptic.h>

int SDL_GetMaxHapticEffects(SDL_Haptic *haptic);

look at her. one include, one function call, zero drama 🦋

💫 DESCRIPTION 💫

so here's the tea: on some platforms this isn't fully supported, and therefore it's an approximation. like, it's giving "best guess" energy, not "certified truth" energy 😭

⚠️ Always check to see if your created effect was actually created and do not rely solely on SDL_GetMaxHapticEffects(). ⚠️

fr fr, do not just trust the number and vibe off into the sunset. verify your effect actually exists. that's the move 👑

🫶 FUNCTION PARAMETERS 🫶

  • haptic — the SDL_Haptic device to query. that's the one you're asking "how many effects can u hold bestie" 💜

🔥 RETURN VALUE 🔥

Returns the number of effects the haptic device can store, or a negative error code on failure 😭 and if it fails? call SDL_GetError() for more information, she'll tell you what went wrong 🍓

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. iconic behavior honestly 💅

👑 SEE ALSO 👑

go read those too, iykyk 🌈

okay that's the whole page bestie!! this was brought to you by Simple Directmedia Layer, version SDL 3.4.18 — mwah, love u, go make something rumble 💖✨🎀

📦 where this page comes from