2014-04-21 19:03:22 -04:00
|
|
|
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Copyright (C) 2014 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
|
2023-08-07 05:50:23 -04:00
|
|
|
* along with this program; if not, see <http://www.gnu.org/licenses/>.
|
2014-04-21 19:03:22 -04:00
|
|
|
*
|
|
|
|
* Written by:
|
|
|
|
* Jasper St. Pierre <jstpierre@mecheye.net>
|
|
|
|
*/
|
|
|
|
|
2023-07-21 09:37:20 -04:00
|
|
|
#pragma once
|
2014-04-21 19:03:22 -04:00
|
|
|
|
|
|
|
#include <glib-object.h>
|
2014-08-05 08:11:59 -04:00
|
|
|
#include <xkbcommon/xkbcommon.h>
|
|
|
|
|
2018-07-10 04:36:24 -04:00
|
|
|
#include "meta/meta-backend.h"
|
|
|
|
#include "meta/meta-idle-monitor.h"
|
|
|
|
#include "backends/meta-backend-types.h"
|
|
|
|
#include "backends/meta-cursor-renderer.h"
|
2016-08-17 22:18:28 -04:00
|
|
|
#include "backends/meta-egl.h"
|
2020-08-04 08:17:39 -04:00
|
|
|
#include "backends/meta-input-mapper-private.h"
|
2018-07-10 04:36:24 -04:00
|
|
|
#include "backends/meta-input-settings-private.h"
|
|
|
|
#include "backends/meta-monitor-manager-private.h"
|
|
|
|
#include "backends/meta-orientation-manager.h"
|
2015-06-17 00:10:52 -04:00
|
|
|
#include "backends/meta-pointer-constraint.h"
|
2016-05-07 11:07:46 -04:00
|
|
|
#include "backends/meta-renderer.h"
|
2017-04-21 04:40:51 -04:00
|
|
|
#include "backends/meta-settings-private.h"
|
2021-03-02 04:21:20 -05:00
|
|
|
#include "core/meta-context-private.h"
|
2016-05-04 04:19:23 -04:00
|
|
|
#include "core/util-private.h"
|
2014-04-21 19:03:22 -04:00
|
|
|
|
2014-08-04 10:47:35 -04:00
|
|
|
#define DEFAULT_XKB_RULES_FILE "evdev"
|
|
|
|
#define DEFAULT_XKB_MODEL "pc105+inet"
|
|
|
|
|
2019-10-24 15:19:36 -04:00
|
|
|
typedef enum
|
|
|
|
{
|
|
|
|
META_SEQUENCE_NONE,
|
|
|
|
META_SEQUENCE_ACCEPTED,
|
|
|
|
META_SEQUENCE_REJECTED,
|
|
|
|
META_SEQUENCE_PENDING_END
|
|
|
|
} MetaSequenceState;
|
|
|
|
|
2014-04-21 19:03:22 -04:00
|
|
|
struct _MetaBackendClass
|
|
|
|
{
|
|
|
|
GObjectClass parent_class;
|
2014-04-21 19:13:04 -04:00
|
|
|
|
2016-05-04 04:19:23 -04:00
|
|
|
ClutterBackend * (* create_clutter_backend) (MetaBackend *backend);
|
|
|
|
|
2014-04-22 10:14:59 -04:00
|
|
|
void (* post_init) (MetaBackend *backend);
|
|
|
|
|
2022-03-14 17:45:34 -04:00
|
|
|
MetaBackendCapabilities (* get_capabilities) (MetaBackend *backend);
|
|
|
|
|
2017-07-06 04:00:56 -04:00
|
|
|
MetaMonitorManager * (* create_monitor_manager) (MetaBackend *backend,
|
|
|
|
GError **error);
|
2021-10-25 04:50:02 -04:00
|
|
|
MetaColorManager * (* create_color_manager) (MetaBackend *backend);
|
2020-07-10 17:28:50 -04:00
|
|
|
MetaCursorRenderer * (* get_cursor_renderer) (MetaBackend *backend,
|
|
|
|
ClutterInputDevice *device);
|
2020-07-29 05:06:43 -04:00
|
|
|
MetaCursorTracker * (* create_cursor_tracker) (MetaBackend *backend);
|
2017-07-05 06:01:47 -04:00
|
|
|
MetaRenderer * (* create_renderer) (MetaBackend *backend,
|
|
|
|
GError **error);
|
2020-11-19 10:00:12 -05:00
|
|
|
MetaInputSettings * (* get_input_settings) (MetaBackend *backend);
|
2014-04-23 10:50:07 -04:00
|
|
|
|
2021-03-12 02:31:50 -05:00
|
|
|
ClutterSeat * (* create_default_seat) (MetaBackend *backend,
|
|
|
|
GError **error);
|
|
|
|
|
2014-04-23 10:50:07 -04:00
|
|
|
gboolean (* grab_device) (MetaBackend *backend,
|
|
|
|
int device_id,
|
|
|
|
uint32_t timestamp);
|
|
|
|
gboolean (* ungrab_device) (MetaBackend *backend,
|
|
|
|
int device_id,
|
|
|
|
uint32_t timestamp);
|
2014-05-27 14:11:23 -04:00
|
|
|
|
2019-10-24 15:19:36 -04:00
|
|
|
void (* finish_touch_sequence) (MetaBackend *backend,
|
|
|
|
ClutterEventSequence *sequence,
|
|
|
|
MetaSequenceState state);
|
2016-11-30 23:59:47 -05:00
|
|
|
MetaLogicalMonitor * (* get_current_logical_monitor) (MetaBackend *backend);
|
|
|
|
|
2014-08-04 10:47:35 -04:00
|
|
|
void (* set_keymap) (MetaBackend *backend,
|
|
|
|
const char *layouts,
|
|
|
|
const char *variants,
|
2022-12-01 01:55:52 -05:00
|
|
|
const char *options,
|
|
|
|
const char *model);
|
2014-08-04 10:47:35 -04:00
|
|
|
|
2018-04-16 14:07:45 -04:00
|
|
|
gboolean (* is_lid_closed) (MetaBackend *backend);
|
|
|
|
|
2014-08-04 10:47:35 -04:00
|
|
|
struct xkb_keymap * (* get_keymap) (MetaBackend *backend);
|
|
|
|
|
2017-08-17 05:01:50 -04:00
|
|
|
xkb_layout_index_t (* get_keymap_layout_group) (MetaBackend *backend);
|
|
|
|
|
2014-08-04 10:47:35 -04:00
|
|
|
void (* lock_layout_group) (MetaBackend *backend,
|
|
|
|
guint idx);
|
2014-08-13 19:46:32 -04:00
|
|
|
|
2023-11-09 00:08:44 -05:00
|
|
|
void (* update_stage) (MetaBackend *backend);
|
2014-08-13 19:46:32 -04:00
|
|
|
void (* select_stage_events) (MetaBackend *backend);
|
2015-06-02 04:26:34 -04:00
|
|
|
|
2020-07-08 12:17:13 -04:00
|
|
|
void (* set_pointer_constraint) (MetaBackend *backend,
|
|
|
|
MetaPointerConstraint *constraint);
|
2021-12-07 10:12:07 -05:00
|
|
|
|
|
|
|
gboolean (* is_headless) (MetaBackend *backend);
|
2014-04-21 19:03:22 -04:00
|
|
|
};
|
|
|
|
|
2021-03-03 08:31:56 -05:00
|
|
|
void meta_backend_destroy (MetaBackend *backend);
|
2016-05-04 04:19:23 -04:00
|
|
|
|
2020-05-04 16:47:34 -04:00
|
|
|
META_EXPORT_TEST
|
Introduce regional stage rendering
Add support for drawing a stage using multiple framebuffers each making
up one part of the stage. This works by the stage backend
(ClutterStageWindow) providing a list of views which will be for
splitting up the stage in different regions.
A view layout, for now, is a set of rectangles. The stage window (i.e.
stage "backend" will use this information when drawing a frame, using
one framebuffer for each view. The scene graph is adapted to explictly
take a view when painting the stage. It will use this view, its
assigned framebuffer and layout to offset and clip the drawing
accordingly.
This effectively removes any notion of "stage framebuffer", since each
stage now may consist of multiple framebuffers. Therefore, API
involving this has been deprecated and made no-ops; namely
clutter_stage_ensure_context(). Callers are now assumed to either
always use a framebuffer reference explicitly, or push/pop the
framebuffer of a given view where the code has not yet changed to use
the explicit-buffer-using cogl API.
Currently only the nested X11 backend supports this mode fully, and the
per view framebuffers are all offscreen. Upon frame completion, it'll
blit each view's framebuffer onto the onscreen framebuffer before
swapping.
Other backends (X11 CM and native/KMS) are adapted to manage a
full-stage view. The X11 CM backend will continue to use this method,
while the native/KMS backend will be adopted to use multiple view
drawing.
https://bugzilla.gnome.org/show_bug.cgi?id=768976
2016-05-26 23:09:24 -04:00
|
|
|
ClutterBackend * meta_backend_get_clutter_backend (MetaBackend *backend);
|
|
|
|
|
2021-09-07 04:35:27 -04:00
|
|
|
META_EXPORT_TEST
|
2021-08-16 21:38:52 -04:00
|
|
|
ClutterSeat * meta_backend_get_default_seat (MetaBackend *backend);
|
2021-03-12 02:31:50 -05:00
|
|
|
|
2019-10-09 10:03:24 -04:00
|
|
|
MetaIdleMonitor * meta_backend_get_idle_monitor (MetaBackend *backend,
|
|
|
|
ClutterInputDevice *device);
|
2021-04-19 09:22:57 -04:00
|
|
|
|
|
|
|
MetaIdleManager * meta_backend_get_idle_manager (MetaBackend *backend);
|
2016-12-01 03:15:16 -05:00
|
|
|
|
2021-11-29 11:27:27 -05:00
|
|
|
META_EXPORT_TEST
|
2021-10-25 04:50:02 -04:00
|
|
|
MetaColorManager * meta_backend_get_color_manager (MetaBackend *backend);
|
|
|
|
|
2020-05-04 16:47:34 -04:00
|
|
|
META_EXPORT_TEST
|
2017-04-28 11:49:00 -04:00
|
|
|
MetaOrientationManager * meta_backend_get_orientation_manager (MetaBackend *backend);
|
2022-01-14 16:16:46 -05:00
|
|
|
META_EXPORT_TEST
|
2016-11-29 07:30:22 -05:00
|
|
|
MetaCursorTracker * meta_backend_get_cursor_tracker (MetaBackend *backend);
|
2020-07-10 17:28:50 -04:00
|
|
|
MetaCursorRenderer * meta_backend_get_cursor_renderer_for_device (MetaBackend *backend,
|
|
|
|
ClutterInputDevice *device);
|
2023-04-17 12:35:37 -04:00
|
|
|
META_EXPORT_TEST
|
2014-08-05 08:11:59 -04:00
|
|
|
MetaCursorRenderer * meta_backend_get_cursor_renderer (MetaBackend *backend);
|
2019-01-22 21:25:35 -05:00
|
|
|
META_EXPORT_TEST
|
2016-05-07 11:07:46 -04:00
|
|
|
MetaRenderer * meta_backend_get_renderer (MetaBackend *backend);
|
2016-08-17 22:18:28 -04:00
|
|
|
MetaEgl * meta_backend_get_egl (MetaBackend *backend);
|
2014-08-05 08:11:59 -04:00
|
|
|
|
2022-03-10 18:20:27 -05:00
|
|
|
MetaDbusSessionWatcher * meta_backend_get_dbus_session_watcher (MetaBackend *backend);
|
|
|
|
|
2017-06-21 02:23:44 -04:00
|
|
|
#ifdef HAVE_REMOTE_DESKTOP
|
|
|
|
MetaRemoteDesktop * meta_backend_get_remote_desktop (MetaBackend *backend);
|
2020-06-17 11:46:25 -04:00
|
|
|
|
|
|
|
MetaScreenCast * meta_backend_get_screen_cast (MetaBackend *backend);
|
2017-06-21 02:23:44 -04:00
|
|
|
#endif
|
|
|
|
|
2022-04-13 05:39:56 -04:00
|
|
|
MetaInputCapture * meta_backend_get_input_capture (MetaBackend *backend);
|
|
|
|
|
2014-08-05 08:11:59 -04:00
|
|
|
gboolean meta_backend_grab_device (MetaBackend *backend,
|
|
|
|
int device_id,
|
|
|
|
uint32_t timestamp);
|
|
|
|
gboolean meta_backend_ungrab_device (MetaBackend *backend,
|
|
|
|
int device_id,
|
|
|
|
uint32_t timestamp);
|
|
|
|
|
2019-10-24 15:19:36 -04:00
|
|
|
void meta_backend_finish_touch_sequence (MetaBackend *backend,
|
|
|
|
ClutterEventSequence *sequence,
|
|
|
|
MetaSequenceState state);
|
|
|
|
|
2022-01-14 16:16:46 -05:00
|
|
|
META_EXPORT_TEST
|
2016-11-30 23:59:47 -05:00
|
|
|
MetaLogicalMonitor * meta_backend_get_current_logical_monitor (MetaBackend *backend);
|
|
|
|
|
2014-08-05 08:11:59 -04:00
|
|
|
struct xkb_keymap * meta_backend_get_keymap (MetaBackend *backend);
|
|
|
|
|
2017-08-17 05:01:50 -04:00
|
|
|
xkb_layout_index_t meta_backend_get_keymap_layout_group (MetaBackend *backend);
|
|
|
|
|
2018-04-16 14:07:45 -04:00
|
|
|
gboolean meta_backend_is_lid_closed (MetaBackend *backend);
|
|
|
|
|
2015-06-17 00:10:52 -04:00
|
|
|
void meta_backend_set_client_pointer_constraint (MetaBackend *backend,
|
|
|
|
MetaPointerConstraint *constraint);
|
|
|
|
|
2016-07-06 03:27:45 -04:00
|
|
|
void meta_backend_monitors_changed (MetaBackend *backend);
|
|
|
|
|
2022-05-27 14:30:37 -04:00
|
|
|
gboolean meta_backend_is_stage_views_scaled (MetaBackend *backend);
|
2017-02-24 05:10:52 -05:00
|
|
|
|
2020-08-04 08:17:39 -04:00
|
|
|
MetaInputMapper *meta_backend_get_input_mapper (MetaBackend *backend);
|
2016-05-13 07:31:52 -04:00
|
|
|
MetaInputSettings *meta_backend_get_input_settings (MetaBackend *backend);
|
|
|
|
|
2017-03-29 02:30:10 -04:00
|
|
|
void meta_backend_notify_keymap_changed (MetaBackend *backend);
|
|
|
|
|
|
|
|
void meta_backend_notify_keymap_layout_group_changed (MetaBackend *backend,
|
|
|
|
unsigned int locked_group);
|
|
|
|
|
2019-01-11 09:35:42 -05:00
|
|
|
META_EXPORT_TEST
|
|
|
|
void meta_backend_add_gpu (MetaBackend *backend,
|
|
|
|
MetaGpu *gpu);
|
|
|
|
|
|
|
|
META_EXPORT_TEST
|
|
|
|
GList * meta_backend_get_gpus (MetaBackend *backend);
|
|
|
|
|
2020-03-06 08:12:59 -05:00
|
|
|
#ifdef HAVE_LIBWACOM
|
|
|
|
WacomDeviceDatabase * meta_backend_get_wacom_database (MetaBackend *backend);
|
|
|
|
#endif
|
|
|
|
|
2020-07-13 11:45:41 -04:00
|
|
|
void meta_backend_add_hw_cursor_inhibitor (MetaBackend *backend,
|
|
|
|
MetaHwCursorInhibitor *inhibitor);
|
|
|
|
|
|
|
|
void meta_backend_remove_hw_cursor_inhibitor (MetaBackend *backend,
|
|
|
|
MetaHwCursorInhibitor *inhibitor);
|
|
|
|
|
|
|
|
gboolean meta_backend_is_hw_cursors_inhibited (MetaBackend *backend);
|
|
|
|
|
2022-02-05 07:11:06 -05:00
|
|
|
void meta_backend_update_from_event (MetaBackend *backend,
|
|
|
|
ClutterEvent *event);
|
|
|
|
|
2021-10-28 10:08:25 -04:00
|
|
|
char * meta_backend_get_vendor_name (MetaBackend *backend,
|
|
|
|
const char *pnp_id);
|
2023-10-11 04:41:00 -04:00
|
|
|
|
|
|
|
META_EXPORT_TEST
|
|
|
|
uint32_t meta_clutter_button_to_evdev (uint32_t clutter_button);
|
|
|
|
|
|
|
|
META_EXPORT_TEST
|
|
|
|
uint32_t meta_evdev_button_to_clutter (uint32_t evdev_button);
|