SDL_UpdateYUVTexture(3)

💖 SDL_UpdateYUVTexture(3) 💖

okay bestie, this one lives in the SDL3 functions lineup, and it's literally the glow-up you need when your pixel data is giving scattered instead of stacked. Let's get into it 🫶

---

✨ NAME ✨

SDL_UpdateYUVTexture — update a rectangle inside a planar YV12 or IYUV texture with brand new pixel data. no cap.

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_render.h>

bool SDL_UpdateYUVTexture(SDL_Texture *texture,
                     const SDL_Rect *rect,
                     const Uint8 *Yplane, int Ypitch,
                     const Uint8 *Uplane, int Upitch,
                     const Uint8 *Vplane, int Vpitch);

---

💅 DESCRIPTION 💅

so here's the tea ☕ — you can just use SDL_UpdateTexture() as long as your pixel data is one contiguous block of Y and U/V planes all sitting in the proper order. that's the chill scenario, the easy path, the main character who has their life together.

BUT. if your pixel data is not contiguous — like the planes are living in separate places, doing their own thing, not even texting each other — then this function is the one for you. it exists specifically for that situation. periodt. 💖

---

🎀 FUNCTION PARAMETERS 🎀

• texture — the texture you're updating, aka the thing getting the glow-up.
• rect — a pointer to the rectangle of pixels you want to update, or NULL to update the entire texture. yes, NULL means all of it, go big or go home.
• Yplane — the raw pixel data for the Y plane. the raw stuff. unfiltered. 🙈
• Ypitch — the number of bytes between rows of pixel data for the Y plane. that's the stride, the step, the how-far-apart-are-my-rows situation.
• Uplane — the raw pixel data for the U plane.
• Upitch — the number of bytes between rows of pixel data for the U plane.
• Vplane — the raw pixel data for the V plane.
• Vpitch — the number of bytes between rows of pixel data for the V plane.

---

⭐ RETURN VALUE ⭐

returns true on success or false on failure 🥲 and if it fails, hit up SDL_GetError() for more info. she will tell you what went wrong, she's very forthcoming.

---

🦋 THREAD SAFETY 🦋

heads up bestie: this function should only be called on the main thread. do not try to be cute and call it from a worker thread. it's giving "main character energy" for a reason — main thread only. 💀

---

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. so if you're on something older, no dice, sorry babes.

---

👑 SEE ALSO 👑

• SDL_UpdateNVTexture(3)
• SDL_UpdateTexture(3)

go read those too, they're also iconic in their own way.

---

Simple Directmedia Layer · SDL 3.4.18 · SDL_UpdateYUVTexture(3)

and that's the whole page, bestie 🎀💖 stay planar, stay pitched, and may your rectangles always be within bounds ✨🦋