xcb_dbe_allocate_back_buffer(3)

✨ xcb_dbe_allocate_back_buffer ✨

okay bestie, welcome to the XCB Requests section of the manual, and today's main character is xcb_dbe_allocate_back_buffer — the lil' function that allocates a back buffer. yes, that's literally its whole job. no cap. 💅

🦋 NAME 🦋

xcb_dbe_allocate_back_buffer — Allocates a back buffer 🎀

🌸 SYNOPSIS 🌸

#include <xcb/dbe.h>

✨ Request function ✨

xcb_void_cookie_t xcb_dbe_allocate_back_buffer(xcb_connection_t *conn,
       xcb_window_t window, xcb_dbe_back_buffer_t buffer,
       uint8_t swap_action);

💖 REQUEST ARGUMENTS 💖

• conn — your XCB connection to X11. the whole link to the X server, the group chat you're sending this request through 🫶
• window — the window you wanna add the back buffer to. that's the vibe.
• buffer — the buffer id you're associating with the back buffer. give it a name tag, bestie 🏷️
• swap_action — the swap action most likely to be used to present this back buffer. and listen — this is only a hint. it does not preclude you from using other swap actions later, so don't stress, it's not a binding contract or anything 😌

💜 DESCRIPTION 💜

so what's actually happening here? it associates buffer with the back buffer of window. and here's the cute part: multiple ids may be associated with the back buffer — the back buffer itself is created by the first allocate call and destroyed by the last deallocate. first one in builds the club, last one out turns off the lights. it's giving ✨shared custody✨, fr fr.

🌈 RETURN VALUE 🌈

it returns an xcb_void_cookie_t. and if there are any errors? bestie, you gotta handle those in the event loop. that's the deal.

but wait — if you'd rather handle errors directly with xcb_request_check instead, then use xcb_dbe_allocate_back_buffer_checked. different function, same energy. see xcb-requests(3) for the deets. 💅

💀 ERRORS 💀

this request does never generate any errors.

iconic. flawless. zero drama. it simply does not miss. 👑

🎀 SEE ALSO 🎀

• xcb-requests(3) 🦋

⭐ AUTHOR ⭐

Generated from dbe.xml. if you got corrections or improvements, hmu at xcb@lists.freedesktop.org — they're literally asking for it, so slide into their inbox 📬

X Version 11 ✦ libxcb 1.17.0 ✦ xcb_dbe_allocate_back_buffer(3)

and that's the whole page, bestie 🫶 go allocate that back buffer, slay, and remember: first allocate creates it, last deallocate destroys it. periodt. 💖✨🎀🦋🌸