2006-10-01 22:30:10 +00:00
|
|
|
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
|
|
|
Comprehensively rename to Mutter
Code:
All references in the code not related to themes, keybindings, or
GConf were changed from 'metacity' to 'mutter'. This includes, among other
things, strings, comments, the atoms used in the message protocol, and
the envvars used for debugging. The GConf schema file was reduced to
the 3 settings new to mutter.
The overall version was brought up to 2.27 to match current gnome.
Structure:
All files named '*metacity*' were renamed '*mutter*' with appropriate
changes in the automake system. Files removed are
doc/creating_themes, src/themes, doc/metacity-theme.dtd,
metacity.doap. These files will eventually end up in an external
gnome-wm-data module.
Installation location:
On the filesystem the mutter-plugindir was change from
$(libdir)/metacity/plugins/clutter to just $(libdir)/mutter/plugins.
The mutter-plugins.pc.in reflects these changes.
Note:
mutter.desktop.in and mutter-wm.desktop both continue to have
X-GNOME-WMSettingsModule=metacity set. This allows
gnome-control-center to continue using libmetacity.so for
configuration. This is fine since most the general keybindings and wm
settings are being read from /apps/metacity/* in gconf.
2009-06-10 10:29:20 +00:00
|
|
|
/* Mutter visual bell */
|
2002-12-17 01:08:29 +00:00
|
|
|
|
2014-05-02 13:34:02 +00:00
|
|
|
/*
|
2002-12-17 01:08:29 +00:00
|
|
|
* Copyright (C) 2002 Sun Microsystems Inc.
|
2006-01-10 19:43:21 +00:00
|
|
|
* Copyright (C) 2005, 2006 Elijah Newren
|
2014-05-02 13:34:02 +00:00
|
|
|
*
|
2002-12-17 01:08:29 +00:00
|
|
|
* 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.
|
2014-05-02 13:34:02 +00:00
|
|
|
*
|
2002-12-17 01:08:29 +00:00
|
|
|
* You should have received a copy of the GNU General Public License
|
2014-01-12 01:42:06 +00:00
|
|
|
* along with this program; if not, see <http://www.gnu.org/licenses/>.
|
2002-12-17 01:08:29 +00:00
|
|
|
*/
|
|
|
|
|
2013-02-15 18:42:08 +00:00
|
|
|
/*
|
|
|
|
* SECTION:bell
|
2011-11-02 15:34:45 +00:00
|
|
|
* @short_description: Ring the bell or flash the screen
|
2008-01-13 16:32:56 +00:00
|
|
|
*
|
Comprehensively rename to Mutter
Code:
All references in the code not related to themes, keybindings, or
GConf were changed from 'metacity' to 'mutter'. This includes, among other
things, strings, comments, the atoms used in the message protocol, and
the envvars used for debugging. The GConf schema file was reduced to
the 3 settings new to mutter.
The overall version was brought up to 2.27 to match current gnome.
Structure:
All files named '*metacity*' were renamed '*mutter*' with appropriate
changes in the automake system. Files removed are
doc/creating_themes, src/themes, doc/metacity-theme.dtd,
metacity.doap. These files will eventually end up in an external
gnome-wm-data module.
Installation location:
On the filesystem the mutter-plugindir was change from
$(libdir)/metacity/plugins/clutter to just $(libdir)/mutter/plugins.
The mutter-plugins.pc.in reflects these changes.
Note:
mutter.desktop.in and mutter-wm.desktop both continue to have
X-GNOME-WMSettingsModule=metacity set. This allows
gnome-control-center to continue using libmetacity.so for
configuration. This is fine since most the general keybindings and wm
settings are being read from /apps/metacity/* in gconf.
2009-06-10 10:29:20 +00:00
|
|
|
* Sometimes, X programs "ring the bell", whatever that means. Mutter lets
|
2008-01-13 16:32:56 +00:00
|
|
|
* the user configure the bell to be audible or visible (aka visual), and
|
|
|
|
* if it's visual it can be configured to be frame-flash or fullscreen-flash.
|
|
|
|
* We never get told about audible bells; X handles them just fine by itself.
|
|
|
|
*
|
|
|
|
* Visual bells come in at meta_bell_notify(), which checks we are actually
|
2008-06-29 18:46:01 +00:00
|
|
|
* in visual mode and calls through to bell_visual_notify(). That
|
2008-01-13 16:32:56 +00:00
|
|
|
* function then checks what kind of visual flash you like, and calls either
|
2008-06-29 18:46:01 +00:00
|
|
|
* bell_flash_fullscreen()-- which calls bell_flash_screen() to do
|
|
|
|
* its work-- or bell_flash_frame(), which flashes the focussed window
|
|
|
|
* using bell_flash_window_frame(), unless there is no such window, in
|
|
|
|
* which case it flashes the screen instead. bell_flash_window_frame()
|
|
|
|
* flashes the frame and calls bell_unflash_frame() as a timeout to
|
2008-01-13 16:32:56 +00:00
|
|
|
* remove the flash.
|
|
|
|
*
|
|
|
|
* The visual bell was the result of a discussion in Bugzilla here:
|
|
|
|
* <http://bugzilla.gnome.org/show_bug.cgi?id=99886>.
|
|
|
|
*
|
|
|
|
* Several of the functions in this file are ifdeffed out entirely if we are
|
|
|
|
* found not to have the XKB extension, which is required to do these clever
|
|
|
|
* things with bells; some others are entirely no-ops in that case.
|
|
|
|
*/
|
|
|
|
|
2002-12-17 01:08:29 +00:00
|
|
|
#include <config.h>
|
|
|
|
#include "bell.h"
|
2008-05-19 00:00:09 +00:00
|
|
|
#include "screen-private.h"
|
2013-02-15 18:42:08 +00:00
|
|
|
#include "window-private.h"
|
2013-09-11 08:18:53 +00:00
|
|
|
#include "util-private.h"
|
2016-03-08 04:10:21 +00:00
|
|
|
#include "compositor/compositor-private.h"
|
2011-03-06 00:29:12 +00:00
|
|
|
#include <meta/prefs.h>
|
2013-02-15 18:42:08 +00:00
|
|
|
#include <meta/compositor.h>
|
2010-02-11 15:28:20 +00:00
|
|
|
#ifdef HAVE_LIBCANBERRA
|
2009-02-12 00:53:23 +00:00
|
|
|
#include <canberra-gtk.h>
|
2010-02-11 15:28:20 +00:00
|
|
|
#endif
|
2002-12-17 01:08:29 +00:00
|
|
|
|
2008-01-13 16:32:56 +00:00
|
|
|
/**
|
2011-11-02 15:34:45 +00:00
|
|
|
* bell_flash_fullscreen:
|
|
|
|
* @display: The display the event came in on
|
|
|
|
* @xkb_ev: The bell event
|
|
|
|
*
|
2008-01-13 16:32:56 +00:00
|
|
|
* Flashes one screen, or all screens, in response to a bell event.
|
|
|
|
* If the event is on a particular window, flash the screen that
|
|
|
|
* window is on. Otherwise, flash every screen on this display.
|
|
|
|
*
|
|
|
|
* If the configure script found we had no XKB, this does not exist.
|
|
|
|
*/
|
2002-12-17 01:08:29 +00:00
|
|
|
static void
|
2014-08-18 23:47:26 +00:00
|
|
|
bell_flash_fullscreen (MetaDisplay *display)
|
2002-12-17 01:08:29 +00:00
|
|
|
{
|
2013-10-03 22:31:09 +00:00
|
|
|
meta_compositor_flash_screen (display->compositor, display->screen);
|
2002-12-17 01:08:29 +00:00
|
|
|
}
|
|
|
|
|
2008-01-13 16:32:56 +00:00
|
|
|
/**
|
2011-11-02 15:34:45 +00:00
|
|
|
* bell_unflash_frame:
|
|
|
|
* @data: The frame to unflash, cast to a gpointer so it can go into
|
|
|
|
* a callback function.
|
|
|
|
*
|
2008-01-13 16:32:56 +00:00
|
|
|
* Makes a frame be not flashed; this is the timeout half of
|
2008-06-29 18:46:01 +00:00
|
|
|
* bell_flash_window_frame(). This is done simply by clearing the
|
2008-01-17 03:49:24 +00:00
|
|
|
* flash flag and queuing a redraw of the frame.
|
2008-01-13 16:32:56 +00:00
|
|
|
*
|
|
|
|
* If the configure script found we had no XKB, this does not exist.
|
|
|
|
*
|
2011-11-02 15:34:45 +00:00
|
|
|
* Returns: Always FALSE, so we don't get called again.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Bug: This is the parallel to bell_flash_window_frame(), so it should
|
2008-01-13 16:32:56 +00:00
|
|
|
* really be called meta_bell_unflash_window_frame().
|
|
|
|
*/
|
2014-05-02 13:34:02 +00:00
|
|
|
static gboolean
|
2008-06-29 18:46:01 +00:00
|
|
|
bell_unflash_frame (gpointer data)
|
2002-12-17 01:08:29 +00:00
|
|
|
{
|
|
|
|
MetaFrame *frame = (MetaFrame *) data;
|
|
|
|
frame->is_flashing = 0;
|
|
|
|
meta_frame_queue_draw (frame);
|
|
|
|
return FALSE;
|
|
|
|
}
|
|
|
|
|
2008-01-13 16:32:56 +00:00
|
|
|
/**
|
2011-11-02 15:34:45 +00:00
|
|
|
* bell_flash_window_frame:
|
|
|
|
* @window: The window to flash
|
|
|
|
*
|
2008-01-13 16:32:56 +00:00
|
|
|
* Makes a frame flash and then return to normal shortly afterwards.
|
|
|
|
* This is done by setting a flag so that the theme
|
|
|
|
* code will temporarily draw the frame as focussed if it's unfocussed and
|
|
|
|
* vice versa, and then queueing a redraw. Lastly, we create a timeout so
|
|
|
|
* that the flag can be unset and the frame re-redrawn.
|
|
|
|
*
|
|
|
|
* If the configure script found we had no XKB, this does not exist.
|
|
|
|
*/
|
2002-12-17 01:08:29 +00:00
|
|
|
static void
|
2008-06-29 18:46:01 +00:00
|
|
|
bell_flash_window_frame (MetaWindow *window)
|
2002-12-17 01:08:29 +00:00
|
|
|
{
|
2014-04-10 16:58:58 +00:00
|
|
|
guint id;
|
2002-12-17 01:08:29 +00:00
|
|
|
g_assert (window->frame != NULL);
|
|
|
|
window->frame->is_flashing = 1;
|
|
|
|
meta_frame_queue_draw (window->frame);
|
Comprehensively rename to Mutter
Code:
All references in the code not related to themes, keybindings, or
GConf were changed from 'metacity' to 'mutter'. This includes, among other
things, strings, comments, the atoms used in the message protocol, and
the envvars used for debugging. The GConf schema file was reduced to
the 3 settings new to mutter.
The overall version was brought up to 2.27 to match current gnome.
Structure:
All files named '*metacity*' were renamed '*mutter*' with appropriate
changes in the automake system. Files removed are
doc/creating_themes, src/themes, doc/metacity-theme.dtd,
metacity.doap. These files will eventually end up in an external
gnome-wm-data module.
Installation location:
On the filesystem the mutter-plugindir was change from
$(libdir)/metacity/plugins/clutter to just $(libdir)/mutter/plugins.
The mutter-plugins.pc.in reflects these changes.
Note:
mutter.desktop.in and mutter-wm.desktop both continue to have
X-GNOME-WMSettingsModule=metacity set. This allows
gnome-control-center to continue using libmetacity.so for
configuration. This is fine since most the general keybindings and wm
settings are being read from /apps/metacity/* in gconf.
2009-06-10 10:29:20 +00:00
|
|
|
/* Since this idle is added after the Clutter clock source, with
|
|
|
|
* the same priority, it will be executed after it as well, so
|
|
|
|
* we are guaranteed to get at least one frame drawn in the
|
|
|
|
* flashed state, no matter how loaded we are.
|
|
|
|
*/
|
2014-04-10 16:58:58 +00:00
|
|
|
id = g_timeout_add_full (META_PRIORITY_REDRAW, 100,
|
|
|
|
bell_unflash_frame, window->frame, NULL);
|
|
|
|
g_source_set_name_by_id (id, "[mutter] bell_unflash_frame");
|
2002-12-17 01:08:29 +00:00
|
|
|
}
|
|
|
|
|
2016-03-08 04:10:21 +00:00
|
|
|
static void
|
|
|
|
bell_flash_window (MetaWindow *window)
|
|
|
|
{
|
|
|
|
meta_compositor_flash_window (window->display->compositor, window);
|
|
|
|
}
|
|
|
|
|
2008-01-13 16:32:56 +00:00
|
|
|
/**
|
2011-11-02 15:34:45 +00:00
|
|
|
* bell_flash_frame:
|
|
|
|
* @display: The display the bell event came in on
|
|
|
|
* @xkb_ev: The bell event we just received
|
|
|
|
*
|
2014-08-18 23:47:26 +00:00
|
|
|
* Flashes the frame of the focused window. If there is no focused window,
|
2008-01-13 16:32:56 +00:00
|
|
|
* flashes the screen.
|
|
|
|
*/
|
2002-12-17 01:08:29 +00:00
|
|
|
static void
|
2014-05-02 13:34:02 +00:00
|
|
|
bell_flash_frame (MetaDisplay *display,
|
2014-08-18 23:47:26 +00:00
|
|
|
MetaWindow *window)
|
2002-12-17 01:08:29 +00:00
|
|
|
{
|
2010-01-17 18:41:59 +00:00
|
|
|
if (window && window->frame)
|
2014-08-18 23:47:26 +00:00
|
|
|
bell_flash_window_frame (window);
|
2016-03-19 03:28:42 +00:00
|
|
|
else if (window)
|
2016-03-08 04:10:21 +00:00
|
|
|
bell_flash_window (window);
|
2016-03-19 03:28:42 +00:00
|
|
|
else
|
|
|
|
bell_flash_fullscreen (display);
|
2002-12-17 01:08:29 +00:00
|
|
|
}
|
|
|
|
|
2008-01-13 16:32:56 +00:00
|
|
|
/**
|
2011-11-02 15:34:45 +00:00
|
|
|
* bell_visual_notify:
|
|
|
|
* @display: The display the bell event came in on
|
|
|
|
* @xkb_ev: The bell event we just received
|
|
|
|
*
|
2008-01-13 16:32:56 +00:00
|
|
|
* Gives the user some kind of visual bell substitute, in response to a
|
|
|
|
* bell event. What this is depends on the "visual bell type" pref.
|
|
|
|
*/
|
2002-12-17 01:08:29 +00:00
|
|
|
static void
|
2014-05-02 13:34:02 +00:00
|
|
|
bell_visual_notify (MetaDisplay *display,
|
2014-08-18 23:47:26 +00:00
|
|
|
MetaWindow *window)
|
2002-12-17 01:08:29 +00:00
|
|
|
{
|
2014-05-02 13:34:02 +00:00
|
|
|
switch (meta_prefs_get_visual_bell_type ())
|
2002-12-17 01:08:29 +00:00
|
|
|
{
|
2011-06-24 16:14:15 +00:00
|
|
|
case G_DESKTOP_VISUAL_BELL_FULLSCREEN_FLASH:
|
2014-08-18 23:47:26 +00:00
|
|
|
bell_flash_fullscreen (display);
|
2002-12-17 01:08:29 +00:00
|
|
|
break;
|
2011-06-24 16:14:15 +00:00
|
|
|
case G_DESKTOP_VISUAL_BELL_FRAME_FLASH:
|
2014-08-18 23:47:26 +00:00
|
|
|
bell_flash_frame (display, window);
|
2002-12-17 01:08:29 +00:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-08-18 23:47:26 +00:00
|
|
|
static gboolean
|
|
|
|
bell_audible_notify (MetaDisplay *display,
|
|
|
|
MetaWindow *window)
|
2002-12-17 01:08:29 +00:00
|
|
|
{
|
2010-02-11 15:28:20 +00:00
|
|
|
#ifdef HAVE_LIBCANBERRA
|
2014-08-18 23:47:26 +00:00
|
|
|
ca_proplist *p;
|
|
|
|
int res;
|
|
|
|
|
|
|
|
ca_proplist_create (&p);
|
|
|
|
ca_proplist_sets (p, CA_PROP_EVENT_ID, "bell-window-system");
|
|
|
|
ca_proplist_sets (p, CA_PROP_EVENT_DESCRIPTION, _("Bell event"));
|
|
|
|
ca_proplist_sets (p, CA_PROP_CANBERRA_CACHE_CONTROL, "permanent");
|
|
|
|
|
|
|
|
if (window)
|
2009-02-12 00:53:23 +00:00
|
|
|
{
|
2014-08-18 23:47:26 +00:00
|
|
|
ca_proplist_sets (p, CA_PROP_WINDOW_NAME, window->title);
|
|
|
|
ca_proplist_setf (p, CA_PROP_WINDOW_X11_XID, "%lu", (unsigned long)window->xwindow);
|
|
|
|
ca_proplist_sets (p, CA_PROP_APPLICATION_NAME, window->res_name);
|
|
|
|
ca_proplist_setf (p, CA_PROP_APPLICATION_PROCESS_ID, "%d", window->net_wm_pid);
|
|
|
|
}
|
2009-02-12 00:53:23 +00:00
|
|
|
|
2014-08-18 23:47:26 +00:00
|
|
|
res = ca_context_play_full (ca_gtk_context_get (), 1, p, NULL, NULL);
|
2009-02-12 00:53:23 +00:00
|
|
|
|
2014-08-18 23:47:26 +00:00
|
|
|
ca_proplist_destroy (p);
|
2009-02-12 00:53:23 +00:00
|
|
|
|
2014-08-18 23:47:26 +00:00
|
|
|
return res == CA_SUCCESS || res == CA_ERROR_DISABLED;
|
|
|
|
#endif /* HAVE_LIBCANBERRA */
|
|
|
|
|
|
|
|
return FALSE;
|
|
|
|
}
|
|
|
|
|
2016-03-07 04:46:18 +00:00
|
|
|
gboolean
|
2014-08-18 23:47:26 +00:00
|
|
|
meta_bell_notify (MetaDisplay *display,
|
2016-03-07 04:46:18 +00:00
|
|
|
MetaWindow *window)
|
2014-08-18 23:47:26 +00:00
|
|
|
{
|
|
|
|
/* flash something */
|
|
|
|
if (meta_prefs_get_visual_bell ())
|
|
|
|
bell_visual_notify (display, window);
|
2009-02-12 00:53:23 +00:00
|
|
|
|
2014-08-18 23:47:26 +00:00
|
|
|
if (meta_prefs_bell_is_audible ())
|
2016-03-07 04:46:18 +00:00
|
|
|
return bell_audible_notify (display, window);
|
|
|
|
|
|
|
|
return TRUE;
|
2002-12-17 01:08:29 +00:00
|
|
|
}
|
|
|
|
|
2008-06-30 16:42:19 +00:00
|
|
|
void
|
2002-12-17 01:08:29 +00:00
|
|
|
meta_bell_set_audible (MetaDisplay *display, gboolean audible)
|
|
|
|
{
|
2010-02-11 15:28:20 +00:00
|
|
|
#ifdef HAVE_LIBCANBERRA
|
|
|
|
/* When we are playing sounds using libcanberra support, we handle the
|
|
|
|
* bell whether its an audible bell or a visible bell */
|
|
|
|
gboolean enable_system_bell = FALSE;
|
|
|
|
#else
|
|
|
|
gboolean enable_system_bell = audible;
|
|
|
|
#endif /* HAVE_LIBCANBERRA */
|
|
|
|
|
|
|
|
XkbChangeEnabledControls (display->xdisplay,
|
|
|
|
XkbUseCoreKbd,
|
|
|
|
XkbAudibleBellMask,
|
|
|
|
enable_system_bell ? XkbAudibleBellMask : 0);
|
2002-12-17 01:08:29 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
gboolean
|
|
|
|
meta_bell_init (MetaDisplay *display)
|
|
|
|
{
|
|
|
|
int xkb_base_error_type, xkb_opcode;
|
|
|
|
|
2014-05-02 13:34:02 +00:00
|
|
|
if (!XkbQueryExtension (display->xdisplay, &xkb_opcode,
|
|
|
|
&display->xkb_base_event_type,
|
|
|
|
&xkb_base_error_type,
|
2002-12-17 01:08:29 +00:00
|
|
|
NULL, NULL))
|
|
|
|
{
|
|
|
|
display->xkb_base_event_type = -1;
|
|
|
|
g_message ("could not find XKB extension.");
|
|
|
|
return FALSE;
|
|
|
|
}
|
2014-05-02 13:34:02 +00:00
|
|
|
else
|
2002-12-17 01:08:29 +00:00
|
|
|
{
|
|
|
|
unsigned int mask = XkbBellNotifyMask;
|
2014-05-02 13:34:02 +00:00
|
|
|
gboolean visual_bell_auto_reset = FALSE;
|
2002-12-17 01:08:29 +00:00
|
|
|
/* TRUE if and when non-broken version is available */
|
|
|
|
XkbSelectEvents (display->xdisplay,
|
|
|
|
XkbUseCoreKbd,
|
|
|
|
XkbBellNotifyMask,
|
|
|
|
XkbBellNotifyMask);
|
2010-02-11 15:28:20 +00:00
|
|
|
meta_bell_set_audible (display, meta_prefs_bell_is_audible ());
|
2002-12-17 01:08:29 +00:00
|
|
|
if (visual_bell_auto_reset) {
|
|
|
|
XkbSetAutoResetControls (display->xdisplay,
|
|
|
|
XkbAudibleBellMask,
|
|
|
|
&mask,
|
|
|
|
&mask);
|
|
|
|
}
|
|
|
|
return TRUE;
|
|
|
|
}
|
|
|
|
return FALSE;
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
|
|
|
meta_bell_shutdown (MetaDisplay *display)
|
|
|
|
{
|
|
|
|
/* TODO: persist initial bell state in display, reset here */
|
|
|
|
XkbChangeEnabledControls (display->xdisplay,
|
|
|
|
XkbUseCoreKbd,
|
|
|
|
XkbAudibleBellMask,
|
|
|
|
XkbAudibleBellMask);
|
|
|
|
}
|
|
|
|
|
2008-06-30 16:42:19 +00:00
|
|
|
/**
|
2011-11-02 15:34:45 +00:00
|
|
|
* meta_bell_notify_frame_destroy:
|
|
|
|
* @frame: The frame which is being destroyed
|
|
|
|
*
|
2008-06-30 16:42:19 +00:00
|
|
|
* Deals with a frame being destroyed. This is important because if we're
|
|
|
|
* using a visual bell, we might be flashing the edges of the frame, and
|
|
|
|
* so we'd have a timeout function waiting ready to un-flash them. If the
|
|
|
|
* frame's going away, we can tell the timeout not to bother.
|
|
|
|
*/
|
2002-12-17 01:08:29 +00:00
|
|
|
void
|
|
|
|
meta_bell_notify_frame_destroy (MetaFrame *frame)
|
|
|
|
{
|
2014-05-02 13:34:02 +00:00
|
|
|
if (frame->is_flashing)
|
2006-01-10 04:50:17 +00:00
|
|
|
g_source_remove_by_funcs_user_data (&g_timeout_funcs, frame);
|
2002-12-17 01:08:29 +00:00
|
|
|
}
|