marco 1.29.1
Window manager
Loading...
Searching...
No Matches
display.c File Reference
View source

Handles operations on an X display. More...

#include <config.h>
#include <glib/gi18n-lib.h>
#include "display-private.h"
#include "util.h"
#include "main.h"
#include "screen-private.h"
#include "window-private.h"
#include "window-props.h"
#include "group-props.h"
#include "frame-private.h"
#include "errors.h"
#include "keybindings.h"
#include "prefs.h"
#include "resizepopup.h"
#include "xprops.h"
#include "workspace.h"
#include "bell.h"
#include "effects.h"
#include "compositor.h"
#include <X11/Xatom.h>
#include <X11/cursorfont.h>
#include <X11/extensions/XRes.h>
#include <gdk/gdkx.h>
#include <string.h>
#include "atomnames.h"
Include dependency graph for display.c:

Data Structures

struct  MetaPingData
 Describes a ping on a window. More...
 
struct  MetaAutoRaiseData
 

Macros

#define GRAB_OP_IS_WINDOW_SWITCH(g)
 
#define item(x)   #x,
 
#define item(x)   the_display->atom_##x = atoms[idx++];
 
#define GRAB_MASK
 
#define MAX_FOCUS_BUTTON   4
 
#define PING_TIMEOUT_DELAY   5000
 How long, in milliseconds, we should wait after pinging a window before deciding it's not going to get back to us.
 
#define IN_TAB_CHAIN(w, t)
 
#define N_TARGETS   4
 

Functions

static gboolean event_callback (XEvent *event, gpointer data)
 This is the most important function in the whole program.
 
static Window event_get_modified_window (MetaDisplay *display, XEvent *event)
 
static guint32 event_get_time (MetaDisplay *display, XEvent *event)
 
static void process_request_frame_extents (MetaDisplay *display, XEvent *event)
 
static void process_pong_message (MetaDisplay *display, XEvent *event)
 Process the pong (the response message) from the ping we sent to the window.
 
static void process_selection_request (MetaDisplay *display, XEvent *event)
 
static void process_selection_clear (MetaDisplay *display, XEvent *event)
 
static void update_window_grab_modifiers (MetaDisplay *display)
 
static void prefs_changed_callback (MetaPreference pref, void *data)
 
static void sanity_check_timestamps (MetaDisplay *display, guint32 known_good_timestamp)
 
MetaGroup * get_focussed_group (MetaDisplay *display)
 
static void ping_data_free (MetaPingData *ping_data)
 Destructor for MetaPingData structs.
 
static void remove_pending_pings_for_window (MetaDisplay *display, Window xwindow)
 Frees every pending ping structure for the given X window on the given display.
 
static void enable_compositor (MetaDisplay *display, gboolean composite_windows)
 
static void disable_compositor (MetaDisplay *display)
 
gboolean meta_display_open (void)
 Opens a new display, sets it up, initialises all the X extensions we will need, and adds it to the list of displays.
 
static void listify_func (gpointer key, gpointer value, gpointer data)
 
static gint ptrcmp (gconstpointer a, gconstpointer b)
 
GSList * meta_display_list_windows (MetaDisplay *display)
 
void meta_display_close (MetaDisplay *display, guint32 timestamp)
 
MetaScreen * meta_display_screen_for_root (MetaDisplay *display, Window xroot)
 
MetaScreen * meta_display_screen_for_xwindow (MetaDisplay *display, Window xwindow)
 
MetaScreen * meta_display_screen_for_x_screen (MetaDisplay *display, Screen *xscreen)
 
void meta_display_grab (MetaDisplay *display)
 
void meta_display_ungrab (MetaDisplay *display)
 
MetaDisplay * meta_display_for_x_display (Display *xdisplay)
 Returns the singleton MetaDisplay if "xdisplay" matches the X display it's managing; otherwise gives a warning and returns NULL.
 
MetaDisplay * meta_get_display (void)
 Accessor for the singleton MetaDisplay.
 
static gboolean grab_op_is_mouse_only (MetaGrabOp op)
 
static gboolean grab_op_is_mouse (MetaGrabOp op)
 
static gboolean grab_op_is_keyboard (MetaGrabOp op)
 
gboolean meta_grab_op_is_resizing (MetaGrabOp op)
 
gboolean meta_grab_op_is_moving (MetaGrabOp op)
 
guint32 meta_display_get_current_time (MetaDisplay *display)
 
guint32 meta_display_get_current_time_roundtrip (MetaDisplay *display)
 
static void add_ignored_serial (MetaDisplay *display, unsigned long serial)
 
static gboolean serial_is_ignored (MetaDisplay *display, unsigned long serial)
 
static void reset_ignores (MetaDisplay *display)
 
static gboolean window_raise_with_delay_callback (void *data)
 
void meta_display_queue_autoraise_callback (MetaDisplay *display, MetaWindow *window)
 
static gboolean maybe_send_event_to_gtk (MetaDisplay *display, XEvent *xevent)
 
static gboolean mouse_event_is_in_tab_popup (MetaDisplay *display, MetaScreen *screen, Window event_window, int event_x, int event_y, int *popup_x, int *popup_y)
 
MetaWindow * meta_display_lookup_x_window (MetaDisplay *display, Window xwindow)
 
void meta_display_register_x_window (MetaDisplay *display, Window *xwindowp, MetaWindow *window)
 
void meta_display_unregister_x_window (MetaDisplay *display, Window xwindow)
 
gboolean meta_display_xwindow_is_a_no_focus_window (MetaDisplay *display, Window xwindow)
 
Cursor meta_display_create_x_cursor (MetaDisplay *display, MetaCursor cursor)
 
static Cursor xcursor_for_op (MetaDisplay *display, MetaGrabOp op)
 
void meta_display_set_grab_op_cursor (MetaDisplay *display, MetaScreen *screen, MetaGrabOp op, gboolean change_pointer, Window grab_xwindow, guint32 timestamp)
 
gboolean meta_display_begin_grab_op (MetaDisplay *display, MetaScreen *screen, MetaWindow *window, MetaGrabOp op, gboolean pointer_already_grabbed, gboolean frame_action, int button, gulong modmask, guint32 timestamp, int root_x, int root_y)
 
void meta_display_end_grab_op (MetaDisplay *display, guint32 timestamp)
 
void meta_display_check_threshold_reached (MetaDisplay *display, int x, int y)
 
static void meta_change_button_grab (MetaDisplay *display, Window xwindow, gboolean grab, gboolean sync, int button, int modmask)
 
void meta_display_grab_window_buttons (MetaDisplay *display, Window xwindow)
 
void meta_display_ungrab_window_buttons (MetaDisplay *display, Window xwindow)
 
void meta_display_grab_focus_window_button (MetaDisplay *display, MetaWindow *window)
 
void meta_display_ungrab_focus_window_button (MetaDisplay *display, MetaWindow *window)
 
void meta_display_increment_event_serial (MetaDisplay *display)
 
void meta_display_update_active_window_hint (MetaDisplay *display)
 
void meta_display_queue_retheme_all_windows (MetaDisplay *display)
 
void meta_display_retheme_all (void)
 
void meta_display_set_cursor_theme (const char *theme, int size)
 
gboolean meta_is_syncing (void)
 Returns whether X synchronisation is currently enabled.
 
void meta_set_syncing (gboolean setting)
 A handy way to turn on synchronisation on or off for every display.
 
static gboolean meta_display_ping_timeout (gpointer data)
 Does whatever it is we decided to do when a window didn't respond to a ping.
 
void meta_display_ping_window (MetaDisplay *display, MetaWindow *window, guint32 timestamp, MetaWindowPingFunc ping_reply_func, MetaWindowPingFunc ping_timeout_func, gpointer user_data)
 Sends a ping request to a window.
 
gboolean meta_display_window_has_pending_pings (MetaDisplay *display, MetaWindow *window)
 Finds whether a window has any pings waiting on it.
 
static MetaWindow * find_tab_forward (MetaDisplay *display, MetaTabList type, MetaScreen *screen, MetaWorkspace *workspace, GList *start, gboolean skip_first)
 
static MetaWindow * find_tab_backward (MetaDisplay *display, MetaTabList type, MetaScreen *screen, MetaWorkspace *workspace, GList *start, gboolean skip_last)
 
static int mru_cmp (gconstpointer a, gconstpointer b)
 
GList * meta_display_get_tab_list (MetaDisplay *display, MetaTabList type, MetaScreen *screen, MetaWorkspace *active_workspace)
 
MetaWindow * meta_display_get_tab_next (MetaDisplay *display, MetaTabList type, MetaScreen *screen, MetaWorkspace *workspace, MetaWindow *window, gboolean backward)
 
MetaWindow * meta_display_get_tab_current (MetaDisplay *display, MetaTabList type, MetaScreen *screen, MetaWorkspace *workspace)
 
int meta_resize_gravity_from_grab_op (MetaGrabOp op)
 
static MetaScreen * find_screen_for_selection (MetaDisplay *display, Window owner, Atom selection)
 
static gboolean convert_property (MetaDisplay *display, MetaScreen *screen, Window w, Atom target, Atom property)
 
void meta_display_unmanage_screen (MetaDisplay *display, MetaScreen *screen, guint32 timestamp)
 
void meta_display_unmanage_windows_for_screen (MetaDisplay *display, MetaScreen *screen, guint32 timestamp)
 
int meta_display_stack_cmp (const void *a, const void *b)
 
void meta_display_devirtualize_modifiers (MetaDisplay *display, MetaVirtualModifier modifiers, unsigned int *mask)
 
void meta_display_increment_focus_sentinel (MetaDisplay *display)
 
void meta_display_decrement_focus_sentinel (MetaDisplay *display)
 
gboolean meta_display_focus_sentinel_clear (MetaDisplay *display)
 
static gboolean timestamp_too_old (MetaDisplay *display, MetaWindow *window, guint32 *timestamp)
 
void meta_display_set_input_focus_window (MetaDisplay *display, MetaWindow *window, gboolean focus_frame, guint32 timestamp)
 
void meta_display_focus_the_no_focus_window (MetaDisplay *display, MetaScreen *screen, guint32 timestamp)
 
void meta_display_remove_autoraise_callback (MetaDisplay *display)
 
Display * meta_display_get_xdisplay (MetaDisplay *display)
 
MetaCompositor * meta_display_get_compositor (MetaDisplay *display)
 
GSList * meta_display_get_screens (MetaDisplay *display)
 
gboolean meta_display_has_shape (MetaDisplay *display)
 
MetaWindow * meta_display_get_focus_window (MetaDisplay *display)
 

Variables

static MetaDisplay * the_display = NULL
 The display we're managing.
 
static gboolean is_syncing = FALSE
 Stores whether syncing is currently enabled.
 

Detailed Description

Handles operations on an X display.

The display is represented as a MetaDisplay struct.

Macro Definition Documentation

◆ GRAB_MASK

#define GRAB_MASK
Value:
(PointerMotionMask | \
ButtonPressMask | ButtonReleaseMask | \
EnterWindowMask | LeaveWindowMask)

◆ GRAB_OP_IS_WINDOW_SWITCH

#define GRAB_OP_IS_WINDOW_SWITCH (   g)
Value:
@ META_GRAB_OP_KEYBOARD_TABBING_GROUP
Definition common.h:133
@ META_GRAB_OP_KEYBOARD_ESCAPING_NORMAL_ALL_WORKSPACES
Definition common.h:127
@ META_GRAB_OP_KEYBOARD_TABBING_NORMAL_ALL_WORKSPACES
Definition common.h:123
@ META_GRAB_OP_KEYBOARD_ESCAPING_DOCK
Definition common.h:128
@ META_GRAB_OP_KEYBOARD_ESCAPING_NORMAL
Definition common.h:126
@ META_GRAB_OP_KEYBOARD_TABBING_NORMAL
Definition common.h:121
@ META_GRAB_OP_KEYBOARD_ESCAPING_GROUP
Definition common.h:130
@ META_GRAB_OP_KEYBOARD_TABBING_DOCK
Definition common.h:122

◆ IN_TAB_CHAIN

#define IN_TAB_CHAIN (   w,
  t 
)
Value:
@ META_TAB_LIST_GROUP
Definition display-private.h:462
@ META_TAB_LIST_DOCKS
Definition display-private.h:461
@ META_TAB_LIST_NORMAL
Definition display-private.h:460
@ META_TAB_LIST_NORMAL_ALL_WORKSPACES
Definition display-private.h:463
MetaGroup * get_focussed_group(MetaDisplay *display)
Definition display.c:4629
#define META_WINDOW_IN_GROUP_TAB_CHAIN(w, g)
Definition window-private.h:656
#define META_WINDOW_IN_NORMAL_TAB_CHAIN(w)
Definition window-private.h:652
#define META_WINDOW_IN_DOCK_TAB_CHAIN(w)
Definition window-private.h:654

◆ item [1/2]

#define item (   x)    #x,

◆ item [2/2]

#define item (   x)    the_display->atom_##x = atoms[idx++];

◆ MAX_FOCUS_BUTTON

#define MAX_FOCUS_BUTTON   4

◆ N_TARGETS

#define N_TARGETS   4

◆ PING_TIMEOUT_DELAY

#define PING_TIMEOUT_DELAY   5000

How long, in milliseconds, we should wait after pinging a window before deciding it's not going to get back to us.

Function Documentation

◆ add_ignored_serial()

static void add_ignored_serial ( MetaDisplay *  display,
unsigned long  serial 
)
static

◆ convert_property()

static gboolean convert_property ( MetaDisplay *  display,
MetaScreen *  screen,
Window  w,
Atom  target,
Atom  property 
)
static

References FALSE, META_DEBUG_SYNC, meta_error_trap_pop_with_return(), meta_error_trap_push(), N_TARGETS, screen, TRUE, and _MetaDisplay::xdisplay.

Referenced by process_selection_request().

Here is the call graph for this function:

◆ disable_compositor()

static void disable_compositor ( MetaDisplay *  display)
static

References _MetaDisplay::compositor, meta_compositor_destroy(), meta_compositor_unmanage_screen(), NULL, screen, and _MetaDisplay::screens.

Referenced by prefs_changed_callback().

Here is the call graph for this function:

◆ enable_compositor()

static void enable_compositor ( MetaDisplay *  display,
gboolean  composite_windows 
)
static

References _, _MetaDisplay::compositor, meta_compositor_manage_screen(), meta_compositor_new(), META_DISPLAY_HAS_COMPOSITE, META_DISPLAY_HAS_DAMAGE, META_DISPLAY_HAS_RENDER, META_DISPLAY_HAS_XFIXES, meta_screen_composite_all_windows(), meta_warning(), NULL, screen, and _MetaDisplay::screens.

Referenced by meta_display_open(), and prefs_changed_callback().

Here is the call graph for this function:

◆ event_callback()

static gboolean event_callback ( XEvent *  event,
gpointer  data 
)
static

This is the most important function in the whole program.

It is the heart, it is the nexus, it is the Grand Central Station of Marco's world. When we create a MetaDisplay, we ask GDK to pass all events for all windows to this function. So every time anything happens that we might want to know about, this function gets called. You see why it gets a bit busy around here. Most of this function is a ginormous switch statement dealing with all the kinds of events that might turn up.

Parameters
eventThe event that just happened
dataThe MetaDisplay that events are coming from, cast to a gpointer so that it can be sent to a callback

References _MetaDisplay::active_screen, _MetaScreen::active_workspace, add_ignored_serial(), _MetaDisplay::allow_terminal_deactivation, _MetaWindow::colormap, _MetaDisplay::compositor, _MetaDisplay::current_time, _MetaWindow::desc, event_get_modified_window(), event_get_time(), _MetaDisplay::expected_focus_window, FALSE, _MetaDisplay::focus_window, _MetaWindow::frame, _MetaDisplay::grab_button, _MetaDisplay::grab_old_window_stacking, _MetaDisplay::grab_op, grab_op_is_keyboard(), grab_op_is_mouse(), GRAB_OP_IS_WINDOW_SWITCH, _MetaDisplay::grab_window, _MetaWindow::has_focus, _MetaWindow::has_move_func, _MetaWindow::has_resize_func, _MetaWindow::has_shape, _MetaRectangle::height, _MetaFrame::mapped, _MetaWindow::mapped, maybe_send_event_to_gtk(), meta_compositor_process_event(), META_DEBUG_EVENTS, META_DEBUG_FOCUS, META_DEBUG_SHAPES, META_DEBUG_WINDOW_OPS, META_DEBUG_WINDOW_STATE, meta_display_begin_grab_op(), meta_display_decrement_focus_sentinel(), meta_display_end_grab_op(), meta_display_focus_sentinel_clear(), meta_display_focus_the_no_focus_window(), meta_display_get_current_time_roundtrip(), META_DISPLAY_HAS_SHAPE, META_DISPLAY_HAS_XSYNC, meta_display_lookup_group(), meta_display_lookup_x_window(), meta_display_process_key_event(), meta_display_process_mapping_event(), meta_display_queue_autoraise_callback(), meta_display_retheme_all(), meta_display_screen_for_root(), meta_display_xwindow_is_a_no_focus_window(), meta_effect_run_close(), meta_error_trap_pop(), meta_error_trap_push(), meta_event_detail_to_string(), meta_event_mode_to_string(), META_FOCUS_MODE_CLICK, META_FOCUS_MODE_MOUSE, META_FOCUS_MODE_SLOPPY, META_GRAB_OP_MOVING, META_GRAB_OP_NONE, META_GRAB_OP_RESIZING_E, META_GRAB_OP_RESIZING_N, META_GRAB_OP_RESIZING_NE, META_GRAB_OP_RESIZING_NW, META_GRAB_OP_RESIZING_S, META_GRAB_OP_RESIZING_SE, META_GRAB_OP_RESIZING_SW, META_GRAB_OP_RESIZING_W, meta_group_property_notify(), meta_is_verbose(), meta_prefs_get_application_based(), meta_prefs_get_auto_raise(), meta_prefs_get_focus_mode(), meta_prefs_get_mouse_button_menu(), meta_prefs_get_mouse_button_resize(), meta_prefs_get_raise_on_click(), meta_prefs_get_theme(), meta_prefs_set_num_workspaces(), META_QUEUE_MOVE_RESIZE, meta_restart(), meta_screen_get_workspace_by_index(), meta_screen_resize(), meta_screen_show_desktop(), meta_screen_unshow_desktop(), meta_screen_update_workspace_layout(), meta_screen_update_workspace_names(), meta_set_keybindings_disabled(), meta_set_verbose(), meta_stack_set_positions(), meta_ui_set_current_theme(), meta_ui_tab_popup_mouse_press(), meta_ui_window_should_not_cause_focus(), meta_warning(), meta_window_change_workspace(), meta_window_client_message(), meta_window_configure_request(), META_WINDOW_DESKTOP, meta_window_destroy_frame(), META_WINDOW_DOCK, meta_window_focus(), meta_window_free(), meta_window_get_position(), meta_window_handle_mouse_grab_op_event(), meta_window_lower(), meta_window_new(), meta_window_notify_focus(), meta_window_property_notify(), meta_window_queue(), meta_window_raise(), meta_window_same_application(), meta_window_set_user_time(), meta_window_show_menu(), meta_window_unminimize(), meta_workspace_activate(), meta_workspace_focus_default_window(), _MetaWindow::minimized, mouse_event_is_in_tab_popup(), _MetaDisplay::mouse_mode, _MetaFrame::need_reapply_frame_shape, NULL, process_pong_message(), process_request_frame_extents(), process_selection_clear(), process_selection_request(), _MetaWindow::rect, reset_ignores(), sanity_check_timestamps(), _MetaWindow::screen, screen, serial_is_ignored(), _MetaDisplay::tab_popup_mouse_pressed, TRUE, _MetaWindow::type, _MetaDisplay::ungrab_should_not_cause_focus_window, _MetaWindow::unmaps_pending, _MetaWindow::user_time_window, _MetaRectangle::width, _MetaFrame::window, _MetaDisplay::window_grab_modifiers, _MetaWindow::withdrawn, _MetaWindow::workspace, _MetaDisplay::xdisplay, _MetaDisplay::xinerama_cache_invalidated, XSERVER_TIME_IS_BEFORE, and _MetaFrame::xwindow.

Referenced by meta_display_close(), and meta_display_open().

◆ event_get_modified_window()

static Window event_get_modified_window ( MetaDisplay *  display,
XEvent *  event 
)
static

References META_DISPLAY_HAS_SHAPE.

Referenced by event_callback().

◆ event_get_time()

static guint32 event_get_time ( MetaDisplay *  display,
XEvent *  event 
)
static

Referenced by event_callback().

◆ find_screen_for_selection()

static MetaScreen * find_screen_for_selection ( MetaDisplay *  display,
Window  owner,
Atom  selection 
)
static

◆ find_tab_backward()

static MetaWindow * find_tab_backward ( MetaDisplay *  display,
MetaTabList  type,
MetaScreen *  screen,
MetaWorkspace *  workspace,
GList *  start,
gboolean  skip_last 
)
static

◆ find_tab_forward()

static MetaWindow * find_tab_forward ( MetaDisplay *  display,
MetaTabList  type,
MetaScreen *  screen,
MetaWorkspace *  workspace,
GList *  start,
gboolean  skip_first 
)
static

◆ get_focussed_group()

MetaGroup * get_focussed_group ( MetaDisplay *  display)

◆ grab_op_is_keyboard()

◆ grab_op_is_mouse()

◆ grab_op_is_mouse_only()

◆ listify_func()

static void listify_func ( gpointer  key,
gpointer  value,
gpointer  data 
)
static

◆ maybe_send_event_to_gtk()

static gboolean maybe_send_event_to_gtk ( MetaDisplay *  display,
XEvent *  xevent 
)
static

◆ meta_change_button_grab()

static void meta_change_button_grab ( MetaDisplay *  display,
Window  xwindow,
gboolean  grab,
gboolean  sync,
int  button,
int  modmask 
)
static

◆ meta_display_begin_grab_op()

gboolean meta_display_begin_grab_op ( MetaDisplay *  display,
MetaScreen *  screen,
MetaWindow *  window,
MetaGrabOp  op,
gboolean  pointer_already_grabbed,
gboolean  frame_action,
int  button,
gulong  modmask,
guint32  timestamp,
int  root_x,
int  root_y 
)

References _MetaDisplay::compositor, _MetaWindow::desc, FALSE, _MetaWindow::frame, _MetaDisplay::grab_anchor_root_x, _MetaDisplay::grab_anchor_root_y, _MetaDisplay::grab_anchor_window_pos, _MetaDisplay::grab_button, _MetaDisplay::grab_frame_action, _MetaDisplay::grab_have_keyboard, _MetaDisplay::grab_have_pointer, _MetaDisplay::grab_initial_window_pos, _MetaDisplay::grab_initial_x, _MetaDisplay::grab_initial_y, _MetaDisplay::grab_last_moveresize_time, _MetaDisplay::grab_last_user_action_was_snap, _MetaDisplay::grab_latest_motion_x, _MetaDisplay::grab_latest_motion_y, _MetaDisplay::grab_mask, _MetaDisplay::grab_motion_notify_time, _MetaDisplay::grab_old_window_stacking, _MetaDisplay::grab_op, grab_op_is_keyboard(), grab_op_is_mouse(), grab_op_is_mouse_only(), GRAB_OP_IS_WINDOW_SWITCH, _MetaDisplay::grab_resize_timeout_id, _MetaDisplay::grab_screen, _MetaDisplay::grab_threshold_movement_reached, _MetaDisplay::grab_tile_match, _MetaDisplay::grab_tile_mode, _MetaDisplay::grab_tile_monitor_number, _MetaDisplay::grab_was_cancelled, _MetaDisplay::grab_window, _MetaDisplay::grab_wireframe_active, _MetaDisplay::grab_xwindow, meta_compositor_begin_move(), META_DEBUG_RESIZING, META_DEBUG_WINDOW_OPS, meta_display_set_grab_op_cursor(), meta_error_trap_pop_with_return(), meta_error_trap_push(), meta_grab_op_is_moving(), meta_grab_op_is_resizing(), META_GRAB_OP_KEYBOARD_ESCAPING_DOCK, META_GRAB_OP_KEYBOARD_ESCAPING_GROUP, META_GRAB_OP_KEYBOARD_ESCAPING_NORMAL, META_GRAB_OP_KEYBOARD_ESCAPING_NORMAL_ALL_WORKSPACES, META_GRAB_OP_KEYBOARD_TABBING_DOCK, META_GRAB_OP_KEYBOARD_TABBING_GROUP, META_GRAB_OP_KEYBOARD_TABBING_NORMAL, META_GRAB_OP_KEYBOARD_TABBING_NORMAL_ALL_WORKSPACES, META_GRAB_OP_KEYBOARD_WORKSPACE_MOVING, META_GRAB_OP_KEYBOARD_WORKSPACE_SWITCHING, META_GRAB_OP_NONE, meta_prefs_get_mate_accessibility(), meta_prefs_get_raise_on_click(), meta_prefs_get_reduced_resources(), meta_resize_gravity_from_grab_op(), meta_screen_ensure_tab_popup(), meta_screen_ensure_workspace_popup(), meta_screen_grab_all_keys(), meta_stack_get_positions(), META_TAB_LIST_DOCKS, META_TAB_LIST_GROUP, META_TAB_LIST_NORMAL, META_TAB_LIST_NORMAL_ALL_WORKSPACES, META_TAB_SHOW_ICON, META_TAB_SHOW_INSTANTLY, META_TILE_BOTTOM_LEFT, META_TILE_BOTTOM_RIGHT, META_TILE_LEFT, META_TILE_NONE, META_TILE_RIGHT, META_TILE_TOP_LEFT, META_TILE_TOP_RIGHT, meta_warning(), meta_window_begin_wireframe(), meta_window_calc_showing(), meta_window_find_tile_match(), meta_window_get_client_root_coords(), meta_window_grab_all_keys(), meta_window_raise(), meta_window_refresh_resize_popup(), META_WINDOW_TILED, NULL, _MetaWindow::rect, screen, _MetaDisplay::tab_popup_mouse_pressed, _MetaWindow::tile_mode, _MetaWindow::tile_monitor_number, TRUE, _MetaDisplay::xdisplay, _MetaFrame::xwindow, and _MetaWindow::xwindow.

Referenced by do_choose_window(), event_callback(), handle_workspace_switch_or_move(), meta_core_begin_grab_op(), meta_window_begin_grab_op(), and meta_window_client_message().

Here is the call graph for this function:

◆ meta_display_check_threshold_reached()

void meta_display_check_threshold_reached ( MetaDisplay *  display,
int  x,
int  y 
)

References FALSE, _MetaDisplay::grab_initial_x, _MetaDisplay::grab_initial_y, _MetaDisplay::grab_threshold_movement_reached, meta_prefs_get_raise_on_click(), and TRUE.

Referenced by meta_window_handle_mouse_grab_op_event().

Here is the call graph for this function:

◆ meta_display_close()

◆ meta_display_create_x_cursor()

◆ meta_display_decrement_focus_sentinel()

void meta_display_decrement_focus_sentinel ( MetaDisplay *  display)

◆ meta_display_devirtualize_modifiers()

◆ meta_display_end_grab_op()

void meta_display_end_grab_op ( MetaDisplay *  display,
guint32  timestamp 
)

References _MetaDisplay::compositor, FALSE, _MetaDisplay::grab_have_keyboard, _MetaDisplay::grab_have_pointer, _MetaDisplay::grab_old_window_stacking, _MetaDisplay::grab_op, grab_op_is_mouse(), GRAB_OP_IS_WINDOW_SWITCH, _MetaDisplay::grab_resize_popup, _MetaDisplay::grab_resize_timeout_id, _MetaDisplay::grab_screen, _MetaDisplay::grab_threshold_movement_reached, _MetaDisplay::grab_tile_match, _MetaDisplay::grab_tile_mode, _MetaDisplay::grab_tile_monitor_number, _MetaDisplay::grab_was_cancelled, _MetaDisplay::grab_window, _MetaDisplay::grab_wireframe_active, _MetaDisplay::grab_wireframe_rect, _MetaDisplay::grab_xwindow, _MetaRectangle::height, meta_compositor_end_move(), META_DEBUG_WINDOW_OPS, meta_display_cleanup_edges(), meta_grab_op_is_moving(), meta_grab_op_is_resizing(), META_GRAB_OP_KEYBOARD_WORKSPACE_MOVING, META_GRAB_OP_KEYBOARD_WORKSPACE_SWITCHING, META_GRAB_OP_NONE, meta_prefs_get_raise_on_click(), meta_resize_gravity_from_grab_op(), meta_screen_ungrab_all_keys(), META_TILE_NONE, meta_tile_preview_hide(), meta_ui_resize_popup_free(), meta_ui_tab_popup_free(), meta_window_calc_showing(), meta_window_end_wireframe(), meta_window_move(), meta_window_raise(), meta_window_resize_with_gravity(), meta_window_ungrab_all_keys(), NULL, _MetaWindow::shaken_loose, _MetaScreen::tab_popup, _MetaDisplay::tab_popup_mouse_pressed, _MetaScreen::tile_preview, TRUE, _MetaDisplay::ungrab_should_not_cause_focus_window, _MetaRectangle::width, _MetaRectangle::x, _MetaDisplay::xdisplay, and _MetaRectangle::y.

Referenced by do_choose_window(), event_callback(), handle_workspace_switch_or_move(), meta_core_end_grab_op(), meta_display_process_key_event(), meta_window_client_message(), meta_window_free(), meta_window_handle_mouse_grab_op_event(), process_tab_grab(), and process_workspace_switch_grab().

Here is the call graph for this function:

◆ meta_display_focus_sentinel_clear()

gboolean meta_display_focus_sentinel_clear ( MetaDisplay *  display)

◆ meta_display_focus_the_no_focus_window()

void meta_display_focus_the_no_focus_window ( MetaDisplay *  display,
MetaScreen *  screen,
guint32  timestamp 
)

References _MetaDisplay::active_screen, _MetaDisplay::expected_focus_window, _MetaDisplay::last_focus_time, meta_display_remove_autoraise_callback(), NULL, screen, timestamp_too_old(), and _MetaDisplay::xdisplay.

Referenced by event_callback(), focus_ancestor_or_top_window(), meta_display_open(), and meta_workspace_focus_default_window().

Here is the call graph for this function:

◆ meta_display_for_x_display()

MetaDisplay * meta_display_for_x_display ( Display *  xdisplay)

Returns the singleton MetaDisplay if "xdisplay" matches the X display it's managing; otherwise gives a warning and returns NULL.

When we were claiming to be able to manage multiple displays, this was supposed to find the display out of the list which matched that display. Now it's merely an extra sanity check.

Parameters
xdisplayAn X display
Returns
The singleton X display, or NULL if "xdisplay" isn't the one we're managing.

References meta_warning(), NULL, the_display, and _MetaDisplay::xdisplay.

Referenced by get_window(), menu_callback(), meta_core_begin_grab_op(), meta_core_end_grab_op(), meta_core_get(), meta_core_get_grab_button(), meta_core_get_grab_frame(), meta_core_get_grab_op(), meta_core_get_workspace_name_with_index(), meta_core_grab_buttons(), meta_core_increment_event_serial(), meta_core_lower_beneath_focus_window(), and meta_screen_for_x_screen().

Here is the call graph for this function:

◆ meta_display_get_compositor()

MetaCompositor * meta_display_get_compositor ( MetaDisplay *  display)

◆ meta_display_get_current_time()

◆ meta_display_get_current_time_roundtrip()

guint32 meta_display_get_current_time_roundtrip ( MetaDisplay *  display)

◆ meta_display_get_focus_window()

MetaWindow * meta_display_get_focus_window ( MetaDisplay *  display)

◆ meta_display_get_screens()

GSList * meta_display_get_screens ( MetaDisplay *  display)

References _MetaDisplay::screens.

◆ meta_display_get_tab_current()

MetaWindow * meta_display_get_tab_current ( MetaDisplay *  display,
MetaTabList  type,
MetaScreen *  screen,
MetaWorkspace *  workspace 
)

References _MetaDisplay::focus_window, IN_TAB_CHAIN, meta_window_located_on_workspace(), NULL, _MetaWindow::screen, and screen.

Referenced by do_choose_window().

Here is the call graph for this function:

◆ meta_display_get_tab_list()

◆ meta_display_get_tab_next()

MetaWindow * meta_display_get_tab_next ( MetaDisplay *  display,
MetaTabList  type,
MetaScreen *  screen,
MetaWorkspace *  workspace,
MetaWindow *  window,
gboolean  backward 
)

References _MetaWindow::display, find_tab_backward(), find_tab_forward(), _MetaDisplay::focus_window, meta_display_get_tab_list(), NULL, screen, and TRUE.

Referenced by do_choose_window().

Here is the call graph for this function:

◆ meta_display_get_xdisplay()

Display * meta_display_get_xdisplay ( MetaDisplay *  display)

◆ meta_display_grab()

◆ meta_display_grab_focus_window_button()

void meta_display_grab_focus_window_button ( MetaDisplay *  display,
MetaWindow *  window 
)

References _MetaWindow::desc, _MetaWindow::have_focus_click_grab, MAX_FOCUS_BUTTON, meta_change_button_grab(), META_FOCUS_MODE_CLICK, meta_prefs_get_focus_mode(), TRUE, and _MetaWindow::xwindow.

Referenced by meta_window_new_with_attrs(), meta_window_notify_focus(), and prefs_changed_callback().

Here is the call graph for this function:

◆ meta_display_grab_window_buttons()

void meta_display_grab_window_buttons ( MetaDisplay *  display,
Window  xwindow 
)

References FALSE, meta_change_button_grab(), NULL, TRUE, and _MetaDisplay::window_grab_modifiers.

Referenced by meta_core_grab_buttons(), meta_window_new_with_attrs(), and prefs_changed_callback().

Here is the call graph for this function:

◆ meta_display_has_shape()

gboolean meta_display_has_shape ( MetaDisplay *  display)

◆ meta_display_increment_event_serial()

void meta_display_increment_event_serial ( MetaDisplay *  display)

◆ meta_display_increment_focus_sentinel()

void meta_display_increment_focus_sentinel ( MetaDisplay *  display)

References meta_display_get_current_time(), _MetaDisplay::screens, _MetaDisplay::sentinel_counter, and _MetaDisplay::xdisplay.

Referenced by idle_calc_showing(), and meta_window_show().

Here is the call graph for this function:

◆ meta_display_list_windows()

◆ meta_display_lookup_x_window()

◆ meta_display_open()

gboolean meta_display_open ( void  )

Opens a new display, sets it up, initialises all the X extensions we will need, and adds it to the list of displays.

Returns
True if the display was opened successfully, and False otherwise– that is, if the display doesn't exist or it already has a window manager.

References _, _MetaDisplay::active_screen, _MetaDisplay::allow_terminal_deactivation, _MetaDisplay::autoraise_timeout_id, _MetaDisplay::autoraise_window, _MetaDisplay::closing, _MetaDisplay::compositor, _MetaDisplay::current_time, _MetaDisplay::display_opening, enable_compositor(), _MetaDisplay::error_trap_handler, _MetaDisplay::error_trap_synced_at_last_pop, _MetaDisplay::error_traps, event_callback(), _MetaDisplay::events, _MetaDisplay::expected_focus_window, FALSE, _MetaDisplay::focus_window, _MetaDisplay::grab_edge_resistance_data, _MetaDisplay::grab_have_keyboard, _MetaDisplay::grab_old_window_stacking, _MetaDisplay::grab_op, _MetaDisplay::grab_resize_popup, _MetaDisplay::grab_resize_timeout_id, _MetaDisplay::grab_screen, _MetaDisplay::grab_tile_mode, _MetaDisplay::grab_tile_monitor_number, _MetaDisplay::grab_window, _MetaDisplay::grab_wireframe_active, _MetaDisplay::group_prop_hooks, _MetaDisplay::groups_by_leader, _MetaDisplay::have_xres, _MetaDisplay::ignored_serials, _MetaDisplay::last_focus_time, _MetaDisplay::last_user_time, _MetaDisplay::leader_window, meta_bell_init(), meta_create_offscreen_window(), meta_display_close(), meta_display_focus_the_no_focus_window(), meta_display_grab(), meta_display_init_group_prop_hooks(), meta_display_init_keys(), meta_display_init_window_prop_hooks(), meta_display_lookup_x_window(), meta_display_set_input_focus_window(), meta_display_ungrab(), meta_error_trap_pop(), meta_error_trap_push(), META_GRAB_OP_NONE, meta_is_syncing(), meta_prefs_add_listener(), meta_prefs_get_compositing_manager(), meta_prefs_get_cursor_size(), meta_prefs_get_cursor_theme(), meta_prop_set_utf8_string_hint(), meta_screen_manage_all_windows(), meta_screen_new(), META_TILE_NONE, meta_ui_add_event_func(), meta_ui_get_display(), meta_unsigned_long_equal(), meta_unsigned_long_hash(), meta_warning(), _MetaDisplay::mouse_mode, N_IGNORED_SERIALS, _MetaDisplay::name, NULL, _MetaDisplay::pending_pings, prefs_changed_callback(), _MetaDisplay::prop_hooks, screen, _MetaDisplay::screens, _MetaDisplay::sentinel_counter, _MetaDisplay::server_grab_count, _MetaDisplay::static_gravity_works, _MetaDisplay::tab_popup_mouse_pressed, the_display, _MetaDisplay::timestamp_pinging_window, TRUE, _MetaDisplay::ungrab_should_not_cause_focus_window, update_window_grab_modifiers(), _MetaDisplay::window_ids, _MetaDisplay::window_menu, _MetaDisplay::window_with_menu, _MetaDisplay::xdisplay, and _MetaDisplay::xinerama_cache_invalidated.

Referenced by main().

Here is the call graph for this function:

◆ meta_display_queue_autoraise_callback()

void meta_display_queue_autoraise_callback ( MetaDisplay *  display,
MetaWindow *  window 
)

◆ meta_display_queue_retheme_all_windows()

void meta_display_queue_retheme_all_windows ( MetaDisplay *  display)

References _MetaWindow::frame, meta_display_list_windows(), meta_frame_queue_draw(), META_QUEUE_MOVE_RESIZE, meta_window_queue(), _MetaFrame::need_reapply_frame_shape, NULL, TRUE, and windows.

Referenced by meta_display_retheme_all().

Here is the call graph for this function:

◆ meta_display_register_x_window()

void meta_display_register_x_window ( MetaDisplay *  display,
Window *  xwindowp,
MetaWindow *  window 
)

◆ meta_display_remove_autoraise_callback()

◆ meta_display_retheme_all()

void meta_display_retheme_all ( void  )

References meta_display_queue_retheme_all_windows(), and meta_get_display().

Referenced by event_callback(), and prefs_changed_callback().

Here is the call graph for this function:

◆ meta_display_screen_for_root()

MetaScreen * meta_display_screen_for_root ( MetaDisplay *  display,
Window  xroot 
)

◆ meta_display_screen_for_x_screen()

MetaScreen * meta_display_screen_for_x_screen ( MetaDisplay *  display,
Screen *  xscreen 
)

◆ meta_display_screen_for_xwindow()

MetaScreen * meta_display_screen_for_xwindow ( MetaDisplay *  display,
Window  xwindow 
)

References meta_display_screen_for_x_screen(), meta_error_trap_pop(), meta_error_trap_push(), NULL, TRUE, and _MetaDisplay::xdisplay.

Referenced by meta_core_begin_grab_op(), meta_core_lower_beneath_focus_window(), meta_display_process_key_event(), and process_request_frame_extents().

Here is the call graph for this function:

◆ meta_display_set_cursor_theme()

void meta_display_set_cursor_theme ( const char *  theme,
int  size 
)

References meta_get_display(), meta_screen_update_cursor(), NULL, screen, _MetaDisplay::screens, and _MetaDisplay::xdisplay.

Referenced by on_monitors_changed(), and prefs_changed_callback().

Here is the call graph for this function:

◆ meta_display_set_grab_op_cursor()

void meta_display_set_grab_op_cursor ( MetaDisplay *  display,
MetaScreen *  screen,
MetaGrabOp  op,
gboolean  change_pointer,
Window  grab_xwindow,
guint32  timestamp 
)

References FALSE, _MetaDisplay::grab_have_pointer, GRAB_MASK, META_DEBUG_WINDOW_OPS, meta_error_trap_pop(), meta_error_trap_pop_with_return(), meta_error_trap_push(), NULL, screen, TRUE, xcursor_for_op(), and _MetaDisplay::xdisplay.

Referenced by meta_display_begin_grab_op(), and meta_window_update_keyboard_resize().

Here is the call graph for this function:

◆ meta_display_set_input_focus_window()

void meta_display_set_input_focus_window ( MetaDisplay *  display,
MetaWindow *  window,
gboolean  focus_frame,
guint32  timestamp 
)

◆ meta_display_stack_cmp()

int meta_display_stack_cmp ( const void *  a,
const void *  b 
)

References meta_stack_windows_cmp(), _MetaScreen::number, _MetaWindow::screen, and _MetaScreen::stack.

Referenced by meta_display_unmanage_windows_for_screen().

Here is the call graph for this function:

◆ meta_display_ungrab()

void meta_display_ungrab ( MetaDisplay *  display)

References meta_bug(), _MetaDisplay::server_grab_count, and _MetaDisplay::xdisplay.

Referenced by effects_draw_box_animation_timeout(), idle_calc_showing(), meta_display_open(), meta_effects_end_wireframe(), meta_screen_free(), meta_screen_manage_all_windows(), meta_window_ensure_frame(), meta_window_new(), and meta_window_new_with_attrs().

Here is the call graph for this function:

◆ meta_display_ungrab_focus_window_button()

void meta_display_ungrab_focus_window_button ( MetaDisplay *  display,
MetaWindow *  window 
)

References _MetaWindow::desc, FALSE, _MetaWindow::have_focus_click_grab, MAX_FOCUS_BUTTON, meta_change_button_grab(), and _MetaWindow::xwindow.

Referenced by meta_window_free(), meta_window_notify_focus(), and prefs_changed_callback().

Here is the call graph for this function:

◆ meta_display_ungrab_window_buttons()

void meta_display_ungrab_window_buttons ( MetaDisplay *  display,
Window  xwindow 
)

References FALSE, meta_change_button_grab(), NULL, and _MetaDisplay::window_grab_modifiers.

Referenced by meta_window_free(), and prefs_changed_callback().

Here is the call graph for this function:

◆ meta_display_unmanage_screen()

void meta_display_unmanage_screen ( MetaDisplay *  display,
MetaScreen *  screen,
guint32  timestamp 
)

References meta_display_close(), meta_screen_free(), _MetaDisplay::name, NULL, screen, and _MetaDisplay::screens.

Referenced by process_selection_clear().

Here is the call graph for this function:

◆ meta_display_unmanage_windows_for_screen()

void meta_display_unmanage_windows_for_screen ( MetaDisplay *  display,
MetaScreen *  screen,
guint32  timestamp 
)

References meta_display_list_windows(), meta_display_stack_cmp(), meta_window_free(), and NULL.

Referenced by meta_screen_free().

Here is the call graph for this function:

◆ meta_display_unregister_x_window()

void meta_display_unregister_x_window ( MetaDisplay *  display,
Window  xwindow 
)

References NULL, remove_pending_pings_for_window(), and _MetaDisplay::window_ids.

Referenced by meta_window_destroy_frame(), meta_window_free(), and reload_net_wm_user_time_window().

Here is the call graph for this function:

◆ meta_display_update_active_window_hint()

void meta_display_update_active_window_hint ( MetaDisplay *  display)

References FALSE, _MetaDisplay::focus_window, meta_error_trap_pop(), meta_error_trap_push(), NULL, screen, _MetaDisplay::screens, _MetaDisplay::xdisplay, and _MetaWindow::xwindow.

Referenced by meta_window_notify_focus().

Here is the call graph for this function:

◆ meta_display_xwindow_is_a_no_focus_window()

gboolean meta_display_xwindow_is_a_no_focus_window ( MetaDisplay *  display,
Window  xwindow 
)

◆ meta_get_display()

MetaDisplay * meta_get_display ( void  )

Accessor for the singleton MetaDisplay.

Returns
The only MetaDisplay there is. This can be NULL, but only during startup.

References the_display.

Referenced by meta_display_retheme_all(), meta_display_set_cursor_theme(), meta_finalize(), meta_invalidate_all_icons(), meta_invalidate_default_icons(), and meta_set_syncing().

◆ meta_grab_op_is_moving()

◆ meta_grab_op_is_resizing()

◆ meta_is_syncing()

gboolean meta_is_syncing ( void  )

Returns whether X synchronisation is currently enabled.

Returns
true if we must wait for events whenever we send X requests; false otherwise.
Bug:
This is only called by meta_display_open, but by that time we have already turned syncing on or off on startup, and we don't have any way to do so while Marco is running, so it's rather pointless.

References is_syncing.

Referenced by meta_display_open().

◆ meta_resize_gravity_from_grab_op()

◆ meta_set_syncing()

void meta_set_syncing ( gboolean  setting)

A handy way to turn on synchronisation on or off for every display.

Bug:
Of course there is only one display ever anyway, so this can be rather hugely simplified.

References is_syncing, and meta_get_display().

Referenced by main().

Here is the call graph for this function:

◆ mouse_event_is_in_tab_popup()

static gboolean mouse_event_is_in_tab_popup ( MetaDisplay *  display,
MetaScreen *  screen,
Window  event_window,
int  event_x,
int  event_y,
int *  popup_x,
int *  popup_y 
)
static

References FALSE, meta_ui_tab_popup_get_widget(), NULL, screen, TRUE, and _MetaDisplay::xdisplay.

Referenced by event_callback().

Here is the call graph for this function:

◆ mru_cmp()

static int mru_cmp ( gconstpointer  a,
gconstpointer  b 
)
static

References meta_window_get_user_time().

Referenced by meta_display_get_tab_list().

Here is the call graph for this function:

◆ prefs_changed_callback()

◆ process_request_frame_extents()

static void process_request_frame_extents ( MetaDisplay *  display,
XEvent *  event 
)
static

◆ process_selection_clear()

static void process_selection_clear ( MetaDisplay *  display,
XEvent *  event 
)
static

References find_screen_for_selection(), meta_display_unmanage_screen(), meta_error_trap_pop(), meta_error_trap_push(), meta_XFree, _MetaDisplay::name, NULL, screen, TRUE, and _MetaDisplay::xdisplay.

Referenced by event_callback().

Here is the call graph for this function:

◆ process_selection_request()

static void process_selection_request ( MetaDisplay *  display,
XEvent *  event 
)
static

References convert_property(), FALSE, find_screen_for_selection(), meta_error_trap_pop(), meta_error_trap_pop_with_return(), meta_error_trap_push(), meta_XFree, NULL, screen, TRUE, and _MetaDisplay::xdisplay.

Referenced by event_callback().

Here is the call graph for this function:

◆ ptrcmp()

static gint ptrcmp ( gconstpointer  a,
gconstpointer  b 
)
static

◆ reset_ignores()

static void reset_ignores ( MetaDisplay *  display)
static

◆ sanity_check_timestamps()

static void sanity_check_timestamps ( MetaDisplay *  display,
guint32  known_good_timestamp 
)
static

References _MetaWindow::desc, _MetaDisplay::last_focus_time, _MetaDisplay::last_user_time, meta_display_list_windows(), meta_warning(), _MetaWindow::net_wm_user_time, NULL, windows, and XSERVER_TIME_IS_BEFORE.

Referenced by event_callback(), and meta_display_get_current_time_roundtrip().

Here is the call graph for this function:

◆ serial_is_ignored()

static gboolean serial_is_ignored ( MetaDisplay *  display,
unsigned long  serial 
)
static

◆ timestamp_too_old()

static gboolean timestamp_too_old ( MetaDisplay *  display,
MetaWindow *  window,
guint32 *  timestamp 
)
static

References _MetaWindow::desc, FALSE, _MetaDisplay::last_focus_time, _MetaDisplay::last_user_time, META_DEBUG_FOCUS, meta_display_get_current_time_roundtrip(), meta_print_backtrace(), meta_warning(), TRUE, and XSERVER_TIME_IS_BEFORE.

Referenced by meta_display_focus_the_no_focus_window(), and meta_display_set_input_focus_window().

Here is the call graph for this function:

◆ update_window_grab_modifiers()

static void update_window_grab_modifiers ( MetaDisplay *  display)
static

References meta_display_devirtualize_modifiers(), meta_prefs_get_mouse_button_mods(), and _MetaDisplay::window_grab_modifiers.

Referenced by meta_display_open(), and prefs_changed_callback().

Here is the call graph for this function:

◆ window_raise_with_delay_callback()

static gboolean window_raise_with_delay_callback ( void *  data)
static

◆ xcursor_for_op()

Variable Documentation

◆ is_syncing

gboolean is_syncing = FALSE
static

Stores whether syncing is currently enabled.

Referenced by meta_is_syncing(), and meta_set_syncing().

◆ the_display

MetaDisplay* the_display = NULL
static

The display we're managing.

This is a singleton object. (Historically, this was a list of displays, but there was never any way to add more than one element to it.) The goofy name is because we don't want it to shadow the parameter in its object methods.

Referenced by meta_display_close(), meta_display_for_x_display(), meta_display_open(), and meta_get_display().