XdbeAllocateBackBufferName(3)

💖 XdbeAllocateBackBufferName 💖

okay bestie, so this one is a page from the X FUNCTIONS manual, and it's literally all about getting yourself a DBE back buffer. yes, we're doing double-buffering. it's giving main character energy for your window. 🦋

---

✨ NAME ✨

XdbeAllocateBackBufferName — allocates a DBE buffer. that's it, that's the whole job, and she does it flawlessly. 💅

---

🌸 SYNOPSIS 🌸

#include <X11/extensions/Xdbe.h>

XdbeBackBuffer XdbeAllocateBackBufferName(
    Display        *dpy,
    Window         window,
    XdbeSwapAction swap_action)

---

🎀 DESCRIPTION 🎀

so like, this function hands you back a drawable ID that you use to refer to the back buffer of the window you specified. that's your new bestie for drawing offscreen, no cap. 🫶

the swap_action is a hint — a little heads-up about which swap action you'll probably be using in later calls to XdbeSwapBuffers(). and listen, it's literally just a hint, because the actual swap action you end up using in those XdbeSwapBuffers() calls does not have to match the swap_action you passed in here. the vibes are flexible. ✨

that said, clients are encouraged to provide accurate information whenever possible. like, be honest, bestie, it's better for everyone. 😌

---

💀 ERRORS 💀

• BadAlloc — allocation said no. 😭
• BadIDChoice — the ID choice was not it.
• BadMatch — the window you specified is not an InputOutput window, or its visual does not support DBE. vibe check failed. 🙈
• BadValue — an invalid swap action was specified. girl, that's not a real swap action.
• BadWindow — an invalid window was specified. wrong window, babe.

---

🌈 SEE ALSO 🌈

• DBE
• XdbeBeginIdiom()
• XdbeDeallocateBackBufferName()
• XdbeEndIdiom()
• XdbeFreeVisualInfo()
• XdbeGetBackBufferAttributes()
• XdbeGetVisualInfo()
• XdbeQueryExtension()
• XdbeSwapBuffers()

---

X Version 11 · libXext 1.3.6 · XdbeAllocateBackBufferName(3)

and that's the whole page, bestie 💖 this one came straight out of X Version 11, shipped with libXext 1.3.6, and it's the XdbeAllocateBackBufferName(3) page. go forth and allocate your buffers, you absolute icon. 👑🌸