drm_plane_get_damage_clips(9)

💅 drm_plane_get_damage_clips(9) — Kernel API Manual, bestie edition 🎀

okay so real talk, this one lives in the Kernel API Manual and it's genuinely one of the cutest little getters in the DRM plane universe. no cap.

---

✨ NAME ✨

drm_plane_get_damage_clips — returns damage clips. that's it. that's the whole vibe. 🦋

---

🌸 SYNOPSIS 🌸

struct drm_mode_rect * drm_plane_get_damage_clips (const struct
drm_plane_state *state );

like, look at her. struct drm_mode_rect * on the left, one lil const struct drm_plane_state *state on the right. iconic signature, no notes 💅

---

🫶 ARGUMENTS 🫶

• state — plane state. literally just the plane state, bestie. that's what she needs, that's what she gets. 💖

---

🔥 DESCRIPTION 🔥

okay so heads up because this matters: this function returns the uapi type drm_mode_rect. not a kernel-internal struct, the uapi one. iykyk. 👑

and here's the lowkey tea — if your driver can only handle a single damage region at most (at most, bestie, we're not out here being greedy), you probably don't wanna rawdog this return value. drivers might want to use the helper functions instead:

• drm_atomic_helper_damage_iter_init
• drm_atomic_helper_damage_iter_next
• drm_atomic_helper_damage_merged

like, the iter helpers are right there. use them. they ate. ✨

---

⭐ RETURN ⭐

damage clips in the plane fb_damage_clips blob property. 💀 that's the whole return, she's not complicated.

---

🌈 SEE ALSO 🌈

the whole friend group fr fr:

• Kernel file ./drivers/gpu/drm/drm_plane.c
• overview(9)
• standard plane properties(9)
• hotspot properties(9)
• drm_plane_create_hotspot_properties(9)
• drm_universal_plane_init(9)
• drm_plane_cleanup(9)
• drm_plane_from_index(9)
• drm_plane_force_disable(9)
• drm_mode_plane_set_obj_prop(9)
• drm_plane_has_format(9)
• drm_any_plane_has_format(9)
• damage tracking(9)
• drm_plane_enable_fb_damage_clips(9)
• drm_plane_get_damage_clips_count(9)
• drm_plane_create_scaling_filter_property(9)
• drm_plane_add_size_hints_property(9)
• drm_plane_create_color_pipeline_property(9)

---

ngl this page came from ./drivers/gpu/drm, dated October 2026, and it's part of the Kernel API Manual. slay, drink water, go read drm_plane.c. 💜🧚‍♀️