1 /* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*- 2 3 config.h for the Openbox window manager 4 Copyright (c) 2006 Mikael Magnusson 5 Copyright (c) 2003-2007 Dana Jansens 6 7 This program is free software; you can redistribute it and/or modify 8 it under the terms of the GNU General Public License as published by 9 the Free Software Foundation; either version 2 of the License, or 10 (at your option) any later version. 11 12 This program is distributed in the hope that it will be useful, 13 but WITHOUT ANY WARRANTY; without even the implied warranty of 14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 GNU General Public License for more details. 16 17 See the COPYING file for a copy of the GNU General Public License. 18 */ 19 20 #ifndef __config_h 21 #define __config_h 22 23 #include "misc.h" 24 #include "stacking.h" 25 #include "place.h" 26 #include "client.h" 27 #include "geom.h" 28 #include "moveresize.h" 29 #include "obrender/render.h" 30 #include "obt/xml.h" 31 32 #include <glib.h> 33 34 typedef struct _ObAppSettings ObAppSettings; 35 36 struct _ObAppSettings 37 { 38 GPatternSpec *class; 39 GPatternSpec *name; 40 GPatternSpec *role; 41 GPatternSpec *group_class; 42 GPatternSpec *group_name; 43 GPatternSpec *title; 44 ObClientType type; 45 46 GravityPoint position; 47 gboolean pos_given; 48 gboolean pos_force; 49 50 gint width_num; 51 gint width_denom; 52 gint height_num; 53 gint height_denom; 54 55 guint desktop; 56 gint shade; 57 gint decor; 58 gint focus; 59 ObPlaceMonitor monitor_type; 60 gint monitor; 61 gint iconic; 62 gint skip_pager; 63 gint skip_taskbar; 64 gint max_horz; 65 gint max_vert; 66 gint fullscreen; 67 68 gint layer; 69 }; 70 71 /*! Should new windows be focused */ 72 extern gboolean config_focus_new; 73 /*! Focus windows when the mouse enters them */ 74 extern gboolean config_focus_follow; 75 /*! Timeout for focusing windows on focus follows mouse, in milliseconds */ 76 extern guint config_focus_delay; 77 /*! If windows should automatically be raised when they are focused in 78 focus follows mouse */ 79 extern gboolean config_focus_raise; 80 /*! Focus the last focused window, not under the mouse, in follow mouse mode */ 81 extern gboolean config_focus_last; 82 /*! Try keep focus on the window under the mouse when the mouse is not moving 83 */ 84 extern gboolean config_focus_under_mouse; 85 /*! Remove focus from windows when the mouse leaves them 86 */ 87 extern gboolean config_unfocus_leave; 88 89 /*! The algorithm to use for placing new windows */ 90 extern ObPlacePolicy config_place_policy; 91 /*! Place windows in the center of the free area */ 92 extern gboolean config_place_center; 93 /*! Place windows on the active monitor (unless they are part of an application 94 already on another monitor) */ 95 extern ObPlaceMonitor config_place_monitor; 96 97 /*! Place dialogs and stuff on this monitor. Index starts at 1. If this is 98 0, then use the config_primary_monitor instead. */ 99 extern guint config_primary_monitor_index; 100 /*! Where to place dialogs and stuff if it is not specified by index. */ 101 extern ObPlaceMonitor config_primary_monitor; 102 103 /*! User-specified margins around the edge of the screen(s) */ 104 extern StrutPartial config_margins; 105 106 /*! When true windows' contents are refreshed while they are resized; otherwise 107 they are not updated until the resize is complete */ 108 extern gboolean config_resize_redraw; 109 /*! show move/resize popups? 0 = no, 1 = always, 2 = only 110 resizing !1 increments */ 111 extern gint config_resize_popup_show; 112 /*! where to show the resize popup */ 113 extern ObResizePopupPos config_resize_popup_pos; 114 /*! where to place the popup if it's in a fixed position */ 115 extern GravityPoint config_resize_popup_fixed; 116 117 /*! The stacking layer the dock will reside in */ 118 extern ObStackingLayer config_dock_layer; 119 /*! Is the dock floating */ 120 extern gboolean config_dock_floating; 121 /*! Don't use a strut for the dock */ 122 extern gboolean config_dock_nostrut; 123 /*! Where to place the dock if not floating */ 124 extern ObDirection config_dock_pos; 125 /*! If config_dock_floating, this is the top-left corner's 126 position */ 127 extern gint config_dock_x; 128 /*! If config_dock_floating, this is the top-left corner's 129 position */ 130 extern gint config_dock_y; 131 /*! Whether the dock places the dockapps in it horizontally or vertically */ 132 extern ObOrientation config_dock_orient; 133 /*! Whether to auto-hide the dock when the pointer is not over it */ 134 extern gboolean config_dock_hide; 135 /*! The number of milliseconds to wait before hiding the dock */ 136 extern guint config_dock_hide_delay; 137 /*! The number of milliseconds to wait before showing the dock */ 138 extern guint config_dock_show_delay; 139 /*! The mouse button to be used to move dock apps */ 140 extern guint config_dock_app_move_button; 141 /*! The modifiers to be used with the button to move dock apps */ 142 extern guint config_dock_app_move_modifiers; 143 144 /*! The name of the theme */ 145 extern gchar *config_theme; 146 147 /*! Show the one-pixel border after toggleDecor */ 148 extern gboolean config_theme_keepborder; 149 /*! Titlebar button layout */ 150 extern gchar *config_title_layout; 151 /*! Animate windows iconifying and restoring */ 152 extern gboolean config_animate_iconify; 153 /*! Size of icons in focus switching dialogs */ 154 extern guint config_theme_window_list_icon_size; 155 156 /*! The font for the active window's title */ 157 extern RrFont *config_font_activewindow; 158 /*! The font for inactive windows' titles */ 159 extern RrFont *config_font_inactivewindow; 160 /*! The font for menu titles */ 161 extern RrFont *config_font_menutitle; 162 /*! The font for menu items */ 163 extern RrFont *config_font_menuitem; 164 /*! The font for on-screen-displays/popups' active text */ 165 extern RrFont *config_font_activeosd; 166 /*! The font for on-screen-displays/popups' inactive text */ 167 extern RrFont *config_font_inactiveosd; 168 169 /*! The number of desktops */ 170 extern guint config_desktops_num; 171 /*! Desktop to start on, put 5 to start in the center of a 3x3 grid */ 172 extern guint config_screen_firstdesk; 173 /*! Names for the desktops */ 174 extern GSList *config_desktops_names; 175 /*! Amount of time to show the desktop switch dialog */ 176 extern guint config_desktop_popup_time; 177 178 /*! The keycode of the key combo which resets the keybaord chains */ 179 extern guint config_keyboard_reset_keycode; 180 /*! The modifiers of the key combo which resets the keybaord chains */ 181 extern guint config_keyboard_reset_state; 182 /*! Reload the keyboard bindings when the mapping changes */ 183 extern gboolean config_keyboard_rebind_on_mapping_notify; 184 185 /*! Number of pixels a drag must go before being considered a drag */ 186 extern gint config_mouse_threshold; 187 /*! Number of milliseconds within which 2 clicks must occur to be a 188 double-click */ 189 extern gint config_mouse_dclicktime; 190 /*! Number of milliseconds that the mouse has to be on the screen edge before 191 a screen edge event is triggered */ 192 extern gint config_mouse_screenedgetime; 193 /*! When TRUE, the mouse is warped to the other side of the desktop after 194 switching desktops from bumping the screen edge */ 195 extern gboolean config_mouse_screenedgewarp; 196 197 /*! Number of pixels to resist while crossing another window's edge */ 198 extern gint config_resist_win; 199 /*! Number of pixels to resist while crossing a screen's edge */ 200 extern gint config_resist_edge; 201 202 /*! Delay for hiding menu when opening in milliseconds */ 203 extern guint config_menu_hide_delay; 204 /*! Center menus vertically about the parent entry */ 205 extern gboolean config_menu_middle; 206 /*! Delay before opening a submenu in milliseconds */ 207 extern guint config_submenu_show_delay; 208 /*! Delay before closing a submenu in milliseconds */ 209 extern guint config_submenu_hide_delay; 210 /*! Show manage desktops in client_list_menu */ 211 extern gboolean config_menu_manage_desktops; 212 /*! Load & show icons in user-defined menus */ 213 extern gboolean config_menu_show_icons; 214 /*! User-specified menu files */ 215 extern GSList *config_menu_files; 216 /*! Per app settings */ 217 extern GSList *config_per_app_settings; 218 219 void config_startup(ObtXmlInst *i); 220 void config_shutdown(void); 221 222 /*! Create an ObAppSettings structure with the default values */ 223 ObAppSettings* config_create_app_settings(void); 224 /*! Copies any settings in src to dest, if they are their default value in 225 src. */ 226 void config_app_settings_copy_non_defaults(const ObAppSettings *src, 227 ObAppSettings *dest); 228 /*! Parses an x geometry style position, with some extensions like ratios 229 and percentages */ 230 void config_parse_gravity_coord(xmlNodePtr node, GravityCoord *c); 231 /*! Parses a rational number or percentage into num and denom */ 232 void config_parse_relative_number(gchar *s, gint *num, gint *denom); 233 234 #endif 235