Lines Matching full:plane
40 * A plane represents an image source that can be blended with or overlayed on
42 * &drm_framebuffer object. The plane itself specifies the cropping and scaling
44 * pipeline, represented by &drm_crtc. A plane can also have additional
48 * To create a plane, a KMS drivers allocates and zeroes an instances of
53 * primary plane per CRTC to avoid surprising userspace too much. See enum
55 * plane types. Special planes are associated with their CRTC by calling
58 * The type of a plane is exposed in the immutable "type" enumeration property,
86 static int create_in_format_blob(struct drm_device *dev, struct drm_plane *plane) in create_in_format_blob() argument
95 formats_size = sizeof(__u32) * plane->format_count; in create_in_format_blob()
102 sizeof(struct drm_format_modifier) * plane->modifier_count; in create_in_format_blob()
118 blob_data->count_formats = plane->format_count; in create_in_format_blob()
120 blob_data->count_modifiers = plane->modifier_count; in create_in_format_blob()
125 memcpy(formats_ptr(blob_data), plane->format_types, formats_size); in create_in_format_blob()
128 if (!plane->funcs->format_mod_supported) in create_in_format_blob()
132 for (i = 0; i < plane->modifier_count; i++) { in create_in_format_blob()
133 for (j = 0; j < plane->format_count; j++) { in create_in_format_blob()
134 if (plane->funcs->format_mod_supported(plane, in create_in_format_blob()
135 plane->format_types[j], in create_in_format_blob()
136 plane->modifiers[i])) { in create_in_format_blob()
142 mod->modifier = plane->modifiers[i]; in create_in_format_blob()
149 drm_object_attach_property(&plane->base, config->modifiers_property, in create_in_format_blob()
156 * drm_universal_plane_init - Initialize a new universal plane object
158 * @plane: plane object to init
160 * @funcs: callbacks for the new plane
165 * @type: type of plane (overlay, primary, cursor)
166 * @name: printf style format string for the plane name, or NULL for default name
168 * Initializes a plane object of type @type.
173 int drm_universal_plane_init(struct drm_device *dev, struct drm_plane *plane, in drm_universal_plane_init() argument
185 /* plane index is used with 32bit bitmasks */ in drm_universal_plane_init()
193 ret = drm_mode_object_add(dev, &plane->base, DRM_MODE_OBJECT_PLANE); in drm_universal_plane_init()
197 drm_modeset_lock_init(&plane->mutex); in drm_universal_plane_init()
199 plane->base.properties = &plane->properties; in drm_universal_plane_init()
200 plane->dev = dev; in drm_universal_plane_init()
201 plane->funcs = funcs; in drm_universal_plane_init()
202 plane->format_types = kmalloc_array(format_count, sizeof(uint32_t), in drm_universal_plane_init()
204 if (!plane->format_types) { in drm_universal_plane_init()
205 DRM_DEBUG_KMS("out of memory when allocating plane\n"); in drm_universal_plane_init()
206 drm_mode_object_unregister(dev, &plane->base); in drm_universal_plane_init()
227 plane->modifier_count = format_modifier_count; in drm_universal_plane_init()
228 plane->modifiers = kmalloc_array(format_modifier_count, in drm_universal_plane_init()
232 if (format_modifier_count && !plane->modifiers) { in drm_universal_plane_init()
233 DRM_DEBUG_KMS("out of memory when allocating plane\n"); in drm_universal_plane_init()
234 kfree(plane->format_types); in drm_universal_plane_init()
235 drm_mode_object_unregister(dev, &plane->base); in drm_universal_plane_init()
243 plane->name = kvasprintf(GFP_KERNEL, name, ap); in drm_universal_plane_init()
246 plane->name = kasprintf(GFP_KERNEL, "plane-%d", in drm_universal_plane_init()
249 if (!plane->name) { in drm_universal_plane_init()
250 kfree(plane->format_types); in drm_universal_plane_init()
251 kfree(plane->modifiers); in drm_universal_plane_init()
252 drm_mode_object_unregister(dev, &plane->base); in drm_universal_plane_init()
256 memcpy(plane->format_types, formats, format_count * sizeof(uint32_t)); in drm_universal_plane_init()
257 plane->format_count = format_count; in drm_universal_plane_init()
258 memcpy(plane->modifiers, format_modifiers, in drm_universal_plane_init()
260 plane->possible_crtcs = possible_crtcs; in drm_universal_plane_init()
261 plane->type = type; in drm_universal_plane_init()
263 list_add_tail(&plane->head, &config->plane_list); in drm_universal_plane_init()
264 plane->index = config->num_total_plane++; in drm_universal_plane_init()
266 drm_object_attach_property(&plane->base, in drm_universal_plane_init()
268 plane->type); in drm_universal_plane_init()
271 drm_object_attach_property(&plane->base, config->prop_fb_id, 0); in drm_universal_plane_init()
272 drm_object_attach_property(&plane->base, config->prop_in_fence_fd, -1); in drm_universal_plane_init()
273 drm_object_attach_property(&plane->base, config->prop_crtc_id, 0); in drm_universal_plane_init()
274 drm_object_attach_property(&plane->base, config->prop_crtc_x, 0); in drm_universal_plane_init()
275 drm_object_attach_property(&plane->base, config->prop_crtc_y, 0); in drm_universal_plane_init()
276 drm_object_attach_property(&plane->base, config->prop_crtc_w, 0); in drm_universal_plane_init()
277 drm_object_attach_property(&plane->base, config->prop_crtc_h, 0); in drm_universal_plane_init()
278 drm_object_attach_property(&plane->base, config->prop_src_x, 0); in drm_universal_plane_init()
279 drm_object_attach_property(&plane->base, config->prop_src_y, 0); in drm_universal_plane_init()
280 drm_object_attach_property(&plane->base, config->prop_src_w, 0); in drm_universal_plane_init()
281 drm_object_attach_property(&plane->base, config->prop_src_h, 0); in drm_universal_plane_init()
285 create_in_format_blob(dev, plane); in drm_universal_plane_init()
295 struct drm_plane *plane; in drm_plane_register_all() local
298 drm_for_each_plane(plane, dev) { in drm_plane_register_all()
299 if (plane->funcs->late_register) in drm_plane_register_all()
300 ret = plane->funcs->late_register(plane); in drm_plane_register_all()
304 if (plane->zpos_property) in drm_plane_register_all()
317 struct drm_plane *plane; in drm_plane_unregister_all() local
319 drm_for_each_plane(plane, dev) { in drm_plane_unregister_all()
320 if (plane->funcs->early_unregister) in drm_plane_unregister_all()
321 plane->funcs->early_unregister(plane); in drm_plane_unregister_all()
326 * drm_plane_init - Initialize a legacy plane
328 * @plane: plane object to init
330 * @funcs: callbacks for the new plane
333 * @is_primary: plane type (primary vs overlay)
335 * Legacy API to initialize a DRM plane.
342 int drm_plane_init(struct drm_device *dev, struct drm_plane *plane, in drm_plane_init() argument
351 return drm_universal_plane_init(dev, plane, possible_crtcs, funcs, in drm_plane_init()
358 * drm_plane_cleanup - Clean up the core plane usage
359 * @plane: plane to cleanup
361 * This function cleans up @plane and removes it from the DRM mode setting
362 * core. Note that the function does *not* free the plane structure itself,
365 void drm_plane_cleanup(struct drm_plane *plane) in drm_plane_cleanup() argument
367 struct drm_device *dev = plane->dev; in drm_plane_cleanup()
369 drm_modeset_lock_fini(&plane->mutex); in drm_plane_cleanup()
371 kfree(plane->format_types); in drm_plane_cleanup()
372 kfree(plane->modifiers); in drm_plane_cleanup()
373 drm_mode_object_unregister(dev, &plane->base); in drm_plane_cleanup()
375 BUG_ON(list_empty(&plane->head)); in drm_plane_cleanup()
382 list_del(&plane->head); in drm_plane_cleanup()
385 WARN_ON(plane->state && !plane->funcs->atomic_destroy_state); in drm_plane_cleanup()
386 if (plane->state && plane->funcs->atomic_destroy_state) in drm_plane_cleanup()
387 plane->funcs->atomic_destroy_state(plane, plane->state); in drm_plane_cleanup()
389 kfree(plane->name); in drm_plane_cleanup()
391 memset(plane, 0, sizeof(*plane)); in drm_plane_cleanup()
396 * drm_plane_from_index - find the registered plane at an index
398 * @idx: index of registered plane to find for
400 * Given a plane index, return the registered plane from DRM device's
406 struct drm_plane *plane; in drm_plane_from_index() local
408 drm_for_each_plane(plane, dev) in drm_plane_from_index()
409 if (idx == plane->index) in drm_plane_from_index()
410 return plane; in drm_plane_from_index()
417 * drm_plane_force_disable - Forcibly disable a plane
418 * @plane: plane to disable
420 * Forces the plane to be disabled.
422 * Used when the plane's current framebuffer is destroyed,
431 void drm_plane_force_disable(struct drm_plane *plane) in drm_plane_force_disable() argument
435 if (!plane->fb) in drm_plane_force_disable()
438 WARN_ON(drm_drv_uses_atomic_modeset(plane->dev)); in drm_plane_force_disable()
440 plane->old_fb = plane->fb; in drm_plane_force_disable()
441 ret = plane->funcs->disable_plane(plane, NULL); in drm_plane_force_disable()
443 DRM_ERROR("failed to disable plane with busy fb\n"); in drm_plane_force_disable()
444 plane->old_fb = NULL; in drm_plane_force_disable()
447 /* disconnect the plane from the fb and crtc: */ in drm_plane_force_disable()
448 drm_framebuffer_put(plane->old_fb); in drm_plane_force_disable()
449 plane->old_fb = NULL; in drm_plane_force_disable()
450 plane->fb = NULL; in drm_plane_force_disable()
451 plane->crtc = NULL; in drm_plane_force_disable()
457 * @plane: drm plane object to set property value for
461 * This functions sets a given property on a given plane object. This function
468 int drm_mode_plane_set_obj_prop(struct drm_plane *plane, in drm_mode_plane_set_obj_prop() argument
473 struct drm_mode_object *obj = &plane->base; in drm_mode_plane_set_obj_prop()
475 if (plane->funcs->set_property) in drm_mode_plane_set_obj_prop()
476 ret = plane->funcs->set_property(plane, property, value); in drm_mode_plane_set_obj_prop()
488 struct drm_plane *plane; in drm_mode_getplane_res() local
501 drm_for_each_plane(plane, dev) { in drm_mode_getplane_res()
506 if (plane->type != DRM_PLANE_TYPE_OVERLAY && in drm_mode_getplane_res()
510 if (drm_lease_held(file_priv, plane->base.id)) { in drm_mode_getplane_res()
512 put_user(plane->base.id, plane_ptr + count)) in drm_mode_getplane_res()
526 struct drm_plane *plane; in drm_mode_getplane() local
532 plane = drm_plane_find(dev, file_priv, plane_resp->plane_id); in drm_mode_getplane()
533 if (!plane) in drm_mode_getplane()
536 drm_modeset_lock(&plane->mutex, NULL); in drm_mode_getplane()
537 if (plane->state && plane->state->crtc && drm_lease_held(file_priv, plane->state->crtc->base.id)) in drm_mode_getplane()
538 plane_resp->crtc_id = plane->state->crtc->base.id; in drm_mode_getplane()
539 else if (!plane->state && plane->crtc && drm_lease_held(file_priv, plane->crtc->base.id)) in drm_mode_getplane()
540 plane_resp->crtc_id = plane->crtc->base.id; in drm_mode_getplane()
544 if (plane->state && plane->state->fb) in drm_mode_getplane()
545 plane_resp->fb_id = plane->state->fb->base.id; in drm_mode_getplane()
546 else if (!plane->state && plane->fb) in drm_mode_getplane()
547 plane_resp->fb_id = plane->fb->base.id; in drm_mode_getplane()
550 drm_modeset_unlock(&plane->mutex); in drm_mode_getplane()
552 plane_resp->plane_id = plane->base.id; in drm_mode_getplane()
554 plane->possible_crtcs); in drm_mode_getplane()
562 if (plane->format_count && in drm_mode_getplane()
563 (plane_resp->count_format_types >= plane->format_count)) { in drm_mode_getplane()
566 plane->format_types, in drm_mode_getplane()
567 sizeof(uint32_t) * plane->format_count)) { in drm_mode_getplane()
571 plane_resp->count_format_types = plane->format_count; in drm_mode_getplane()
576 int drm_plane_check_pixel_format(struct drm_plane *plane, in drm_plane_check_pixel_format() argument
581 for (i = 0; i < plane->format_count; i++) { in drm_plane_check_pixel_format()
582 if (format == plane->format_types[i]) in drm_plane_check_pixel_format()
585 if (i == plane->format_count) in drm_plane_check_pixel_format()
588 if (plane->funcs->format_mod_supported) { in drm_plane_check_pixel_format()
589 if (!plane->funcs->format_mod_supported(plane, format, modifier)) in drm_plane_check_pixel_format()
592 if (!plane->modifier_count) in drm_plane_check_pixel_format()
595 for (i = 0; i < plane->modifier_count; i++) { in drm_plane_check_pixel_format()
596 if (modifier == plane->modifiers[i]) in drm_plane_check_pixel_format()
599 if (i == plane->modifier_count) in drm_plane_check_pixel_format()
606 static int __setplane_check(struct drm_plane *plane, in __setplane_check() argument
616 /* Check whether this plane is usable on this CRTC */ in __setplane_check()
617 if (!(plane->possible_crtcs & drm_crtc_mask(crtc))) { in __setplane_check()
618 DRM_DEBUG_KMS("Invalid crtc for plane\n"); in __setplane_check()
622 /* Check whether this plane supports the fb pixel format. */ in __setplane_check()
623 ret = drm_plane_check_pixel_format(plane, fb->format->format, in __setplane_check()
653 * drm_any_plane_has_format - Check whether any plane supports this format and modifier combination
659 * Whether at least one plane supports the specified format and modifier combination.
664 struct drm_plane *plane; in drm_any_plane_has_format() local
666 drm_for_each_plane(plane, dev) { in drm_any_plane_has_format()
667 if (drm_plane_check_pixel_format(plane, format, modifier) == 0) in drm_any_plane_has_format()
678 * This function will take a reference on the new fb for the plane
683 static int __setplane_internal(struct drm_plane *plane, in __setplane_internal() argument
695 WARN_ON(drm_drv_uses_atomic_modeset(plane->dev)); in __setplane_internal()
699 plane->old_fb = plane->fb; in __setplane_internal()
700 ret = plane->funcs->disable_plane(plane, ctx); in __setplane_internal()
702 plane->crtc = NULL; in __setplane_internal()
703 plane->fb = NULL; in __setplane_internal()
705 plane->old_fb = NULL; in __setplane_internal()
710 ret = __setplane_check(plane, crtc, fb, in __setplane_internal()
716 plane->old_fb = plane->fb; in __setplane_internal()
717 ret = plane->funcs->update_plane(plane, crtc, fb, in __setplane_internal()
721 plane->crtc = crtc; in __setplane_internal()
722 plane->fb = fb; in __setplane_internal()
723 drm_framebuffer_get(plane->fb); in __setplane_internal()
725 plane->old_fb = NULL; in __setplane_internal()
729 if (plane->old_fb) in __setplane_internal()
730 drm_framebuffer_put(plane->old_fb); in __setplane_internal()
731 plane->old_fb = NULL; in __setplane_internal()
736 static int __setplane_atomic(struct drm_plane *plane, in __setplane_atomic() argument
747 WARN_ON(!drm_drv_uses_atomic_modeset(plane->dev)); in __setplane_atomic()
751 return plane->funcs->disable_plane(plane, ctx); in __setplane_atomic()
760 ret = __setplane_check(plane, crtc, fb, in __setplane_atomic()
766 return plane->funcs->update_plane(plane, crtc, fb, in __setplane_atomic()
771 static int setplane_internal(struct drm_plane *plane, in setplane_internal() argument
783 DRM_MODESET_LOCK_ALL_BEGIN(plane->dev, ctx, in setplane_internal()
786 if (drm_drv_uses_atomic_modeset(plane->dev)) in setplane_internal()
787 ret = __setplane_atomic(plane, crtc, fb, in setplane_internal()
791 ret = __setplane_internal(plane, crtc, fb, in setplane_internal()
795 DRM_MODESET_LOCK_ALL_END(plane->dev, ctx, ret); in setplane_internal()
804 struct drm_plane *plane; in drm_mode_setplane() local
813 * First, find the plane, crtc, and fb objects. If not available, in drm_mode_setplane()
816 plane = drm_plane_find(dev, file_priv, plane_req->plane_id); in drm_mode_setplane()
817 if (!plane) { in drm_mode_setplane()
818 DRM_DEBUG_KMS("Unknown plane ID %d\n", in drm_mode_setplane()
840 ret = setplane_internal(plane, crtc, fb, in drm_mode_setplane()
858 struct drm_plane *plane = crtc->cursor; in drm_mode_cursor_universal() local
872 BUG_ON(!plane); in drm_mode_cursor_universal()
873 WARN_ON(plane->crtc != crtc && plane->crtc != NULL); in drm_mode_cursor_universal()
878 * the reference if the plane update fails. in drm_mode_cursor_universal()
894 if (plane->state) in drm_mode_cursor_universal()
895 fb = plane->state->fb; in drm_mode_cursor_universal()
897 fb = plane->fb; in drm_mode_cursor_universal()
919 ret = __setplane_atomic(plane, crtc, fb, in drm_mode_cursor_universal()
923 ret = __setplane_internal(plane, crtc, fb, in drm_mode_cursor_universal()
965 * If this crtc has a universal cursor plane, call that plane's update in drm_mode_cursor_common()
1049 struct drm_plane *plane; in drm_mode_page_flip_ioctl() local
1078 plane = crtc->primary; in drm_mode_page_flip_ioctl()
1080 if (!drm_lease_held(file_priv, plane->base.id)) in drm_mode_page_flip_ioctl()
1127 ret = drm_modeset_lock(&plane->mutex, &ctx); in drm_mode_page_flip_ioctl()
1131 if (plane->state) in drm_mode_page_flip_ioctl()
1132 old_fb = plane->state->fb; in drm_mode_page_flip_ioctl()
1134 old_fb = plane->fb; in drm_mode_page_flip_ioctl()
1151 if (plane->state) { in drm_mode_page_flip_ioctl()
1152 const struct drm_plane_state *state = plane->state; in drm_mode_page_flip_ioctl()
1192 plane->old_fb = plane->fb; in drm_mode_page_flip_ioctl()
1205 plane->old_fb = NULL; in drm_mode_page_flip_ioctl()
1207 if (!plane->state) { in drm_mode_page_flip_ioctl()
1208 plane->fb = fb; in drm_mode_page_flip_ioctl()
1216 if (plane->old_fb) in drm_mode_page_flip_ioctl()
1217 drm_framebuffer_put(plane->old_fb); in drm_mode_page_flip_ioctl()
1218 plane->old_fb = NULL; in drm_mode_page_flip_ioctl()