2006-10-01 18:30:10 -04:00
|
|
|
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
|
|
|
|
2001-05-30 11:36:31 -04:00
|
|
|
/* Metacity utilities */
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Copyright (C) 2001 Havoc Pennington
|
2005-10-08 15:38:54 -04:00
|
|
|
* Copyright (C) 2005 Elijah Newren
|
2001-05-30 11:36:31 -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_UTIL_H
|
|
|
|
|
#define META_UTIL_H
|
|
|
|
|
|
|
|
|
|
#include <glib.h>
|
|
|
|
|
|
|
|
|
|
gboolean meta_is_verbose (void);
|
|
|
|
|
void meta_set_verbose (gboolean setting);
|
2001-05-31 02:42:58 -04:00
|
|
|
gboolean meta_is_debugging (void);
|
|
|
|
|
void meta_set_debugging (gboolean setting);
|
|
|
|
|
gboolean meta_is_syncing (void);
|
|
|
|
|
void meta_set_syncing (gboolean setting);
|
2002-06-08 19:55:27 -04:00
|
|
|
gboolean meta_get_replace_current_wm (void);
|
|
|
|
|
void meta_set_replace_current_wm (gboolean setting);
|
2001-05-30 11:36:31 -04:00
|
|
|
|
2002-12-08 14:17:17 -05:00
|
|
|
void meta_debug_spew_real (const char *format,
|
|
|
|
|
...) G_GNUC_PRINTF (1, 2);
|
|
|
|
|
void meta_verbose_real (const char *format,
|
|
|
|
|
...) G_GNUC_PRINTF (1, 2);
|
|
|
|
|
|
2001-05-30 23:30:58 -04:00
|
|
|
void meta_bug (const char *format,
|
|
|
|
|
...) G_GNUC_PRINTF (1, 2);
|
2001-05-30 11:36:31 -04:00
|
|
|
void meta_warning (const char *format,
|
|
|
|
|
...) G_GNUC_PRINTF (1, 2);
|
|
|
|
|
void meta_fatal (const char *format,
|
|
|
|
|
...) G_GNUC_PRINTF (1, 2);
|
|
|
|
|
|
2002-01-03 18:28:19 -05:00
|
|
|
typedef enum
|
|
|
|
|
{
|
2006-03-16 21:55:21 -05:00
|
|
|
META_DEBUG_FOCUS = 1 << 0,
|
|
|
|
|
META_DEBUG_WORKAREA = 1 << 1,
|
|
|
|
|
META_DEBUG_STACK = 1 << 2,
|
|
|
|
|
META_DEBUG_THEMES = 1 << 3,
|
|
|
|
|
META_DEBUG_SM = 1 << 4,
|
|
|
|
|
META_DEBUG_EVENTS = 1 << 5,
|
|
|
|
|
META_DEBUG_WINDOW_STATE = 1 << 6,
|
|
|
|
|
META_DEBUG_WINDOW_OPS = 1 << 7,
|
|
|
|
|
META_DEBUG_GEOMETRY = 1 << 8,
|
|
|
|
|
META_DEBUG_PLACEMENT = 1 << 9,
|
|
|
|
|
META_DEBUG_PING = 1 << 10,
|
|
|
|
|
META_DEBUG_XINERAMA = 1 << 11,
|
|
|
|
|
META_DEBUG_KEYBINDINGS = 1 << 12,
|
|
|
|
|
META_DEBUG_SYNC = 1 << 13,
|
|
|
|
|
META_DEBUG_ERRORS = 1 << 14,
|
|
|
|
|
META_DEBUG_STARTUP = 1 << 15,
|
|
|
|
|
META_DEBUG_PREFS = 1 << 16,
|
|
|
|
|
META_DEBUG_GROUPS = 1 << 17,
|
|
|
|
|
META_DEBUG_RESIZING = 1 << 18,
|
|
|
|
|
META_DEBUG_SHAPES = 1 << 19,
|
|
|
|
|
META_DEBUG_COMPOSITOR = 1 << 20,
|
|
|
|
|
META_DEBUG_EDGE_RESISTANCE = 1 << 21
|
2002-01-03 18:28:19 -05:00
|
|
|
} MetaDebugTopic;
|
|
|
|
|
|
2002-12-08 14:17:17 -05:00
|
|
|
void meta_topic_real (MetaDebugTopic topic,
|
|
|
|
|
const char *format,
|
|
|
|
|
...) G_GNUC_PRINTF (2, 3);
|
2002-01-03 18:28:19 -05:00
|
|
|
|
2001-06-10 15:23:28 -04:00
|
|
|
void meta_push_no_msg_prefix (void);
|
|
|
|
|
void meta_pop_no_msg_prefix (void);
|
|
|
|
|
|
2002-08-12 17:32:13 -04:00
|
|
|
gint meta_unsigned_long_equal (gconstpointer v1,
|
|
|
|
|
gconstpointer v2);
|
|
|
|
|
guint meta_unsigned_long_hash (gconstpointer v);
|
|
|
|
|
|
2002-10-26 23:03:32 -04:00
|
|
|
void meta_print_backtrace (void);
|
|
|
|
|
|
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
|
|
|
const char* meta_gravity_to_string (int gravity);
|
|
|
|
|
|
2001-12-09 17:41:12 -05:00
|
|
|
#include <libintl.h>
|
|
|
|
|
#define _(x) dgettext (GETTEXT_PACKAGE, x)
|
2001-06-21 02:08:35 -04:00
|
|
|
#define N_(x) x
|
2001-05-30 11:36:31 -04:00
|
|
|
|
2005-10-03 14:13:45 -04:00
|
|
|
char* meta_g_utf8_strndup (const gchar *src, gsize n);
|
2002-12-08 14:17:17 -05:00
|
|
|
|
Patch from Carlo Wood to fix handling of unidirectional maximization and
2007-04-02 Elijah Newren <newren gmail com>
Patch from Carlo Wood to fix handling of unidirectional
maximization and partial struts. #358311.
* src/constraints.c (constrain_maximization):
determine target size for unidirectionally maximized windows by
determining how far they can be maximized without hitting
orthogonal struts. Avoids weird "empty spaces".
* src/boxes.[ch] (meta_rectangle_expand_to_avoiding_struts):
new function
2007-04-02 Elijah Newren <newren gmail com>
Make the strut lists (stored in workspaces) record both the
rectangle and the side that the strut is on. Lots of code
cleanups relating to struts.
* src/boxes.h (struct MetaStrut):
new struct for struts
* src/window.[ch] (struct MetaStruts, struct MetaWindow,
meta_window_update_struts):
overhaul to make window's struts remember their side as well as
their rectangular location, and just use a list instead of several
copies of near-identical code for left/right/top/bottom (allowing
us to nuke MetaStruts struct as well)
* src/testboxes.c (new_meta_strut, get_strut_list):
* src/workspace.c (ensure_work_areas_validated):
* src/boxes.c (meta_rectangle_get_minimal_spanning_set_for_region,
meta_rectangle_expand_to_avoiding_struts,
get_disjoint_strut_rect_list_in_region, fix_up_edges,
meta_rectangle_find_onscreen_edges,
meta_rectangle_find_nonintersected_xinerama_edges):
modify to handle struts being rectangle + side instead of just rectangle
* src/workspace.c (ensure_work_areas_validated):
simplify strut list creation considerably given MetaWindow change,
modify work_area computations to take advantage of region
computations being done (makes the code shorter as well as more
robust against pathological cases).
* src/util.[ch] (meta_free_gslist_and_elements):
new convenience function
* src/common.h (enum MetaDirection):
* src/edge-resistance.c (movement_towards_edge):
* src/boxes.c (meta_rectangle_edge_aligns,
rectangle_and_edge_intersection, split_edge):
Add more MetaDirection fields for convenience
* src/boxes.h (enum FixedDirections):
* src/constraints.c (setup_constraint_info, place_window_if_needed):
add a FIXED_DIRECTION_NONE to the FixedDirections enum to make
code more clear
svn path=/trunk/; revision=3144
2007-04-02 23:41:10 -04:00
|
|
|
void meta_free_gslist_and_elements (GSList *list_to_deep_free);
|
|
|
|
|
|
2008-11-08 13:51:56 -05:00
|
|
|
void meta_show_dialog (const char *type,
|
|
|
|
|
const char *title,
|
|
|
|
|
const char *message,
|
|
|
|
|
gint timeout,
|
|
|
|
|
const char **columns,
|
|
|
|
|
const char **entries);
|
|
|
|
|
|
2002-12-08 14:17:17 -05:00
|
|
|
/* To disable verbose mode, we make these functions into no-ops */
|
|
|
|
|
#ifdef WITH_VERBOSE_MODE
|
|
|
|
|
|
|
|
|
|
#define meta_debug_spew meta_debug_spew_real
|
|
|
|
|
#define meta_verbose meta_verbose_real
|
|
|
|
|
#define meta_topic meta_topic_real
|
|
|
|
|
|
|
|
|
|
#else
|
|
|
|
|
|
|
|
|
|
# ifdef G_HAVE_ISO_VARARGS
|
|
|
|
|
# define meta_debug_spew(...)
|
|
|
|
|
# define meta_verbose(...)
|
|
|
|
|
# define meta_topic(...)
|
|
|
|
|
# elif defined(G_HAVE_GNUC_VARARGS)
|
|
|
|
|
# define meta_debug_spew(format...)
|
|
|
|
|
# define meta_verbose(format...)
|
|
|
|
|
# define meta_topic(format...)
|
|
|
|
|
# else
|
|
|
|
|
# error "This compiler does not support varargs macros and thus verbose mode can't be disabled meaningfully"
|
|
|
|
|
# endif
|
|
|
|
|
|
|
|
|
|
#endif /* !WITH_VERBOSE_MODE */
|
|
|
|
|
|
|
|
|
|
#endif /* META_UTIL_H */
|
2001-06-18 02:11:53 -04:00
|
|
|
|
|
|
|
|
|