SDL_ScaleSurface(3)

💖 SDL_ScaleSurface(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the group chat, where today's main character is SDL_ScaleSurface — she makes a brand new surface that's identical to the one you already have, except scaled to the size you want. glow up, but for pixels. ✨

---

🌸 NAME 🌸

SDL_ScaleSurface — creates a new surface identical to the existing surface, scaled to the desired size. literally a copy of your surface but resized, no cap 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_surface.h>

SDL_Surface * SDL_ScaleSurface(SDL_Surface *surface, int width, int height, SDL_ScaleMode scaleMode);

---

🦋 DESCRIPTION 🦋

so you hand her a surface and a target size and she hands you back a whole new surface, scaled. iconic.

⚠️ important bestie!! the returned surface should be freed with SDL_DestroySurface(). she is NOT a borrow, she's yours to clean up. don't ghost her, free her. 😭

---

✨ FUNCTION PARAMETERS ✨

• surface — the surface to duplicate and scale. your OG. the blueprint. 🫶
• width — the width of the new surface. how wide we're going. 📏
• height — the height of the new surface. how tall we're going. 📐
• scaleMode — the SDL_ScaleMode to be used. pick your scaling vibe. 🌈

---

👑 RETURN VALUE 👑

Returns a copy of the surface, or NULL on failure. and if she fails? call SDL_GetError() for more information — she'll tell you what went wrong, fr fr. 💀

---

🧚 THREAD SAFETY 🧚

This function can be called on different threads with different surfaces. so like, multitask queen energy — just keep the surfaces different and you're golden. 🔥

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. vintage-ish but make it fresh. 🎀

---

🌈 SEE ALSO 🌈

• SDL_DestroySurface(3) — the cleanup bestie. go say hi. 💜

---

Simple Directmedia Layer made this one, and this page is riding with SDL 3.4.18 — mwah, that's the whole manual page for SDL_ScaleSurface(3), drink some water, free your surfaces, and slay the rest of your day 💅✨🦋