2001-06-17 15:53:45 -04:00
|
|
|
/* Metacity interface used by GTK+ UI to talk to core */
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Copyright (C) 2001 Havoc Pennington
|
Merge of all the changes on the constraints_experiments branch. This is
2005-11-18 Elijah Newren <newren@gmail.com>
Merge of all the changes on the constraints_experiments branch.
This is just a summary, to get the full ChangeLog of those
changes (approx. 2000 lines):
cvs -q -z3 update -Pd -r constraints_experiments
cvs -q -z3 diff -pu -r CONSTRAINTS_EXPERIMENTS_BRANCHPOINT ChangeLog
Bugs fixed:
unfiled - constraints.c is overly complicated[1]
unfiled - constraints.c is not robust when all constraints
cannot simultaneously be met (constraints need to be
prioritized)
unfiled - keep-titlebar-onscreen constraint is decoration
unaware (since get_outermost_onscreen_positions()
forgets to include decorations)
unfiled - keyboard snap-moving and snap-resizing snap to hidden
edges
109553 - gravity w/ simultaneous move & resize doesn't work
113601 - maximize vertical and horizontal should toggle and be
constrained
122196 - windows show up under vertical panels
122670 - jerky/random resizing of window via keyboard[2]
124582 - keyboard and mouse snap-resizing and snap-moving
erroneously moves the window multidimensionally
136307 - don't allow apps to resize themselves off the screen
(*cough* filechooser *cough*)
142016, 143784 - windows should not span multiple xineramas
unless placed there by the user
143145 - clamp new windows to screensize and force them
onscreen, if they'll fit
144126 - Handle pathological strut lists sanely[3]
149867 - fixed aspect ratio windows are difficult to resize[4]
152898 - make screen edges consistent; allow easy slamming of
windows into the left, right, and bottom edges of the
screen too.
154706 - bouncing weirdness at screen edge with keyboard moving
or resizing
156699 - avoid struts when placing windows, if possible (nasty
a11y blocker)
302456 - dragging offscreen too restrictive
304857 - wireframe moving off the top of the screen is misleading
308521 - make uni-directional resizing easier with
alt-middle-drag and prevent the occasional super
annoying resize-the-wrong-side(s) behavior
312007 - snap-resize moves windows with a minimum size
constraint
312104 - resizing the top of a window can cause the bottom to
grow
319351 - don't instantly snap on mouse-move-snapping, remove
braindeadedness of having order of releasing shift and
releasing button press matter so much
[1] fixed in my opinion, anyway.
[2] Actually, it's not totally fixed--it's just annoying
instead of almost completely unusable. Matthias had a
suggestion that may fix the remainder of the problems (see
http://tinyurl.com/bwzuu).
[3] This bug was originally about not-quite-so-pathological
cases but was left open for the worse cases. The code from
the branch handles the remainder of the cases mentioned in
this bug.
[4] Actually, although it's far better there's still some minor
issues left: a slight drift that's only noticeable after
lots of resizing, and potential problems with partially
onscreen constraints due to not clearing any
fixed_directions flags (aspect ratio windows get resized in
both directions and thus aren't fixed in one of them)
New feature:
81704 - edge resistance for user move and resize operations;
in particular 3 different kinds of resistance are
implemented:
Pixel-Distance: window movement is resisted when it
aligns with an edge unless the movement is greater than
a threshold number of pixels
Timeout: window movement past an edge is prevented until
a certain amount of time has elapsed during the
operation since the first request to move it past that
edge
Keyboard-Buildup: when moving or resizing with the
keyboard, once a window is aligned with a certain edge
it cannot move past until the correct direction has
been pressed enough times (e.g. 2 or 3 times)
Major changes:
- constraints.c has been rewritten; very few lines of code from
the old version remain. There is a comment near the top of
the function explaining the basics of how the new framework
works. A more detailed explanation can be found in
doc/how-constraints-works.txt
- edge-resistance.[ch] are new files implementing edge-resistance.
- boxes.[ch] are new files containing low-level error-prone
functions used heavily in constraints.c and edge-resistance.c,
among various places throughout the code. testboxes.c
contains a thorough testsuite for the boxes.[ch] functions
compiled into a program, testboxes.
- meta_window_move_resize_internal() *must* be told the gravity
of the associated operation (if it's just a move operation,
the gravity will be ignored, but for resize and move+resize
the correct value is needed)
- the craziness of different values that
meta_window_move_resize_internal() accepts has been documented
in a large comment at the beginning of the function. It may
be possible to clean this up some, but until then things will
remain as they were before--caller beware.
- screen and xinerama usable areas (i.e. places not covered by
e.g. panels) are cached in the workspace now, as are the
screen and xinerama edges. These get updated with the
workarea in src/workspace.c:ensure_work_areas_validated()
2005-11-19 09:58:50 -05:00
|
|
|
* Copyright (C) 2005 Elijah Newren
|
2001-06-17 15:53:45 -04: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.
|
|
|
|
|
*
|
|
|
|
|
* 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_CORE_H
|
|
|
|
|
#define META_CORE_H
|
|
|
|
|
|
|
|
|
|
/* Don't include core headers here */
|
|
|
|
|
#include <gdk/gdkx.h>
|
2001-06-17 23:24:25 -04:00
|
|
|
#include "common.h"
|
2001-06-17 15:53:45 -04:00
|
|
|
|
2002-01-18 22:50:03 -05:00
|
|
|
void meta_core_get_client_size (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
int *width,
|
|
|
|
|
int *height);
|
2001-06-17 23:24:25 -04:00
|
|
|
|
Merge of all the changes on the constraints_experiments branch. This is
2005-11-18 Elijah Newren <newren@gmail.com>
Merge of all the changes on the constraints_experiments branch.
This is just a summary, to get the full ChangeLog of those
changes (approx. 2000 lines):
cvs -q -z3 update -Pd -r constraints_experiments
cvs -q -z3 diff -pu -r CONSTRAINTS_EXPERIMENTS_BRANCHPOINT ChangeLog
Bugs fixed:
unfiled - constraints.c is overly complicated[1]
unfiled - constraints.c is not robust when all constraints
cannot simultaneously be met (constraints need to be
prioritized)
unfiled - keep-titlebar-onscreen constraint is decoration
unaware (since get_outermost_onscreen_positions()
forgets to include decorations)
unfiled - keyboard snap-moving and snap-resizing snap to hidden
edges
109553 - gravity w/ simultaneous move & resize doesn't work
113601 - maximize vertical and horizontal should toggle and be
constrained
122196 - windows show up under vertical panels
122670 - jerky/random resizing of window via keyboard[2]
124582 - keyboard and mouse snap-resizing and snap-moving
erroneously moves the window multidimensionally
136307 - don't allow apps to resize themselves off the screen
(*cough* filechooser *cough*)
142016, 143784 - windows should not span multiple xineramas
unless placed there by the user
143145 - clamp new windows to screensize and force them
onscreen, if they'll fit
144126 - Handle pathological strut lists sanely[3]
149867 - fixed aspect ratio windows are difficult to resize[4]
152898 - make screen edges consistent; allow easy slamming of
windows into the left, right, and bottom edges of the
screen too.
154706 - bouncing weirdness at screen edge with keyboard moving
or resizing
156699 - avoid struts when placing windows, if possible (nasty
a11y blocker)
302456 - dragging offscreen too restrictive
304857 - wireframe moving off the top of the screen is misleading
308521 - make uni-directional resizing easier with
alt-middle-drag and prevent the occasional super
annoying resize-the-wrong-side(s) behavior
312007 - snap-resize moves windows with a minimum size
constraint
312104 - resizing the top of a window can cause the bottom to
grow
319351 - don't instantly snap on mouse-move-snapping, remove
braindeadedness of having order of releasing shift and
releasing button press matter so much
[1] fixed in my opinion, anyway.
[2] Actually, it's not totally fixed--it's just annoying
instead of almost completely unusable. Matthias had a
suggestion that may fix the remainder of the problems (see
http://tinyurl.com/bwzuu).
[3] This bug was originally about not-quite-so-pathological
cases but was left open for the worse cases. The code from
the branch handles the remainder of the cases mentioned in
this bug.
[4] Actually, although it's far better there's still some minor
issues left: a slight drift that's only noticeable after
lots of resizing, and potential problems with partially
onscreen constraints due to not clearing any
fixed_directions flags (aspect ratio windows get resized in
both directions and thus aren't fixed in one of them)
New feature:
81704 - edge resistance for user move and resize operations;
in particular 3 different kinds of resistance are
implemented:
Pixel-Distance: window movement is resisted when it
aligns with an edge unless the movement is greater than
a threshold number of pixels
Timeout: window movement past an edge is prevented until
a certain amount of time has elapsed during the
operation since the first request to move it past that
edge
Keyboard-Buildup: when moving or resizing with the
keyboard, once a window is aligned with a certain edge
it cannot move past until the correct direction has
been pressed enough times (e.g. 2 or 3 times)
Major changes:
- constraints.c has been rewritten; very few lines of code from
the old version remain. There is a comment near the top of
the function explaining the basics of how the new framework
works. A more detailed explanation can be found in
doc/how-constraints-works.txt
- edge-resistance.[ch] are new files implementing edge-resistance.
- boxes.[ch] are new files containing low-level error-prone
functions used heavily in constraints.c and edge-resistance.c,
among various places throughout the code. testboxes.c
contains a thorough testsuite for the boxes.[ch] functions
compiled into a program, testboxes.
- meta_window_move_resize_internal() *must* be told the gravity
of the associated operation (if it's just a move operation,
the gravity will be ignored, but for resize and move+resize
the correct value is needed)
- the craziness of different values that
meta_window_move_resize_internal() accepts has been documented
in a large comment at the beginning of the function. It may
be possible to clean this up some, but until then things will
remain as they were before--caller beware.
- screen and xinerama usable areas (i.e. places not covered by
e.g. panels) are cached in the workspace now, as are the
screen and xinerama edges. These get updated with the
workarea in src/workspace.c:ensure_work_areas_validated()
2005-11-19 09:58:50 -05:00
|
|
|
gboolean meta_core_titlebar_is_onscreen (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
|
2003-01-05 02:51:02 -05:00
|
|
|
Window meta_core_get_client_xwindow (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
|
2001-06-18 02:11:53 -04:00
|
|
|
MetaFrameFlags meta_core_get_frame_flags (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2002-02-06 22:07:56 -05:00
|
|
|
MetaFrameType meta_core_get_frame_type (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2001-06-18 02:11:53 -04:00
|
|
|
|
2001-09-15 20:30:45 -04:00
|
|
|
GdkPixbuf* meta_core_get_mini_icon (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2002-02-06 22:07:56 -05:00
|
|
|
GdkPixbuf* meta_core_get_icon (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2001-09-15 20:30:45 -04:00
|
|
|
|
2001-06-18 02:11:53 -04:00
|
|
|
void meta_core_queue_frame_resize (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2001-06-17 15:53:45 -04:00
|
|
|
|
2001-06-20 00:29:28 -04:00
|
|
|
/* Move as a result of user operation */
|
|
|
|
|
void meta_core_user_move (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
int x,
|
|
|
|
|
int y);
|
2001-06-20 23:40:14 -04:00
|
|
|
void meta_core_user_resize (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
2001-06-30 19:17:52 -04:00
|
|
|
int gravity,
|
2001-06-20 23:40:14 -04:00
|
|
|
int width,
|
|
|
|
|
int height);
|
|
|
|
|
|
|
|
|
|
void meta_core_user_raise (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2004-09-15 20:06:38 -04:00
|
|
|
void meta_core_user_lower_and_unfocus (Display *xdisplay,
|
Fix a variety of focus race conditions in all focus modes, or at least
2004-10-04 Elijah Newren <newren@math.utah.edu>
Fix a variety of focus race conditions in all focus modes, or at
least make them harder to trigger (fixes #152000)
* src/core.[ch] (meta_core_user_lower_and_unfocus): add a
timestamp parameter; pass it along to
meta_workspace_focus_default_window
* src/display.[ch] (meta_display_get_current_time_roundtrip): new
function
* src/display.c (event_callback): pass a timestamp to the
meta_workspace_activate and meta_workspace_focus_default_window
function calls
* src/frames.c (meta_frames_button_press_event): pass a timestamp
to meta_core_user_lower_and_unfocus
* src/keybindings.c (handle_activate_workspace): pass a timestamp
to meta_workspace_activate, (process_workspace_switch_grab): pass
a timestamp to meta_workspace_focus_default_window and
meta_workspace_activate, (handle_toggle_desktop): pass a timestamp
to meta_workspace_focus_default_window,
(do_handle_move_to_workspace): pass a timestamp to
meta_workspace_activate_with_focus, (handle_workspace_switch):
meta_workspace_activate
* src/screen.c (meta_screen_new): pass a timestamp to
meta_workspace_activate
* src/window.c (meta_window_free): pass a timestamp to
meta_workspace_focus_default_window, (idle_calc_showing): don't
increment the focus sentinel here, (meta_window_minimize): pass a
timestamp to meta_workspace_focus_default_window,
(meta_window_client_message), pass a timestamp to
meta_workspace_focus_default_window
* src/workspace.h (meta_workspace_activate): add timestamp
parameter, (meta_workspace_activate_with_focus): add timestamp
parameter, (meta_workspace_focus_default_window): add timestamp
parameter
* src/workspace.c (meta_workspace_focus_mru_window): make this
function take a timestamp and use it for meta_window_focus or
XSetInputFocus, (meta_workspace_activate_with_focus): make this
function take a timestamp and pass it along to meta_window_focus
and meta_workspace_focus_default_window,
(meta_workspace_activate): make this function take a timestamp and
pass it to meta_workspace_activate_with_focus),
(meta_workspace_focus_default_window): make this function take a
timestamp, warn if its 0 but try to handle that case sanely, and
pass the timestamp on to meta_window_focus or
meta_workspace_focus_mru_window or XSetInputFocus
2004-10-04 16:32:59 -04:00
|
|
|
Window frame_xwindow,
|
|
|
|
|
Time timestamp);
|
2001-06-20 23:40:14 -04:00
|
|
|
|
2001-07-11 02:22:00 -04:00
|
|
|
void meta_core_user_focus (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
Time timestamp);
|
|
|
|
|
|
2001-06-20 00:29:28 -04:00
|
|
|
/* get position of client, same coord space expected by move */
|
|
|
|
|
void meta_core_get_position (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
int *x,
|
|
|
|
|
int *y);
|
|
|
|
|
|
2001-06-20 23:40:14 -04:00
|
|
|
void meta_core_get_size (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
int *width,
|
|
|
|
|
int *height);
|
|
|
|
|
|
|
|
|
|
void meta_core_minimize (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2002-10-18 17:22:27 -04:00
|
|
|
void meta_core_toggle_maximize (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2001-06-20 23:40:14 -04:00
|
|
|
void meta_core_unmaximize (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
void meta_core_maximize (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
void meta_core_delete (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
guint32 timestamp);
|
|
|
|
|
void meta_core_unshade (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
void meta_core_shade (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
void meta_core_unstick (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
void meta_core_stick (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
void meta_core_change_workspace (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
int new_workspace);
|
|
|
|
|
|
2001-06-21 02:08:35 -04:00
|
|
|
int meta_core_get_num_workspaces (Screen *xscreen);
|
|
|
|
|
int meta_core_get_active_workspace (Screen *xscreen);
|
2001-06-20 23:40:14 -04:00
|
|
|
int meta_core_get_frame_workspace (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
2002-11-03 14:06:39 -05:00
|
|
|
const char* meta_core_get_workspace_name_with_index (Display *xdisplay,
|
|
|
|
|
Window xroot,
|
|
|
|
|
int index);
|
2001-06-20 23:40:14 -04:00
|
|
|
|
2002-05-04 20:45:01 -04:00
|
|
|
void meta_core_get_frame_extents (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
int *x,
|
|
|
|
|
int *y,
|
|
|
|
|
int *width,
|
|
|
|
|
int *height);
|
|
|
|
|
|
|
|
|
|
|
2001-06-23 01:49:35 -04:00
|
|
|
void meta_core_show_window_menu (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
int root_x,
|
|
|
|
|
int root_y,
|
|
|
|
|
int button,
|
|
|
|
|
Time timestamp);
|
|
|
|
|
|
2002-09-26 21:40:17 -04:00
|
|
|
void meta_core_get_menu_accelerator (MetaMenuOp menu_op,
|
|
|
|
|
int workspace,
|
|
|
|
|
unsigned int *keysym,
|
|
|
|
|
MetaVirtualModifier *modifiers);
|
|
|
|
|
|
2001-07-25 23:14:45 -04:00
|
|
|
gboolean meta_core_begin_grab_op (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow,
|
|
|
|
|
MetaGrabOp op,
|
|
|
|
|
gboolean pointer_already_grabbed,
|
2003-11-24 13:09:47 -05:00
|
|
|
int event_serial,
|
2001-07-25 23:14:45 -04:00
|
|
|
int button,
|
|
|
|
|
gulong modmask,
|
|
|
|
|
Time timestamp,
|
|
|
|
|
int root_x,
|
|
|
|
|
int root_y);
|
|
|
|
|
void meta_core_end_grab_op (Display *xdisplay,
|
|
|
|
|
Time timestamp);
|
|
|
|
|
MetaGrabOp meta_core_get_grab_op (Display *xdisplay);
|
|
|
|
|
Window meta_core_get_grab_frame (Display *xdisplay);
|
|
|
|
|
int meta_core_get_grab_button (Display *xdisplay);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void meta_core_grab_buttons (Display *xdisplay,
|
|
|
|
|
Window frame_xwindow);
|
|
|
|
|
|
|
|
|
|
void meta_core_set_screen_cursor (Display *xdisplay,
|
|
|
|
|
Window frame_on_screen,
|
|
|
|
|
MetaCursor cursor);
|
|
|
|
|
|
2002-05-04 20:45:01 -04:00
|
|
|
void meta_core_get_screen_size (Display *xdisplay,
|
|
|
|
|
Window frame_on_screen,
|
|
|
|
|
int *width,
|
|
|
|
|
int *height);
|
|
|
|
|
|
2001-08-30 00:01:38 -04:00
|
|
|
/* Used because we ignore EnterNotify when a window is unmapped that
|
|
|
|
|
* really shouldn't cause focus changes, by comparing the event serial
|
|
|
|
|
* of the EnterNotify and the UnmapNotify.
|
|
|
|
|
*/
|
|
|
|
|
void meta_core_increment_event_serial (Display *display);
|
|
|
|
|
|
2003-11-24 13:09:47 -05:00
|
|
|
int meta_ui_get_last_event_serial (Display *xdisplay);
|
|
|
|
|
|
2001-06-17 15:53:45 -04:00
|
|
|
#endif
|
2001-06-20 00:29:28 -04:00
|
|
|
|
|
|
|
|
|
2001-07-25 23:14:45 -04:00
|
|
|
|
|
|
|
|
|