SDL_SendJoys...ualSensorData(3)

💖 SDL_SendJoystickVirtualSensorData 💖

okay bestie, welcome to the SDL3 FUNCTIONS manual, page SDL_SendJoys...ualSensorData(3) 🎀 this one is literally all about sending a sensor update for an opened virtual joystick. no cap. let's get into it ✨

---

🌸 NAME 🌸

SDL_SendJoystickVirtualSensorData — Send a sensor update for an opened virtual joystick. that's the whole vibe, she does one thing and she does it slayfully 💅

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_joystick.h>

bool SDL_SendJoystickVirtualSensorData(SDL_Joystick *joystick, SDL_SensorType type, Uint64 sensor_timestamp, const float *data, int num_values);

look at her. iconic signature. 🫶

---

✨ DESCRIPTION ✨

okay so this is the part where I have to be the responsible bestie and tell you something important, so listen up 🙈

Please note that values set here will not be applied until the next call to SDL_UpdateJoysticks, which can either be called directly, or can be called indirectly through various other SDL APIs, including, but not limited to the following: SDL_PollEvent, SDL_PumpEvents, SDL_WaitEventTimeout, SDL_WaitEvent.

so basically you're dropping the data off and it sits there like "hi 👋" until one of those functions comes along and actually makes it real. it's giving ✨delayed gratification✨. plan accordingly, queen 👑

---

🌈 FUNCTION PARAMETERS 🌈

• joystick — the virtual joystick on which to set state. that's your girl, the one you're updating 🎮
• type — the type of the sensor on the virtual joystick to update. SDL_SensorType, tell her what she is 💫
• sensor_timestamp — a 64-bit timestamp in nanoseconds associated with the sensor reading. nanoseconds bestie. NANO. ⏱️
• data — the data associated with the sensor reading. the actual numbers, the lore 📊
• num_values — the number of values pointed to by data. count 'em, don't guess 🔢

---

👑 RETURN VALUE 👑

Returns true on success or false on failure; call SDL_GetError() for more information.

so if it's false, don't panic, just hit up SDL_GetError() and she will tell you exactly what went wrong 💀 → 🔍

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread.

not me being able to call this from literally anywhere 😭 multi-threaded main character energy, we love to see it 🔥

---

💜 AVAILABILITY 💜

This function is available since SDL 3.2.0. so if you're on something older... girl. upgrade. 💅

---

⭐ SEE ALSO ⭐

• SDL_SetJoystickVirtualAxis(3)
• SDL_SetJoystickVirtualButton(3)
• SDL_SetJoystickVirtualBall(3)
• SDL_SetJoystickVirtualHat(3)
• SDL_SetJoystickVirtualTouchpad(3)

the whole virtual joystick friend group 🫶 go say hi to all of them.

---

reminder bestie: the sensor data you send here is lowkey just chillin' until SDL_UpdateJoysticks (or one of her indirect besties) runs. don't come for me when nothing happens immediately, I warned you 🙈💖

---

and that's the page!! brought to you by Simple Directmedia Layer, SDL 3.4.18, and this little corner of the SDL3 FUNCTIONS manual, SDL_SendJoys...ualSensorData(3). thanks for reading, ily, go update your joysticks 🎀✨💅