xcb_damage_add(3)

💖 xcb_damage_add — the XCB Requests girlies' guide 💖

okay so bestie, welcome to xcb_damage_add(3) from the XCB Requests collection. this is the lil request that says "hey, add a region to a Damage object you already made earlier" ✨ no cap.

---

✨ NAME ✨

xcb_damage_add — add a region to a previously created Damage object. that's it, that's the whole vibe 🎀

---

🌸 SYNOPSIS 🌸

first things first, you gotta let the compiler know what's up:

#include <xcb/damage.h>

🦋 Request function 🦋

here's the iconic signature, copy it exactly bestie, character for character:

xcb_void_cookie_t xcb_damage_add(xcb_connection_t *conn,
       xcb_drawable_t drawable, xcb_xfixes_region_t region);

---

💅 REQUEST ARGUMENTS 💅

• conn — the XCB connection to X11. your lil hotline to the X server, she's the main character here fr.
• drawable — TODO: NOT YET DOCUMENTED. yeah bestie the docs literally say that, i'm not gatekeeping, that's just what it says 😭
• region — TODO: NOT YET DOCUMENTED. same energy, the source material left this one blank, so blank it stays 🙈

---

💜 DESCRIPTION 💜

so what does this actually do? it updates the regions of damage recorded in a a Damage object. (yes, "a a" — that's what the original says, i am not touching it, it's giving typo but it's their typo and it's iconic 💀)

want the full lore? the damage protocol tea lives right here:

https://www.x.org/releases/current/doc/damageproto/damageproto.txt

go read it, iykyk 📖✨

---

🔥 RETURN VALUE 🔥

it hands you back an xcb_void_cookie_t. and because this is a void cookie, any errors that pop off have to be handled in the event loop — you don't get them handed to you directly, bestie, you gotta go get them.

if you do want to handle errors directly with xcb_request_check instead? then you want the checked version, xcb_damage_add_checked. see xcb-requests(3) for the deets 🫶

---

🎀 ERRORS 🎀

good news queen: this request does never generate any errors. zero. none. a clean slate, a flawless vibe check, she simply does not miss 💅✨

---

🌈 SEE ALSO 🌈

• xcb-requests(3) — go read it, it's the blueprint fr fr

---

👑 AUTHOR 👑

Generated from damage.xml. need corrections or improvements? hit up xcb@lists.freedesktop.org — they're the ones holding the pen 🖊️💖

---

and that's the whole page bestie!! this lil masterpiece came to you from X Version 11, libxcb 1.17.0, and the manpage xcb_damage_add(3) herself. slay, study, and go add those regions 🦋💜 periodt ✨