xcb_dbe_swap_buffers(3)

💖 xcb_dbe_swap_buffers 💖

okay so bestie, this one lives in the XCB Requests manual, section 3, and it's the request that swaps your front and back buffers. iconic behaviour, no notes. 💅

✨ NAME ✨

xcb_dbe_swap_buffers — swaps front and back buffers. that's it, that's the whole job description 🎀

🌸 SYNOPSIS 🌸

#include <xcb/dbe.h>

🦋 Request function

xcb_void_cookie_t xcb_dbe_swap_buffers(xcb_connection_t *conn,
       uint32_t n_actions, const xcb_dbe_swap_info_t *actions);

🍓 REQUEST ARGUMENTS 🍓

• conn — the XCB connection to X11. your little phone line to the server, your group chat, your situationship with the display. 🫶
• n_actions — number of swap actions in actions. just a count, bestie. she's counting.
• actions — list of windows on which to swap buffers. the lineup. the roster. the guest list. 💜

👑 DESCRIPTION 👑

So here's the tea. This request swaps the front and back buffers on the specified windows. ✨

And here's the part people always get wrong — the front and back buffers retain their ids. like, they keep their names, they're not reinventing themselves. so:

• the window id continues to refer to the front buffer 👑
• the back buffer id created by this extension continues to refer to the back buffer 🌈

The back buffer contents is moved to the front buffer. periodt. 💅

Now — what happens to the back buffer contents after the operation depends on the given swap action. and the optimal swap action depends on how each frame is rendered. 🎨

fr fr, here's the example: if the buffer is cleared and fully overwritten on every frame, the "untouched" action — which throws away the buffer contents — would provide the best performance. yes bestie, sometimes throwing things away IS the self-care. 🙈

And to eliminate visual artifacts, the swap will occur during the monitor VSync, if the X server supports detecting it. that's the conditional, don't come for me. ⭐

💀 RETURN VALUE 💀

Returns an xcb_void_cookie_t. errors (if any) have to be handled in the event loop, so like… keep an eye on it, okay? 👀

If you want to handle errors directly with xcb_request_check instead, use xcb_dbe_swap_buffers_checked. See xcb-requests(3) for details. 🫶

🎀 ERRORS 🎀

This request does never generate any errors. literally none. zero. she's a good girl, she causes no problems, she simply vibes. 😭✨

🌈 SEE ALSO 🌈

• xcb-requests(3)

🦋 AUTHOR 🦋

Generated from dbe.xml. Contact xcb@lists.freedesktop.org for corrections and improvements. 🫶

and that's the page, bestie!! this little love letter comes to you from X Version 11 and libxcb 1.17.0 — go forth and swap those buffers, you absolute main character 👑💖✨