SDL_GetRenderMetalLayer(3)

✨ NAME ✨

SDL_GetRenderMetalLayer — bestie, this one hands you the CAMetalLayer that's vibing with your Metal renderer 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_render.h>

void * SDL_GetRenderMetalLayer(SDL_Renderer *renderer);

---

🦋 DESCRIPTION 🦋

Okay so here's the tea ☕: this function returns a void *. Why, you ask? Because SDL said "not me dragging Metal's headers into everything" — that way SDL doesn't have to include them at all 🙈. But don't panic, the pointer is legit, and you can safely cast it to a CAMetalLayer *. No cap, that's literally the whole point 🫶

---

🎀 FUNCTION PARAMETERS 🎀

• renderer — the renderer you're querying, i.e. the one you want the layer for. That's it, that's the whole ask 💖

---

💜 RETURN VALUE 💜

On success you get a CAMetalLayer * back, slay ✨. If the renderer isn't a Metal renderer, you get NULL — so like, vibe check that thing before you use it, fr fr 😭

---

🔥 THREAD SAFETY 🔥

This function should only be called on the main thread. Do not be out here calling it from a worker thread, bestie, that's not the move 💀

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0 — so if you're on something older, it's giving "not yet, babe" 🧚

---

⭐ SEE ALSO ⭐

• SDL_GetRenderMetalCommandEncoder(3) — the other Metal-flavored bestie you're gonna want next 👑

---

k byeee, go forth and render responsibly 🌸💅✨ — this page came to you from the Simple Directmedia Layer crew, SDL version 3.4.18, and it's the SDL_GetRenderMetalLayer(3) page, mwah 😘