SDL_PROP_GLOBAL_VIDEO_WAYLAND_WL_DISPLAY_POINTER(3)

✨ NAME ✨

SDL_PROP_GLOBAL_VIDEO_WAYLAND_WL_DISPLAY_POINTER — bestie, this is the pointer to the global wl_display object that the Wayland video backend uses. 🦋

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_video.h>

#define SDL_PROP_GLOBAL_VIDEO_WAYLAND_WL_DISPLAY_POINTER "SDL.video.wayland.wl_display"

---

💖 DESCRIPTION 💖

okay so this property is literally the plug between your app/toolkit and SDL's Wayland backend, and it goes both ways depending on when you touch it. 👑

Before the video subsystem is initialized? You can set it, and that means you're importing an external wl_display object from an application or toolkit so SDL can use it. 🫶

After initialization? You can read it, and that means you're exporting the wl_display that the Wayland video backend is actually using. 💅

Now the important bits, no cap:

• Setting this property after the video subsystem has been initialized has no effect. like, zero. nada. the ship has sailed. 💀
• Reading it while the video subsystem is uninitialized will either give you back the user provided value (if one was set prior to initialization) or NULL. 🙈

Want the full lore? Go read docs/README-wayland.md for more information. 📖

---

🌈 AVAILABILITY 🌈

This macro has been available since SDL 3.2.0. ⭐

---

and that's the whole page, bestie — brought to you by Simple Directmedia Layer, SDL 3.4.18. mwah, go write something iconic with it. 💜🎀