mirror of
https://github.com/brl/mutter.git
synced 2025-02-27 02:04:09 +00:00

A plane is one of three possible: primary, overlay and cursor. Each plane can have various properties, such as possible rotations, formats etc. Each plane can also be used with a set of CRTCs. A primary plane is the "backdrop" of a CRTC, i.e. the primary output for the composited frame that covers the whole CRTC. In general, mutter composites to a stage view frame onto a framebuffer that is then put on the primary plane. An overlay plane is a rectangular area that can be displayed on top of the primary plane. Eventually it will be used to place non-fullscreen surfaces, potentially avoiding stage redraws. A cursor plane is a plane placed on top of all the other planes, usually used to put the mouse cursor sprite. Initially, we only fetch the rotation properties, and we so far blacklist all rotations except ones that ends up with the same dimensions as with no rotations. This is because non-180° rotations doesn't work yet due to incorrect buffer modifiers. To make it possible to use non-180° rotations, changes necessary include among other things finding compatible modifiers using atomic modesetting. Until then, simply blacklist the ones we know doesn't work. https://gitlab.gnome.org/GNOME/mutter/issues/548 https://gitlab.gnome.org/GNOME/mutter/merge_requests/525
55 lines
1.9 KiB
C
55 lines
1.9 KiB
C
/*
|
|
* Copyright (C) 2018 Red Hat
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License as
|
|
* published by the Free Software Foundation; either version 2 of the
|
|
* License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
|
|
* 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef META_KMS_PLANE_H
|
|
#define META_KMS_PLANE_H
|
|
|
|
#include <glib-object.h>
|
|
#include <stdint.h>
|
|
#include <xf86drmMode.h>
|
|
|
|
#include "backends/native/meta-kms-types.h"
|
|
#include "backends/meta-monitor-transform.h"
|
|
|
|
typedef enum _MetaKmsPlaneType
|
|
{
|
|
META_KMS_PLANE_TYPE_PRIMARY,
|
|
META_KMS_PLANE_TYPE_CURSOR,
|
|
META_KMS_PLANE_TYPE_OVERLAY,
|
|
} MetaKmsPlaneType;
|
|
|
|
#define META_TYPE_KMS_PLANE meta_kms_plane_get_type ()
|
|
G_DECLARE_FINAL_TYPE (MetaKmsPlane, meta_kms_plane,
|
|
META, KMS_PLANE, GObject)
|
|
|
|
MetaKmsPlane * meta_kms_plane_new (MetaKmsPlaneType type,
|
|
MetaKmsImplDevice *impl_device,
|
|
drmModePlane *drm_plane,
|
|
drmModeObjectProperties *drm_plane_props);
|
|
|
|
MetaKmsPlaneType meta_kms_plane_get_plane_type (MetaKmsPlane *plane);
|
|
|
|
gboolean meta_kms_plane_is_transform_handled (MetaKmsPlane *plane,
|
|
MetaMonitorTransform transform);
|
|
|
|
gboolean meta_kms_plane_is_usable_with (MetaKmsPlane *plane,
|
|
MetaKmsCrtc *crtc);
|
|
|
|
#endif /* META_KMS_PLANE_H */
|