drm_atomic_f...plane_damage(9)

🌸 drm_atomic_f...plane_damage(9) 🌸

okay so bestie, you're looking at a page from the Kernel API Manual — yes it's giving kernel energy but like, in a cute way, and it's actually so useful once you get it 💅

---

✨ NAME ✨

drm_atomic_for_each_plane_damage — the iterator macro for plane damage, and honestly? iconic 🎀

---

🦋 SYNOPSIS 🦋

drm_atomic_for_each_plane_damage (iter , rect );

---

💖 ARGUMENTS 💖

• iter — the iterator you're advancing. yes, it advances. slay ✨
• rect — returns a rectangle in fb coordinates, clipped to plane src. it's literally handing you the rect, no cap 🫶

---

🔥 DESCRIPTION 🔥

okay so listen up, this part matters:

bestie, if the first call to the iterator macro returns false, then there's no need to do a plane update. like, you can just go home. main character move honestly 💀

and also — when damage is not passed by user-space, the iterator will return the full plane src instead. so you always get something back, it's giving generous 👑

---

🧚 SEE ALSO 🧚

• the kernel file ./include/drm/drm_damage_helper.h — go read it, iykyk 📖
• struct drm_atomic_helper_damage_iter(9) — the bestie to this macro, fr fr 🦋

---

🌈 cute sign-off 🌈

that's the whole page babes 💜 this one lives over in ./include/drm, part of the Kernel API Manual, all dated October 2026 — so yeah, she's fresh ⭐ go forth and iterate your plane damage, you got this 🎀✨