SDL_GPUTextureRegion(3type)

✨ SDL_GPUTextureRegion ✨

okay bestie, welcome to the SDL_GPUTextureRegion page — it's a SDL3 DATATYPES moment, and honestly? it's giving "small struct, big responsibilities". 🎀

---

🌸 NAME 🌸

SDL_GPUTextureRegion — a structure specifying a region of a texture. literally just a lil rectangle (or box, we love a 3D queen 👑) inside a texture. that's it. that's the vibe.

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_gpu.h>

typedef struct SDL_GPUTextureRegion
{
    SDL_GPUTexture *texture;  /**< The texture used in the copy operation. */
    Uint32 mip_level;         /**< The mip level index to transfer. */
    Uint32 layer;             /**< The layer index to transfer. */
    Uint32 x;                 /**< The left offset of the region. */
    Uint32 y;                 /**< The top offset of the region. */
    Uint32 z;                 /**< The front offset of the region. */
    Uint32 w;                 /**< The width of the region. */
    Uint32 h;                 /**< The height of the region. */
    Uint32 d;                 /**< The depth of the region. */
} SDL_GPUTextureRegion;

like. look at her. nine fields, zero drama. 💅

---

💖 DESCRIPTION 💖

Used when transferring data to or from a texture. that's the whole plot fr fr — you're pointing at a specific slice of a texture so the GPU knows exactly which pixels you mean. no guessing, no "eh just copy the whole thing". you're being precise, and honestly? iconic.

---

🌈 AVAILABILITY 🌈

This struct is available since SDL 3.2.0. so if you're on anything older, bestie... no she is not there yet 😭

---

👑 SEE ALSO 👑

• SDL_UploadToGPUTexture(3) — the "get this data INTO the texture" bestie 🫶
• SDL_DownloadFromGPUTexture(3) — the "get this data OUT of the texture" bestie 🫶
• SDL_CreateGPUTexture(3) — where the texture itself comes from ✨
• SDL_GPUTexture(3type) — the texture type this region lives inside 🌸

---

and that's the whole page, bestie!! this lil love letter to the GPU was brought to you by Simple Directmedia Layer, SDL 3.4.18 edition — mwah, go forth and copy textures responsibly 💖✨🎀🦋🌸💅🫶