src/window.h

   1 /*
   2  *  Window Maker window manager
   3  *
   4  *  Copyright (c) 1997-2003 Alfredo K. Kojima
   5  *
   6  *  This program is free software; you can redistribute it and/or modify
   7  *  it under the terms of the GNU General Public License as published by
   8  *  the Free Software Foundation; either version 2 of the License, or
   9  *  (at your option) any later version.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
  19  *  USA.
  20  */
  21
  22 #ifndef WMWINDOW_H_
  23 #define WMWINDOW_H_
  24
  25 #include <wraster.h>
  26
  27 #include "wconfig.h"
  28 #include "GNUstep.h"
  29 #include "texture.h"
  30 #include "menu.h"
  31 #include "application.h"
  32
  33 /* not defined in my X11 headers */
  34 #ifndef UrgencyHint
  35 #define UrgencyHint (1L << 8)
  36 #endif
  37
  38
  39 #define BORDER_TOP      1
  40 #define BORDER_BOTTOM   2
  41 #define BORDER_LEFT     4
  42 #define BORDER_RIGHT    8
  43 #define BORDER_ALL      (1|2|4|8)
  44
  45
  46 #define CLIENT_EVENTS (StructureNotifyMask | PropertyChangeMask\
  47     | EnterWindowMask | LeaveWindowMask | ColormapChangeMask \
  48     | FocusChangeMask | VisibilityChangeMask)
  49
  50 typedef enum {
  51     WFM_PASSIVE, WFM_NO_INPUT, WFM_LOCALLY_ACTIVE, WFM_GLOBALLY_ACTIVE
  52 } FocusMode;
  53
  54
  55 /*
  56  * window attribute flags.
  57  *
  58  * Note: attributes that should apply to the application as a
  59  * whole should only access the flags from app->main_window_desc->window_flags
  60  * This is to make sure that the application doesn't have many different
  61  * values for the same option. For example, imagine xfoo, which has
  62  * foo.bar as leader and it a child window named foo.baz. If you set
  63  * StartHidden YES for foo.bar and NO for foo.baz we must *always* guarantee
  64  * that the value that will be used will be that of the leader foo.bar.
  65  * The attributes inspector must always save application wide options
  66  * in the name of the leader window, not the child.
  67  *
  68  */
  69 /*
  70  * All flags must have their default values = 0
  71  *
  72  * New flag scheme:
  73  *
  74  * user_flags, defined_flags
  75  * client_flags
  76  *
  77  * if defined window_flag then window_flag else client_flag
  78  *
  79  */
  80
  81 #define WFLAGP(wwin, FLAG)      ((wwin)->defined_user_flags.FLAG \
  82     ? (wwin)->user_flags.FLAG \
  83     : (wwin)->client_flags.FLAG)
  84
  85 #define WSETUFLAG(wwin, FLAG, VAL)      (wwin)->user_flags.FLAG = (VAL),\
  86     (wwin)->defined_user_flags.FLAG = 1
  87
  88 typedef struct {
  89     /* OpenStep */
  90     unsigned int no_titlebar:1;        /* draw titlebar? */
  91     unsigned int no_resizable:1;
  92     unsigned int no_closable:1;
  93     unsigned int no_miniaturizable:1;
  94     unsigned int no_border:1;          /* 1 pixel border around window */
  95 #ifdef XKB_BUTTON_HINT
  96     unsigned int no_language_button:1;
  97 #endif
  98     unsigned int no_movable:1;
  99
 100     /* decorations */
 101     unsigned int no_resizebar:1;       /* draw the bottom handle? */
 102     unsigned int no_close_button:1;    /* draw a close button? */
 103     unsigned int no_miniaturize_button:1; /* draw an iconify button? */
 104
 105     unsigned int broken_close:1;       /* is the close button broken? */
 106
 107     /* ours */
 108     unsigned int kill_close:1;         /* can't send WM_DELETE_WINDOW */
 109
 110     unsigned int no_shadeable:1;
 111     unsigned int omnipresent:1;
 112     unsigned int skip_window_list:1;
 113     unsigned int floating:1;           /* put in WMFloatingLevel */
 114     unsigned int sunken:1;             /* put in WMSunkenLevel */
 115     unsigned int no_bind_keys:1;       /* intercept wm kbd binds
 116                                         * while window is focused */
 117     unsigned int no_bind_mouse:1;      /* intercept mouse events
 118                                         * on client area while window
 119                                         * is focused */
 120     unsigned int no_hide_others:1;     /* hide window when doing hideothers */
 121     unsigned int no_appicon:1;         /* make app icon */
 122
 123     unsigned int shared_appicon:1;
 124
 125     unsigned int dont_move_off:1;
 126
 127     unsigned int no_focusable:1;
 128
 129     unsigned int always_user_icon:1;   /* ignore client IconPixmap or
 130                                         * IconWindow */
 131
 132     unsigned int start_miniaturized:1;
 133     unsigned int start_hidden:1;
 134     unsigned int start_maximized:1;
 135     unsigned int dont_save_session:1;  /* do not save app's state in session */
 136
 137     unsigned int full_maximize:1;
 138
 139 #ifdef VIRTUAL_DESKTOP
 140     unsigned int virtual_stick:1;
 141 #endif
 142
 143     /*
 144      * emulate_app_icon must be automatically disabled for apps that can
 145      * generate their own appicons and for apps that have no_appicon=1
 146      */
 147     unsigned int emulate_appicon:1;
 148
 149     /* toolkit specific attribute flags. These are unchangeable and
 150      * unconfigurable and must not be saved as state. */
 151 #ifdef OLWM_HINTS
 152     unsigned int olwm_transient:1;
 153     unsigned int olwm_warp_to_pin:1;
 154 #endif
 155 } WWindowAttributes;
 156
 157
 158
 159 /*
 160  * Window manager protocols that both the client as we understand.
 161  */
 162 typedef struct {
 163     unsigned int TAKE_FOCUS:1;
 164     unsigned int DELETE_WINDOW:1;
 165     unsigned int SAVE_YOURSELF:1;
 166     /* WindowMaker specific */
 167     unsigned int MINIATURIZE_WINDOW:1;
 168 #ifdef MONITOR_HEARTBEAT
 169     unsigned int HEARTBEAT:1;
 170 #endif
 171 } WProtocols;
 172
 173
 174 /*
 175  * Structure used for storing fake window group information
 176  */
 177 typedef struct WFakeGroupLeader {
 178     char *identifier;
 179     Window leader;
 180     Window origLeader;
 181     int retainCount;
 182 } WFakeGroupLeader;
 183
 184
 185 /*
 186  * Stores client window information. Each client window has it's
 187  * structure created when it's being first mapped.
 188  */
 189 typedef struct WWindow {
 190     struct WWindow *prev;              /* window focus list */
 191     struct WWindow *next;
 192
 193     WScreen *screen_ptr;               /* pointer to the screen structure */
 194     WWindowAttributes user_flags;      /* window attribute flags set by user */
 195     WWindowAttributes defined_user_flags;/* mask for user_flags */
 196     WWindowAttributes client_flags;    /* window attribute flags set by app
 197                                         * initialized with global defaults */
 198
 199     struct InspectorPanel *inspector;  /*  pointer to attribute editor panel */
 200
 201     struct WFrameWindow *frame;        /* the frame window */
 202     int frame_x, frame_y;              /* position of the frame in root*/
 203
 204     struct {
 205         int x, y;
 206         unsigned int width, height;    /* original geometry of the window */
 207     } old_geometry;                    /* (before things like maximize) */
 208
 209     struct {
 210         int x, y;
 211         unsigned int width, height;    /* original geometry of the window */
 212     } bfs_geometry;                    /* (before fullscreen) */
 213
 214     /* client window info */
 215     short old_border_width;            /* original border width of client_win*/
 216     Window client_win;                 /* the window we're managing */
 217     WObjDescriptor client_descriptor;  /* dummy descriptor for client */
 218     struct {
 219         int x, y;                      /* position of *client* relative
 220                                         * to root */
 221         unsigned int width, height;    /* size of the client window */
 222     } client;
 223
 224     XSizeHints *normal_hints;          /* WM_NORMAL_HINTS */
 225     XWMHints *wm_hints;                /* WM_HINTS (optional) */
 226     char *wm_instance;                 /* instance of WM_CLASS */
 227     char *wm_class;                    /* class of WM_CLASS */
 228     GNUstepWMAttributes *wm_gnustep_attr;/* GNUstep window attributes */
 229
 230     int state;                         /* state as in ICCCM */
 231
 232     Window transient_for;              /* WM_TRANSIENT_FOR */
 233
 234     WFakeGroupLeader *fake_group;      /* Fake group leader for grouping into
 235                                           a single appicon */
 236     Window group_id;                   /* the leader window of the group */
 237     Window client_leader;              /* WM_CLIENT_LEADER if not
 238                                           internal_window */
 239
 240     Window main_window;                /* main window for the application */
 241
 242     Window orig_main_window;           /* original main window of application.
 243                                           used for the shared appicon thing */
 244
 245     int cmap_window_no;
 246     Window *cmap_windows;
 247
 248     /* protocols */
 249     WProtocols protocols;              /* accepted WM_PROTOCOLS */
 250
 251     FocusMode focus_mode;              /* type of keyboard input focus */
 252
 253 #ifdef OLWM_HINTS_unfinished
 254     struct WOLWindowState ol_window_state;
 255 #endif
 256
 257     long event_mask;                   /* the event mask thats selected */
 258
 259 #ifdef MONITOR_HEARTBEAT
 260     time_t last_beat;
 261 #endif
 262     struct {
 263         /* state flags */
 264         unsigned int mapped:1;
 265         unsigned int focused:1;
 266         unsigned int miniaturized:1;
 267         unsigned int hidden:1;
 268         unsigned int shaded:1;
 269         unsigned int maximized:2;
 270         unsigned int fullscreen:1;
 271         unsigned int omnipresent:1;
 272
 273         unsigned int semi_focused:1;
 274         /* window type flags */
 275         unsigned int urgent:1;         /* if wm_hints says this is urgent */
 276 #ifdef SHAPE
 277         unsigned int shaped:1;
 278 #endif
 279
 280         /* info flags */
 281         unsigned int is_gnustep:1;  /* 1 if the window belongs to a GNUstep
 282                                        app */
 283
 284         unsigned int buttons_dont_fit:1;
 285         unsigned int rebuild_texture:1;  /* the window was resized and
 286                                           * gradients should be re-rendered */
 287         unsigned int needs_full_repaint:1;/* does a full repaint of the
 288                                            * window next time it's painted */
 289         unsigned int icon_moved:1;     /* icon for this window was moved
 290                                         * by the user */
 291         unsigned int selected:1;       /* multiple window selection */
 292         unsigned int skip_next_animation:1;
 293         unsigned int internal_window:1;
 294         unsigned int changing_workspace:1;
 295
 296         unsigned int inspector_open:1; /* attrib inspector is already open */
 297
 298         unsigned int destroyed:1;      /* window was already destroyed */
 299
 300         unsigned int menu_open_for_me:1;   /* window commands menu */
 301
 302         unsigned int waiting_save_ack:1;   /* waiting for SAVE_YOURSELF ack */
 303
 304         unsigned int obscured:1;       /* window is obscured */
 305
 306         unsigned int dragged_while_fmaximized;
 307
 308         unsigned int user_changed_width:1;
 309         unsigned int user_changed_height:1;
 310         unsigned int wm_name_changed:1;
 311
 312 #ifdef KWM_HINTS
 313         unsigned int kwm_hidden_for_modules:1;
 314         unsigned int kwm_managed:1;
 315         unsigned int kwm_menubar:1;
 316 #endif
 317 #ifdef OLWM_HINTS
 318         unsigned int olwm_push_pin_out:1;/* emulate pushpin behaviour */
 319         unsigned int olwm_limit_menu:1;
 320 #endif
 321 #ifdef NETWM_HINTS
 322         unsigned int net_state_from_client:1; /* state hint was set by client */
 323         unsigned int net_skip_pager:1;
 324         unsigned int net_handle_icon:1;
 325         unsigned int net_show_desktop:1;
 326 #endif
 327     } flags;            /* state of the window */
 328
 329     struct WIcon *icon;                /* icon info for the window */
 330     int icon_x, icon_y;                /* position of the icon */
 331 #ifdef NETWM_HINTS
 332     int icon_w, icon_h;
 333     RImage *net_icon_image;
 334     Atom type;
 335 #endif
 336 } WWindow;
 337
 338
 339 #define HAS_TITLEBAR(w)     (!(WFLAGP((w), no_titlebar) || (w)->flags.fullscreen))
 340 #define HAS_RESIZEBAR(w)    (!(WFLAGP((w), no_resizebar) || (w)->flags.fullscreen))
 341 #define HAS_BORDER(w)       (!(WFLAGP((w), no_border) || (w)->flags.fullscreen))
 342 #define IS_MOVABLE(w)       (!(WFLAGP((w), no_movable) || (w)->flags.fullscreen))
 343 #define IS_RESIZABLE(w)    (!(WFLAGP((w), no_resizable) || (w)->flags.fullscreen))
 344
 345 #ifdef VIRTUAL_DESKTOP
 346 # define IS_VSTUCK(w)       (WFLAGP((w), virtual_stick) || (w)->flags.fullscreen)
 347 #endif
 348
 349 /* XXX: CHECK THIS,.. IT SEEMED WEIRD TO ME!!! */
 350 #define IS_OMNIPRESENT(w) ((w)->flags.omnipresent | WFLAGP(w, omnipresent))
 351
 352 #define WINDOW_LEVEL(w) ((w)->frame->core->stacking->window_level)
 353
 354
 355
 356 /*
 357  * Changes to this must update wWindowSaveState/getSavedState
 358  *
 359  */
 360 typedef struct WSavedState {
 361     int workspace;
 362     int miniaturized;
 363     int shaded;
 364     int hidden;
 365     int maximized;
 366     int x;                             /* original geometry of the */
 367     int y;                             /* window if it's maximized */
 368     unsigned int w;
 369     unsigned int h;
 370     unsigned window_shortcuts; /* mask like 1<<shortcut_number */
 371 } WSavedState;
 372
 373
 374 typedef struct WWindowState {
 375     char *instance;
 376     char *class;
 377     char *command;
 378     pid_t pid;
 379     WSavedState *state;
 380     struct WWindowState *next;
 381 } WWindowState;
 382
 383
 384 typedef void* WMagicNumber;
 385
 386
 387
 388 void wWindowDestroy(WWindow *wwin);
 389 WWindow *wWindowCreate();
 390
 391 #ifdef SHAPE
 392 void wWindowSetShape(WWindow *wwin);
 393 void wWindowClearShape(WWindow *wwin);
 394 #endif
 395
 396 WWindow *wManageWindow(WScreen *scr, Window window);
 397
 398 void wUnmanageWindow(WWindow *wwin, Bool restore, Bool destroyed);
 399
 400 void wWindowFocus(WWindow *wwin, WWindow *owin);
 401 void wWindowUnfocus(WWindow *wwin);
 402
 403 void wWindowUpdateName(WWindow *wwin, char *newTitle);
 404 void wWindowConstrainSize(WWindow *wwin, int *nwidth, int *nheight);
 405 void wWindowCropSize(WWindow *wwin, int maxw, int maxh,
 406                      int *nwidth, int *nheight);
 407 void wWindowConfigure(WWindow *wwin, int req_x, int req_y,
 408                       int req_width, int req_height);
 409
 410 void wWindowMove(WWindow *wwin, int req_x, int req_y);
 411
 412 void wWindowSynthConfigureNotify(WWindow *wwin);
 413
 414 WWindow *wWindowFor(Window window);
 415
 416
 417 void wWindowConfigureBorders(WWindow *wwin);
 418
 419 void wWindowUpdateButtonImages(WWindow *wwin);
 420
 421 void wWindowSaveState(WWindow *wwin);
 422
 423 void wWindowChangeWorkspace(WWindow *wwin, int workspace);
 424
 425 void wWindowSetKeyGrabs(WWindow *wwin);
 426
 427 void wWindowResetMouseGrabs(WWindow *wwin);
 428
 429 WWindow *wManageInternalWindow(WScreen *scr, Window window, Window owner,
 430                                char *title, int x, int y,
 431                                int width, int height);
 432
 433 void wWindowSetupInitialAttributes(WWindow *wwin, int *level, int *workspace);
 434
 435 void wWindowUpdateGNUstepAttr(WWindow *wwin, GNUstepWMAttributes *attr);
 436
 437 void wWindowMap(WWindow *wwin);
 438
 439 void wWindowUnmap(WWindow *wwin);
 440
 441 Bool wWindowCanReceiveFocus(WWindow *wwin);
 442
 443 void wWindowDeleteSavedStatesForPID(pid_t pid);
 444
 445 WMagicNumber wWindowAddSavedState(char *instance, char *class, char *command,
 446                                   pid_t pid, WSavedState *state);
 447
 448 WMagicNumber wWindowGetSavedState(Window win);
 449
 450 void wWindowDeleteSavedState(WMagicNumber id);
 451
 452 Bool wWindowObscuresWindow(WWindow *wwin, WWindow *obscured);
 453
 454 void wWindowSetOmnipresent(WWindow *wwin, Bool flag);
 455
 456 #endif