drm_atomic_g..._plane_state(9)
π¦ drm_atomic_get_new_plane_state(9) π¦
okay so bestie, welcome to the Kernel API Manual for drm_atomic_g..._plane_state(9) β yes the title's got that little ellipsis glow-up because kernel manpage titles are dramatic like that π
don't worry, the real name's right below and it slays.
β¨ NAME β¨
drm_atomic_get_new_plane_state β get plane state, if it exists π
πΈ SYNOPSIS πΈ
struct drm_plane_state * drm_atomic_get_new_plane_state (const struct
drm_atomic_commit *state , struct drm_plane *plane );
like, that's the whole vibe. it takes stuff, it hands you a struct drm_plane_state *. icon behavior tbh β
π ARGUMENTS π
stateβ the global atomic state object π this is the big-picture main character of the whole atomic commitplaneβ the plane you wanna grab π«Ά literally the thing you're asking about
π DESCRIPTION π
okay so here's the tea β this function returns the new plane state for the given plane β that's it, that's the whole job, and it does it gorgeously β¨
but bestie, plot twist π if the plane is not part of the global atomic state, you get NULL back. no state for you, babe. it's giving "not invited to the group chat" energy π so like, always remember to check for the NULL, okay? don't just vibe-check the return value and assume.
π SEE ALSO π
pinkies up, here comes the whole friend group π
these are all the neighbors in the kernel file ./include/drm/drm_atomic.h:
struct drm_crtc_commit(9)struct drm_private_state_funcs(9)struct drm_private_obj(9)drm_for_each_privobj(9)struct drm_private_state(9)struct drm_atomic_commit(9)drm_crtc_commit_get(9)drm_crtc_commit_put(9)drm_atomic_commit_get(9)drm_atomic_commit_put(9)drm_atomic_get_old_crtc_state(9)drm_atomic_get_new_crtc_state(9)drm_atomic_get_old_plane_state(9)drm_atomic_get_old_connector_state(9)drm_atomic_get_new_connector_state(9)__drm_atomic_get_current_plane_state(9)for_each_oldnew_connector_in_state(9)for_each_old_connector_in_state(9)for_each_new_connector_in_state(9)for_each_oldnew_crtc_in_state(9)for_each_old_crtc_in_state(9)for_each_new_crtc_in_state(9)for_each_oldnew_colorop_in_state(9)for_each_new_colorop_in_state(9)for_each_oldnew_plane_in_state(9)for_each_oldnew_plane_in_state_reverse(9)for_each_new_plane_in_state_reverse(9)for_each_old_plane_in_state(9)for_each_new_plane_in_state(9)for_each_oldnew_private_obj_in_state(9)for_each_old_private_obj_in_state(9)for_each_new_private_obj_in_state(9)drm_atomic_crtc_needs_modeset(9)drm_atomic_crtc_effectively_active(9)struct drm_bus_cfg(9)struct drm_bridge_state(9)
like, that's a whole squad π and honestly every single one of them is worth a read, iykyk πβ¨
lowkey reminder: this page lives in the kernel file ./include/drm β that's the source location, no cap π₯
and that's the whole page, bestie!! π«Ά sourced from ./include/drm, dated October 2026, and yes the footer still says drm_atomic_g..._plane_state(9) because the header never changes its name β periodt π
β¨ go forth and grab those plane states π¦ππ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms