SDL_HINT_AUD...APP_ICON_NAME(3)

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

✨ NAME ✨

SDL_HINT_AUDIO_DEVICE_APP_ICON_NAME — bestie, this is the hint that lets you say "hey, here's my app's icon name" for an audio device. 💖

(it lives in the SDL3 FUNCTIONS manual, iykyk)

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_AUDIO_DEVICE_APP_ICON_NAME "SDL_AUDIO_DEVICE_APP_ICON_NAME"

🎀 DESCRIPTION 🎀

okay so listen. Some audio backends — like Pulseaudio and Pipewire — let you set an XDG icon name for your app. And among other things? That icon might literally show up in a system control panel where the user can adjust the volume on specific audio streams, instead of being stuck with one giant master volume slider. it's giving ✨granular control✨.

⚠️ Not me reminding you: this is unrelated to the icon the windowing system uses, which may be set with SDL_SetWindowIcon (or via a desktop file on Wayland). two totally different vibes, don't mix them up 💅

If you set this to "" or just leave it unset, SDL will use a reasonable default — "applications-games" — which is likely to be installed already. no stress, she's got you 🫶

The relevant XDG icon specs live here if you wanna read the lore:

🚨 IMPORTANT: this hint should be set before an audio device is opened. Timing is everything, bestie. set it late and it simply will not hit. 😭

🌈 AVAILABILITY 🌈

This hint is available since SDL 3.2.0. ⭐

and that's the whole page, no cap 🧚💜 — signed off by Simple Directmedia Layer, SDL 3.4.18, periodt. 👑

📦 where this page comes from