4  * DRM universal plane helper functions
45  * primary plane support on top of the normal CRTC configuration interface.
47  * plane together with the CRTC state this does not allow userspace to disable
48  * the primary plane itself. The default primary plane only expose XRBG8888 and
56  * gradually switch to the atomic helper infrastructure for plane updates. Once
58  * the proper legacy implementations for update and disable plane hooks provided
63  * The plane helpers share the function table structures with other helpers,
83 	 * Note: Once we change the plane hooks to more fine-grained locking we  in get_connectors_for_crtc()
103 static int drm_plane_helper_check_update(struct drm_plane *plane,  in drm_plane_helper_check_update()  argument
116 		.plane = plane,  in drm_plane_helper_check_update()
152  * @plane: plane to update
153  * @crtc: the plane's new CRTC
154  * @fb: the plane's new framebuffer
165  * This helper validates the given parameters and updates the primary plane.
173 int drm_plane_helper_update_primary(struct drm_plane *plane, struct drm_crtc *crtc,  in drm_plane_helper_update_primary()  argument
200 	struct drm_device *dev = plane->dev;  in drm_plane_helper_update_primary()
208 	ret = drm_plane_helper_check_update(plane, crtc, fb,  in drm_plane_helper_update_primary()
219 		 * Primary plane isn't visible.  Note that unless a driver  in drm_plane_helper_update_primary()
223 		return plane->funcs->disable_plane(plane, ctx);  in drm_plane_helper_update_primary()
254  * @plane: plane to disable
258  * plane.
266 int drm_plane_helper_disable_primary(struct drm_plane *plane,  in drm_plane_helper_disable_primary()  argument
269 	struct drm_device *dev = plane->dev;  in drm_plane_helper_disable_primary()
278  * drm_plane_helper_destroy() - Helper for primary plane destruction
279  * @plane: plane to destroy
281  * Provides a default plane destroy handler for primary planes.  This handler
282  * is called during CRTC destruction.  We disable the primary plane, remove
283  * it from the DRM plane list, and deallocate the plane structure.
285 void drm_plane_helper_destroy(struct drm_plane *plane)  in drm_plane_helper_destroy()  argument
287 	drm_plane_cleanup(plane);  in drm_plane_helper_destroy()
288 	kfree(plane);  in drm_plane_helper_destroy()
293  * drm_plane_helper_atomic_check() - Helper to check plane atomic-state
294  * @plane: plane to check
297  * Provides a default plane-state check handler for planes whose atomic-state
298  * scale and positioning are not expected to change since the plane is always
301  * This is often the case for the primary plane of simple framebuffers.
306 int drm_plane_helper_atomic_check(struct drm_plane *plane, struct drm_atomic_state *state)  in drm_plane_helper_atomic_check()  argument
308 	struct drm_plane_state *new_plane_state = drm_atomic_get_new_plane_state(state, plane);  in drm_plane_helper_atomic_check()