mirror of
https://github.com/brl/mutter.git
synced 2024-11-28 02:50:41 -05:00
40e820f551
This breaks down the assumptions in stack-tracker.c and stack.c that
Mutter is only stacking X windows.
The stack tracker now tracks windows using a MetaStackWindow structure
which is a union with a type member so that X windows can be
distinguished from Wayland windows.
Some notable changes are:
Queued stack tracker operations that affect Wayland windows will not be
associated with an X serial number.
If an operation only affects a Wayland window and there are no queued
stack tracker operations ("unvalidated predictions") then the operation
is applied immediately since there is no server involved with changing
the stacking for Wayland windows.
The stack tracker can no longer respond to X events by turning them into
stack operations and discarding the predicted operations made prior to
that event because operations based on X events don't know anything
about the stacking of Wayland windows.
Instead of discarding old predictions the new approach is to trust the
predictions but whenever we receive an event from the server that
affects stacking we cross-reference with the predicted stack and check
for consistency. So e.g. if we have an event that says ADD window A then
we apply the predictions (up to the serial for that event) and verify
the predicted state includes a window A. Similarly if an event says
RAISE_ABOVE(B, C) we can apply the predictions (up to the serial for
that event) and verify that window B is above C.
If we ever receive spurious stacking events (with a serial older than we
would expect) or find an inconsistency (some things aren't possible to
predict from the compositor) then we hit a re-synchronization code-path
that will query the X server for the full stacking order and then use
that stack to walk through our combined stack and force the X windows to
match the just queried stack but avoiding disrupting the relative
stacking of Wayland windows. This will be relatively expensive but
shouldn't be hit for compositor initiated restacking operations where
our predictions should be accurate.
The code in core/stack.c that deals with synchronizing the window stack
with the X server had to be updated quite heavily. In general the patch
avoids changing the fundamental approach being used but most of the code
did need some amount of re-factoring to consider what re-stacking
operations actually involve X or not and when we need to restack X
windows we sometimes need to search for a suitable X sibling to restack
relative too since the closest siblings may be Wayland windows.
109 lines
4.7 KiB
C
109 lines
4.7 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
|
|
/**
|
|
* \file stack-tracker.h Track stacking order for compositor
|
|
*
|
|
* MetaStackTracker maintains the most accurate view we have at a
|
|
* given point of time of the ordering of the children of the root
|
|
* window (including override-redirect windows.) This is used to order
|
|
* the windows when the compositor draws them.
|
|
*
|
|
* By contrast, MetaStack is responsible for keeping track of how we
|
|
* think that windows *should* be ordered. For windows we manage
|
|
* (non-override-redirect windows), the two stacking orders will be
|
|
* the same.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2009 Red Hat, Inc.
|
|
*
|
|
* 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_STACK_TRACKER_H
|
|
#define META_STACK_TRACKER_H
|
|
|
|
#include <meta/screen.h>
|
|
#include <meta/window.h>
|
|
|
|
typedef struct _MetaStackTracker MetaStackTracker;
|
|
|
|
typedef union _MetaStackWindow
|
|
{
|
|
struct {
|
|
MetaWindowClientType type;
|
|
} any;
|
|
struct {
|
|
MetaWindowClientType type;
|
|
Window xwindow;
|
|
} x11;
|
|
struct {
|
|
MetaWindowClientType type;
|
|
MetaWindow *meta_window;
|
|
} wayland;
|
|
} MetaStackWindow;
|
|
|
|
gboolean meta_stack_window_equal (const MetaStackWindow *a,
|
|
const MetaStackWindow *b);
|
|
|
|
MetaStackTracker *meta_stack_tracker_new (MetaScreen *screen);
|
|
void meta_stack_tracker_free (MetaStackTracker *tracker);
|
|
|
|
/* These functions are called when we make an X call that changes the
|
|
* stacking order; this allows MetaStackTracker to predict stacking
|
|
* order before it receives events back from the X server */
|
|
void meta_stack_tracker_record_add (MetaStackTracker *tracker,
|
|
const MetaStackWindow *window,
|
|
gulong serial);
|
|
void meta_stack_tracker_record_remove (MetaStackTracker *tracker,
|
|
const MetaStackWindow *window,
|
|
gulong serial);
|
|
void meta_stack_tracker_record_restack_windows (MetaStackTracker *tracker,
|
|
const MetaStackWindow *windows,
|
|
int n_windows,
|
|
gulong serial);
|
|
void meta_stack_tracker_record_raise_above (MetaStackTracker *tracker,
|
|
const MetaStackWindow *window,
|
|
const MetaStackWindow *sibling,
|
|
gulong serial);
|
|
void meta_stack_tracker_record_lower_below (MetaStackTracker *tracker,
|
|
const MetaStackWindow *window,
|
|
const MetaStackWindow *sibling,
|
|
gulong serial);
|
|
void meta_stack_tracker_record_lower (MetaStackTracker *tracker,
|
|
const MetaStackWindow *window,
|
|
gulong serial);
|
|
|
|
/* These functions are used to update the stack when we get events
|
|
* reflecting changes to the stacking order */
|
|
void meta_stack_tracker_create_event (MetaStackTracker *tracker,
|
|
XCreateWindowEvent *event);
|
|
void meta_stack_tracker_destroy_event (MetaStackTracker *tracker,
|
|
XDestroyWindowEvent *event);
|
|
void meta_stack_tracker_reparent_event (MetaStackTracker *tracker,
|
|
XReparentEvent *event);
|
|
void meta_stack_tracker_configure_event (MetaStackTracker *tracker,
|
|
XConfigureEvent *event);
|
|
|
|
void meta_stack_tracker_get_stack (MetaStackTracker *tracker,
|
|
MetaStackWindow **windows,
|
|
int *n_entries);
|
|
|
|
void meta_stack_tracker_sync_stack (MetaStackTracker *tracker);
|
|
void meta_stack_tracker_queue_sync_stack (MetaStackTracker *tracker);
|
|
|
|
#endif /* META_STACK_TRACKER_H */
|