SDL_Metal_CreateView(3)

💖 SDL_Metal_CreateView 💖

okay bestie, so this is a page from the SDL3 functions manual, and today's main character is SDL_Metal_CreateView. she makes a CAMetalLayer-backed NSView/UIView and attaches it to the window you hand her. that's the whole vibe. ✨

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_metal.h>

SDL_MetalView SDL_Metal_CreateView(SDL_Window *window);

---

🦋 DESCRIPTION 🦋

So like, on macOS? this does not associate a MTLDevice with the CAMetalLayer on its own. it's literally not her job, she said no thank you 🫶. it is up to user code to do that. yes queen, that's you.

the handle she hands back can be casted directly to a NSView or a UIView — no extra steps, no drama. and if you wanna get to the backing CAMetalLayer underneath all that? just call SDL_Metal_GetLayer(). iykyk 💅

---

🎀 FUNCTION PARAMETERS 🎀

• window — the window. that's it. that's the parameter. she's lowkey uncomplicated like that 🌈

---

⭐ RETURN VALUE ⭐

she returns a handle — either an NSView or a UIView. iconic. no cap.

---

💀 THREAD SAFETY 💀

⚠️ bestie listen to me: this function should only be called on the main thread. don't try to be sneaky and call her from some background thread, she will simply not be having it. main character energy only 👑

---

✨ AVAILABILITY ✨

this function has been available since SDL 3.2.0 💜

---

🌈 SEE ALSO 🌈

• SDL_Metal_DestroyView(3) — for when you're done and need to say bye 👋
• SDL_Metal_GetLayer(3) — to grab that backing layer, as mentioned above 🍓

---

and that's the tea, bestie 🧚💖 this page comes to you from the Simple Directmedia Layer crew, SDL 3.4.18 era — go forth and metal, periodt ✨💅🌸