|
marco 1.29.1
Window manager
|
Ring the bell or flash the screen. More...
Macros | |
| #define | __BELL_H__ |
Functions | |
| void | meta_bell_set_audible (MetaDisplay *display, gboolean audible) |
| Turns the bell to audible or visual. | |
| gboolean | meta_bell_init (MetaDisplay *display) |
| Initialises the bell subsystem. | |
| void | meta_bell_shutdown (MetaDisplay *display) |
| Shuts down the bell subsystem. | |
| void | meta_bell_notify_frame_destroy (MetaFrame *frame) |
| Deals with a frame being destroyed. | |
Ring the bell or flash the screen.
Sometimes, X programs "ring the bell", whatever that means. Marco lets 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.
The visual bell was the result of a discussion in Bugzilla here: http://bugzilla.gnome.org/show_bug.cgi?id=99886.
| #define __BELL_H__ |
| gboolean meta_bell_init | ( | MetaDisplay * | display | ) |
Initialises the bell subsystem.
This involves intialising XKB (which, despite being a keyboard extension, is the place to look for bell notifications), then asking it to send us bell notifications, and then also switching off the audible bell if we're using a visual one ourselves.
Unlike most X extensions we use, we only initialise XKB here (rather than in main()). It's possible that XKB is not installed at all, but if that was known at build time we will have HAVE_XKB undefined, which will cause this function to be a no-op.
| display | The display which is opening |
References FALSE, NULL, TRUE, and _MetaDisplay::xdisplay.
Referenced by meta_display_open().
| void meta_bell_notify_frame_destroy | ( | MetaFrame * | frame | ) |
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.
| frame | The frame which is being destroyed |
References _MetaFrame::is_flashing.
Referenced by meta_window_destroy_frame().
| void meta_bell_set_audible | ( | MetaDisplay * | display, |
| gboolean | audible | ||
| ) |
Turns the bell to audible or visual.
This tells X what to do, but not Marco; you will need to set the "visual bell" pref for that.
If the configure script found we had no XKB, this is a no-op.
| display | The display we're configuring |
| audible | True for an audible bell, false for a visual bell |
Turns the bell to audible or visual.
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.
| display | The display the event came in on |
| xkb_ev | The bell event |
Referenced by prefs_changed_callback().
| void meta_bell_shutdown | ( | MetaDisplay * | display | ) |
Shuts down the bell subsystem.
| display | The display which is closing |
References _MetaDisplay::xdisplay.