SDL_Flip(3)

📦 version 1.2.15, in debian bookworm, nixos 26.05, nixpkgs unstable, ubuntu jammy

💖 SDL_Flip(3) 💖

ok so we're in the SDL API Reference bestie, and today's main character is SDL_Flip 🫶

✨ NAME ✨

SDL_Flip — swaps screen buffers 🔄

🌸 SYNOPSIS 🌸

#include "SDL.h"

int SDL_Flip(SDL_Surface *screen);

🦋 DESCRIPTION 🦋

okok so listen. If your hardware is out here supporting double-buffering, this function literally just sets up a flip and dips — returns immediately, no waiting around 💅. The hardware itself will wait for vertical retrace, and then it swaps the video buffers. And that swap happens before the next video surface blit or lock returns. it's giving synchronized, it's giving no tearing, we love to see it ✨

Now if your hardware does NOT support double-buffering? Then bestie, this is literally equivalent to calling SDL_UpdateRect(screen, 0, 0, 0, 0). Same thing, no cap.

🚨 IMPORTANT VIBE CHECK: the SDL_DOUBLEBUF flag must have been passed to SDL_SetVideoMode when you were setting the video mode. No flag, no hardware flipping. periodt.

🎀 RETURN VALUE 🎀

  • 0 — slayed, it worked 💖
  • -1 — nope, there was an error 😭

👑 SEE ALSO 👑

  • SDL_SetVideoMode
  • SDL_UpdateRect
  • SDL_Surface

and that's the whole page bestie, hope this was iconic for u 🌈 stay hydrated, go flip some buffers 💅

SDL · Tue 11 Sep 2001, 23:01 🦋 mwah, catch u in the next manpage 🫶✨

📦 where this page comes from