client: emit class signal on focus
[awesome.git] / client.c
blob2884e656efc124cae12598ec186ee3e3e955fd1c
1 /*
2 * client.c - client management
4 * Copyright © 2007-2009 Julien Danjou <julien@danjou.info>
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.
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.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22 #include <xcb/xcb_atom.h>
23 #include <xcb/xcb_image.h>
25 #include "tag.h"
26 #include "ewmh.h"
27 #include "screen.h"
28 #include "titlebar.h"
29 #include "systray.h"
30 #include "property.h"
31 #include "spawn.h"
32 #include "common/atoms.h"
33 #include "common/xutil.h"
35 client_t *
36 luaA_client_checkudata(lua_State *L, int ud)
38 client_t *c = luaL_checkudata(L, ud, "client");
39 if(c->invalid)
40 luaL_error(L, "client is invalid\n");
41 return c;
44 /** Collect a client.
45 * \param L The Lua VM state.
46 * \return The number of element pushed on stack.
48 static int
49 luaA_client_gc(lua_State *L)
51 client_t *c = luaL_checkudata(L, 1, "client");
52 button_array_wipe(&c->buttons);
53 key_array_wipe(&c->keys);
54 xcb_get_wm_protocols_reply_wipe(&c->protocols);
55 p_delete(&c->class);
56 p_delete(&c->startup_id);
57 p_delete(&c->instance);
58 p_delete(&c->icon_name);
59 p_delete(&c->name);
60 return luaA_object_gc(L);
63 /** Change the clients urgency flag.
64 * \param c The client
65 * \param urgent The new flag state
67 void
68 client_seturgent(client_t *c, bool urgent)
70 if(c->isurgent != urgent)
72 xcb_get_property_cookie_t hints =
73 xcb_get_wm_hints_unchecked(globalconf.connection, c->win);
75 c->isurgent = urgent;
76 ewmh_client_update_hints(c);
78 /* update ICCCM hints */
79 xcb_wm_hints_t wmh;
80 xcb_get_wm_hints_reply(globalconf.connection, hints, &wmh, NULL);
82 if(urgent)
83 wmh.flags |= XCB_WM_HINT_X_URGENCY;
84 else
85 wmh.flags &= ~XCB_WM_HINT_X_URGENCY;
87 xcb_set_wm_hints(globalconf.connection, c->win, &wmh);
89 hook_property(client, c, "urgent");
93 /** Returns true if a client is tagged
94 * with one of the tags of the specified screen.
95 * \param c The client to check.
96 * \param screen Virtual screen.
97 * \return true if the client is visible, false otherwise.
99 bool
100 client_maybevisible(client_t *c, screen_t *screen)
102 if(c->screen == screen)
104 if(c->issticky || c->type == WINDOW_TYPE_DESKTOP)
105 return true;
107 foreach(tag, screen->tags)
108 if((*tag)->selected && is_client_tagged(c, *tag))
109 return true;
111 return false;
114 /** Return the content of a client as an image.
115 * That's just take a screenshot.
116 * \param c The client.
117 * \return 1 if the image has been pushed on stack, false otherwise.
119 static int
120 client_getcontent(client_t *c)
122 xcb_image_t *ximage = xcb_image_get(globalconf.connection,
123 c->win,
124 0, 0,
125 c->geometries.internal.width,
126 c->geometries.internal.height,
127 ~0, XCB_IMAGE_FORMAT_Z_PIXMAP);
128 int retval = 0;
130 if(ximage)
132 if(ximage->bpp >= 24)
134 uint32_t *data = p_alloca(uint32_t, ximage->width * ximage->height);
136 for(int y = 0; y < ximage->height; y++)
137 for(int x = 0; x < ximage->width; x++)
139 data[y * ximage->width + x] = xcb_image_get_pixel(ximage, x, y);
140 data[y * ximage->width + x] |= 0xff000000; /* set alpha to 0xff */
143 retval = image_new_from_argb32(ximage->width, ximage->height, data);
145 xcb_image_destroy(ximage);
148 return retval;
151 /** Get a client by its window.
152 * \param w The client window to find.
153 * \return A client pointer if found, NULL otherwise.
155 client_t *
156 client_getbywin(xcb_window_t w)
158 foreach(c, globalconf.clients)
159 if((*c)->win == w)
160 return *c;
162 return NULL;
165 /** Record that a client lost focus.
166 * \param c Client being unfocused
168 void
169 client_unfocus_update(client_t *c)
171 globalconf.screens.tab[c->phys_screen].client_focus = NULL;
172 ewmh_update_net_active_window(c->phys_screen);
174 /* Call hook */
175 if(globalconf.hooks.unfocus != LUA_REFNIL)
177 client_push(globalconf.L, c);
178 luaA_dofunction_from_registry(globalconf.L, globalconf.hooks.unfocus, 1, 0);
183 /** Unfocus a client.
184 * \param c The client.
186 void
187 client_unfocus(client_t *c)
190 xcb_window_t root_win = xutil_screen_get(globalconf.connection, c->phys_screen)->root;
191 /* Set focus on root window, so no events leak to the current window.
192 * This kind of inlines client_setfocus(), but a root window will never have
193 * the WM_TAKE_FOCUS protocol.
195 xcb_set_input_focus(globalconf.connection, XCB_INPUT_FOCUS_PARENT,
196 root_win, XCB_CURRENT_TIME);
198 client_unfocus_update(c);
201 /** Check if client supports protocol a protocole in WM_PROTOCOL.
202 * \param c The client.
203 * \param atom The protocol atom to check for.
204 * \return True if client has the atom in protocol, false otherwise.
206 bool
207 client_hasproto(client_t *c, xcb_atom_t atom)
209 uint32_t i;
211 for(i = 0; i < c->protocols.atoms_len; i++)
212 if(c->protocols.atoms[i] == atom)
213 return true;
214 return false;
217 /** Sets focus on window - using xcb_set_input_focus or WM_TAKE_FOCUS
218 * \param c Client that should get focus
219 * \param set_input_focus Should we call xcb_set_input_focus
221 void
222 client_setfocus(client_t *c, bool set_input_focus)
224 bool takefocus = client_hasproto(c, WM_TAKE_FOCUS);
225 if(set_input_focus)
226 xcb_set_input_focus(globalconf.connection, XCB_INPUT_FOCUS_PARENT,
227 c->win, XCB_CURRENT_TIME);
228 if(takefocus)
229 window_takefocus(c->win);
232 /** Ban client and move it out of the viewport.
233 * \param c The client.
235 void
236 client_ban(client_t *c)
238 if(!c->isbanned)
240 xcb_unmap_window(globalconf.connection, c->win);
242 c->isbanned = true;
244 if(globalconf.screens.tab[c->phys_screen].prev_client_focus == c)
245 globalconf.screens.tab[c->phys_screen].prev_client_focus = NULL;
247 /* Wait until the last moment to take away the focus from the window. */
248 if(globalconf.screens.tab[c->phys_screen].client_focus == c)
249 client_unfocus(c);
253 /** This is part of The Bob Marley Algorithmm: we ignore enter and leave window
254 * in certain cases, like map/unmap or move, so we don't get spurious events.
256 void
257 client_ignore_enterleave_events(void)
259 foreach(c, globalconf.clients)
260 xcb_change_window_attributes(globalconf.connection,
261 (*c)->win,
262 XCB_CW_EVENT_MASK,
263 (const uint32_t []) { CLIENT_SELECT_INPUT_EVENT_MASK & ~(XCB_EVENT_MASK_ENTER_WINDOW | XCB_EVENT_MASK_LEAVE_WINDOW) });
266 void
267 client_restore_enterleave_events(void)
269 foreach(c, globalconf.clients)
270 xcb_change_window_attributes(globalconf.connection,
271 (*c)->win,
272 XCB_CW_EVENT_MASK,
273 (const uint32_t []) { CLIENT_SELECT_INPUT_EVENT_MASK });
276 /** Record that a client got focus.
277 * \param c Client being focused.
279 void
280 client_focus_update(client_t *c)
282 if(!client_maybevisible(c, c->screen))
284 /* Focus previously focused client */
285 client_focus(globalconf.screen_focus->prev_client_focus);
286 return;
289 if(globalconf.screen_focus
290 && globalconf.screen_focus->client_focus)
292 if (globalconf.screen_focus->client_focus != c)
293 client_unfocus_update(globalconf.screen_focus->client_focus);
294 else
295 /* Already focused */
296 return;
298 /* stop hiding client */
299 c->ishidden = false;
300 client_setminimized(c, false);
302 /* unban the client before focusing for consistency */
303 client_unban(c);
305 globalconf.screen_focus = &globalconf.screens.tab[c->phys_screen];
306 globalconf.screen_focus->prev_client_focus = c;
307 globalconf.screen_focus->client_focus = c;
309 /* according to EWMH, we have to remove the urgent state from a client */
310 client_seturgent(c, false);
312 ewmh_update_net_active_window(c->phys_screen);
314 /* execute hook */
315 if(globalconf.hooks.focus != LUA_REFNIL)
317 client_push(globalconf.L, c);
318 luaA_dofunction_from_registry(globalconf.L, globalconf.hooks.focus, 1, 0);
321 luaA_object_push(globalconf.L, c);
322 luaA_class_emit_signal(globalconf.L, &client_class, "focus", 1);
326 /** Give focus to client, or to first client if client is NULL.
327 * \param c The client or NULL.
329 void
330 client_focus(client_t *c)
332 /* We have to set focus on first client */
333 if(!c && globalconf.clients.len && !(c = globalconf.clients.tab[0]))
334 return;
336 if(!client_maybevisible(c, c->screen))
337 return;
339 if (!c->nofocus)
340 client_focus_update(c);
342 client_setfocus(c, !c->nofocus);
345 /** Stack a window below.
346 * \param c The client.
347 * \param previous The previous window on the stack.
348 * \return The next-previous!
350 static xcb_window_t
351 client_stack_above(client_t *c, xcb_window_t previous)
353 uint32_t config_win_vals[2];
355 config_win_vals[0] = previous;
356 config_win_vals[1] = XCB_STACK_MODE_ABOVE;
358 xcb_configure_window(globalconf.connection, c->win,
359 XCB_CONFIG_WINDOW_SIBLING | XCB_CONFIG_WINDOW_STACK_MODE,
360 config_win_vals);
362 config_win_vals[0] = c->win;
364 if(c->titlebar)
366 xcb_configure_window(globalconf.connection,
367 c->titlebar->window,
368 XCB_CONFIG_WINDOW_SIBLING | XCB_CONFIG_WINDOW_STACK_MODE,
369 config_win_vals);
370 previous = c->titlebar->window;
372 else
373 previous = c->win;
375 /* stack transient window on top of their parents */
376 foreach(node, globalconf.stack)
377 if((*node)->transient_for == c)
378 previous = client_stack_above(*node, previous);
380 return previous;
383 /** Stacking layout layers */
384 typedef enum
386 /** This one is a special layer */
387 LAYER_IGNORE,
388 LAYER_DESKTOP,
389 LAYER_BELOW,
390 LAYER_NORMAL,
391 LAYER_ABOVE,
392 LAYER_FULLSCREEN,
393 LAYER_ONTOP,
394 /** This one only used for counting and is not a real layer */
395 LAYER_COUNT
396 } layer_t;
398 /** Get the real layer of a client according to its attribute (fullscreen, …)
399 * \param c The client.
400 * \return The real layer.
402 static layer_t
403 client_layer_translator(client_t *c)
405 /* first deal with user set attributes */
406 if(c->isontop)
407 return LAYER_ONTOP;
408 else if(c->isfullscreen)
409 return LAYER_FULLSCREEN;
410 else if(c->isabove)
411 return LAYER_ABOVE;
412 else if(c->isbelow)
413 return LAYER_BELOW;
415 /* check for transient attr */
416 if(c->transient_for)
417 return LAYER_IGNORE;
419 /* then deal with windows type */
420 switch(c->type)
422 case WINDOW_TYPE_DESKTOP:
423 return LAYER_DESKTOP;
424 default:
425 break;
428 return LAYER_NORMAL;
431 /** Restack clients.
432 * \todo It might be worth stopping to restack everyone and only stack `c'
433 * relatively to the first matching in the list.
435 void
436 client_stack_refresh()
438 uint32_t config_win_vals[2];
439 layer_t layer;
441 if (!globalconf.client_need_stack_refresh)
442 return;
443 globalconf.client_need_stack_refresh = false;
445 config_win_vals[0] = XCB_NONE;
446 config_win_vals[1] = XCB_STACK_MODE_ABOVE;
448 /* stack desktop windows */
449 for(layer = LAYER_DESKTOP; layer < LAYER_BELOW; layer++)
450 foreach(node, globalconf.stack)
451 if(client_layer_translator(*node) == layer)
452 config_win_vals[0] = client_stack_above(*node,
453 config_win_vals[0]);
455 /* first stack not ontop wibox window */
456 foreach(_sb, globalconf.wiboxes)
458 wibox_t *sb = *_sb;
459 if(!sb->ontop)
461 xcb_configure_window(globalconf.connection,
462 sb->window,
463 XCB_CONFIG_WINDOW_SIBLING | XCB_CONFIG_WINDOW_STACK_MODE,
464 config_win_vals);
465 config_win_vals[0] = sb->window;
469 /* then stack clients */
470 for(layer = LAYER_BELOW; layer < LAYER_COUNT; layer++)
471 foreach(node, globalconf.stack)
472 if(client_layer_translator(*node) == layer)
473 config_win_vals[0] = client_stack_above(*node,
474 config_win_vals[0]);
476 /* then stack ontop wibox window */
477 foreach(_sb, globalconf.wiboxes)
479 wibox_t *sb = *_sb;
480 if(sb->ontop)
482 xcb_configure_window(globalconf.connection,
483 sb->window,
484 XCB_CONFIG_WINDOW_SIBLING | XCB_CONFIG_WINDOW_STACK_MODE,
485 config_win_vals);
486 config_win_vals[0] = sb->window;
491 /** Manage a new client.
492 * \param w The window.
493 * \param wgeom Window geometry.
494 * \param phys_screen Physical screen number.
495 * \param startup True if we are managing at startup time.
497 void
498 client_manage(xcb_window_t w, xcb_get_geometry_reply_t *wgeom, int phys_screen, bool startup)
500 xcb_get_property_cookie_t ewmh_icon_cookie;
501 screen_t *screen;
502 const uint32_t select_input_val[] = { CLIENT_SELECT_INPUT_EVENT_MASK };
504 if(systray_iskdedockapp(w))
506 systray_request_handle(w, phys_screen, NULL);
507 return;
510 /* Send request to get NET_WM_ICON property as soon as possible... */
511 ewmh_icon_cookie = ewmh_window_icon_get_unchecked(w);
512 xcb_change_window_attributes(globalconf.connection, w, XCB_CW_EVENT_MASK, select_input_val);
514 client_t *c = client_new(globalconf.L);
515 /* Push client in client list */
516 client_array_push(&globalconf.clients, client_ref(globalconf.L, -1));
519 screen = c->screen = screen_getbycoord(&globalconf.screens.tab[phys_screen],
520 wgeom->x, wgeom->y);
522 c->phys_screen = phys_screen;
524 /* consider the window banned */
525 c->isbanned = true;
527 /* Initial values */
528 c->win = w;
529 c->geometry.x = wgeom->x;
530 c->geometry.y = wgeom->y;
531 /* Border will be added later. */
532 c->geometry.width = wgeom->width;
533 c->geometry.height = wgeom->height;
534 /* Also set internal geometry (client_ban() needs it). */
535 c->geometries.internal.x = wgeom->x;
536 c->geometries.internal.y = wgeom->y;
537 c->geometries.internal.width = wgeom->width;
538 c->geometries.internal.height = wgeom->height;
539 client_setborder(c, wgeom->border_width);
541 if(ewmh_window_icon_get_reply(ewmh_icon_cookie))
543 client_push(globalconf.L, c);
544 c->icon = luaA_object_ref_item(globalconf.L, -1, -2);
545 lua_pop(globalconf.L, 1);
548 /* we honor size hints by default */
549 c->size_hints_honor = true;
551 /* update hints */
552 property_update_wm_normal_hints(c, NULL);
553 property_update_wm_hints(c, NULL);
554 property_update_wm_transient_for(c, NULL);
555 property_update_wm_client_leader(c, NULL);
556 property_update_wm_client_machine(c);
557 property_update_wm_window_role(c);
558 property_update_net_wm_pid(c, NULL);
560 /* get opacity */
561 c->opacity = window_opacity_get(c->win);
563 /* Then check clients hints */
564 ewmh_client_check_hints(c);
566 /* move client to screen, but do not tag it */
567 screen_client_moveto(c, screen, false, true);
569 /* Push client in stack */
570 client_raise(c);
572 /* update window title */
573 property_update_wm_name(c);
574 property_update_wm_icon_name(c);
575 property_update_wm_class(c, NULL);
576 property_update_wm_protocols(c);
578 xutil_text_prop_get(globalconf.connection, c->win, _NET_STARTUP_ID, &c->startup_id, NULL);
580 /* update strut */
581 ewmh_process_client_strut(c, NULL);
583 ewmh_update_net_client_list(c->phys_screen);
585 /* Always stay in NORMAL_STATE. Even though iconified seems more
586 * appropriate sometimes. The only possible loss is that clients not using
587 * visibility events may continue to proces data (when banned).
588 * Without any exposes or other events the cost should be fairly limited though.
590 * Some clients may expect the window to be unmapped when STATE_ICONIFIED.
591 * Two conflicting parts of the ICCCM v2.0 (section 4.1.4):
593 * "Normal -> Iconic - The client should send a ClientMessage event as described later in this section."
594 * (note no explicit mention of unmapping, while Normal->Widthdrawn does mention that)
596 * "Once a client's window has left the Withdrawn state, the window will be mapped
597 * if it is in the Normal state and the window will be unmapped if it is in the Iconic state."
599 * At this stage it's just safer to keep it in normal state and avoid confusion.
601 window_state_set(c->win, XCB_WM_STATE_NORMAL);
603 if(!startup)
604 spawn_start_notify(c);
606 /* Call hook to notify list change */
607 if(globalconf.hooks.clients != LUA_REFNIL)
608 luaA_dofunction_from_registry(globalconf.L, globalconf.hooks.clients, 0, 0);
610 /* call hook */
611 if(globalconf.hooks.manage != LUA_REFNIL)
613 client_push(globalconf.L, c);
614 lua_pushboolean(globalconf.L, startup);
615 luaA_dofunction_from_registry(globalconf.L, globalconf.hooks.manage, 2, 0);
619 /** Compute client geometry with respect to its geometry hints.
620 * \param c The client.
621 * \param geometry The geometry that the client might receive.
622 * \return The geometry the client must take respecting its hints.
624 area_t
625 client_geometry_hints(client_t *c, area_t geometry)
627 int32_t basew, baseh, minw, minh;
629 /* base size is substituted with min size if not specified */
630 if(c->size_hints.flags & XCB_SIZE_HINT_P_SIZE)
632 basew = c->size_hints.base_width;
633 baseh = c->size_hints.base_height;
635 else if(c->size_hints.flags & XCB_SIZE_HINT_P_MIN_SIZE)
637 basew = c->size_hints.min_width;
638 baseh = c->size_hints.min_height;
640 else
641 basew = baseh = 0;
643 /* min size is substituted with base size if not specified */
644 if(c->size_hints.flags & XCB_SIZE_HINT_P_MIN_SIZE)
646 minw = c->size_hints.min_width;
647 minh = c->size_hints.min_height;
649 else if(c->size_hints.flags & XCB_SIZE_HINT_P_SIZE)
651 minw = c->size_hints.base_width;
652 minh = c->size_hints.base_height;
654 else
655 minw = minh = 0;
657 if(c->size_hints.flags & XCB_SIZE_HINT_P_ASPECT
658 && c->size_hints.min_aspect_num > 0
659 && c->size_hints.min_aspect_den > 0
660 && geometry.height - baseh > 0
661 && geometry.width - basew > 0)
663 double dx = (double) (geometry.width - basew);
664 double dy = (double) (geometry.height - baseh);
665 double min = (double) c->size_hints.min_aspect_num / (double) c->size_hints.min_aspect_den;
666 double max = (double) c->size_hints.max_aspect_num / (double) c->size_hints.min_aspect_den;
667 double ratio = dx / dy;
668 if(max > 0 && min > 0 && ratio > 0)
670 if(ratio < min)
672 dy = (dx * min + dy) / (min * min + 1);
673 dx = dy * min;
674 geometry.width = (int) dx + basew;
675 geometry.height = (int) dy + baseh;
677 else if(ratio > max)
679 dy = (dx * min + dy) / (max * max + 1);
680 dx = dy * min;
681 geometry.width = (int) dx + basew;
682 geometry.height = (int) dy + baseh;
687 if(minw)
688 geometry.width = MAX(geometry.width, minw);
689 if(minh)
690 geometry.height = MAX(geometry.height, minh);
692 if(c->size_hints.flags & XCB_SIZE_HINT_P_MAX_SIZE)
694 if(c->size_hints.max_width)
695 geometry.width = MIN(geometry.width, c->size_hints.max_width);
696 if(c->size_hints.max_height)
697 geometry.height = MIN(geometry.height, c->size_hints.max_height);
700 if(c->size_hints.flags & (XCB_SIZE_HINT_P_RESIZE_INC | XCB_SIZE_HINT_BASE_SIZE)
701 && c->size_hints.width_inc && c->size_hints.height_inc)
703 uint16_t t1 = geometry.width, t2 = geometry.height;
704 unsigned_subtract(t1, basew);
705 unsigned_subtract(t2, baseh);
706 geometry.width -= t1 % c->size_hints.width_inc;
707 geometry.height -= t2 % c->size_hints.height_inc;
710 return geometry;
713 /** Resize client window.
714 * The sizse given as parameters are with titlebar and borders!
715 * \param c Client to resize.
716 * \param geometry New window geometry.
717 * \param hints Use size hints.
718 * \return true if an actual resize occurred.
720 bool
721 client_resize(client_t *c, area_t geometry, bool hints)
723 area_t geometry_internal;
724 area_t area;
726 /* offscreen appearance fixes */
727 area = display_area_get(c->phys_screen);
729 if(geometry.x > area.width)
730 geometry.x = area.width - geometry.width;
731 if(geometry.y > area.height)
732 geometry.y = area.height - geometry.height;
733 if(geometry.x + geometry.width < 0)
734 geometry.x = 0;
735 if(geometry.y + geometry.height < 0)
736 geometry.y = 0;
738 /* Real client geometry, please keep it contained to C code at the very least. */
739 geometry_internal = titlebar_geometry_remove(c->titlebar, c->border, geometry);
741 if(hints)
742 geometry_internal = client_geometry_hints(c, geometry_internal);
744 if(geometry_internal.width == 0 || geometry_internal.height == 0)
745 return false;
747 /* Also let client hints propegate to the "official" geometry. */
748 geometry = titlebar_geometry_add(c->titlebar, c->border, geometry_internal);
750 if(c->geometries.internal.x != geometry_internal.x
751 || c->geometries.internal.y != geometry_internal.y
752 || c->geometries.internal.width != geometry_internal.width
753 || c->geometries.internal.height != geometry_internal.height)
755 screen_t *new_screen = screen_getbycoord(c->screen,
756 geometry_internal.x, geometry_internal.y);
758 /* Values to configure a window is an array where values are
759 * stored according to 'value_mask' */
760 uint32_t values[4];
762 c->geometries.internal.x = values[0] = geometry_internal.x;
763 c->geometries.internal.y = values[1] = geometry_internal.y;
764 c->geometries.internal.width = values[2] = geometry_internal.width;
765 c->geometries.internal.height = values[3] = geometry_internal.height;
767 /* Also store geometry including border and titlebar. */
768 c->geometry = geometry;
770 titlebar_update_geometry(c);
772 /* Ignore all spurious enter/leave notify events */
773 client_ignore_enterleave_events();
775 xcb_configure_window(globalconf.connection, c->win,
776 XCB_CONFIG_WINDOW_X | XCB_CONFIG_WINDOW_Y
777 | XCB_CONFIG_WINDOW_WIDTH | XCB_CONFIG_WINDOW_HEIGHT,
778 values);
780 client_restore_enterleave_events();
782 screen_client_moveto(c, new_screen, true, false);
784 /* execute hook */
785 hook_property(client, c, "geometry");
787 return true;
790 return false;
793 /** Set a client minimized, or not.
794 * \param c The client.
795 * \param s Set or not the client minimized.
797 void
798 client_setminimized(client_t *c, bool s)
800 if(c->isminimized != s)
802 client_need_reban(c);
803 c->isminimized = s;
804 client_need_reban(c);
805 if(s)
806 window_state_set(c->win, XCB_WM_STATE_ICONIC);
807 else
808 window_state_set(c->win, XCB_WM_STATE_NORMAL);
809 ewmh_client_update_hints(c);
810 /* execute hook */
811 hook_property(client, c, "minimized");
815 /** Set a client sticky, or not.
816 * \param c The client.
817 * \param s Set or not the client sticky.
819 void
820 client_setsticky(client_t *c, bool s)
822 if(c->issticky != s)
824 client_need_reban(c);
825 c->issticky = s;
826 client_need_reban(c);
827 ewmh_client_update_hints(c);
828 hook_property(client, c, "sticky");
832 /** Set a client fullscreen, or not.
833 * \param c The client.
834 * \param s Set or not the client fullscreen.
836 void
837 client_setfullscreen(client_t *c, bool s)
839 if(c->isfullscreen != s)
841 area_t geometry;
843 /* Make sure the current geometry is stored without titlebar. */
844 if(s)
845 titlebar_ban(c->titlebar);
847 /* become fullscreen! */
848 if((c->isfullscreen = s))
850 /* remove any max state */
851 client_setmaxhoriz(c, false);
852 client_setmaxvert(c, false);
853 /* You can only be part of one of the special layers. */
854 client_setbelow(c, false);
855 client_setabove(c, false);
856 client_setontop(c, false);
858 geometry = screen_area_get(c->screen, false);
859 c->geometries.fullscreen = c->geometry;
860 c->border_fs = c->border;
861 client_setborder(c, 0);
863 else
865 geometry = c->geometries.fullscreen;
866 client_setborder(c, c->border_fs);
868 client_resize(c, geometry, false);
869 client_stack();
870 ewmh_client_update_hints(c);
871 hook_property(client, c, "fullscreen");
875 /** Set a client horizontally maximized.
876 * \param c The client.
877 * \param s The maximized status.
879 void
880 client_setmaxhoriz(client_t *c, bool s)
882 if(c->ismaxhoriz != s)
884 area_t geometry;
886 if((c->ismaxhoriz = s))
888 /* remove fullscreen mode */
889 client_setfullscreen(c, false);
891 geometry = screen_area_get(c->screen, true);
892 geometry.y = c->geometry.y;
893 geometry.height = c->geometry.height;
894 c->geometries.max.x = c->geometry.x;
895 c->geometries.max.width = c->geometry.width;
897 else
899 geometry = c->geometry;
900 geometry.x = c->geometries.max.x;
901 geometry.width = c->geometries.max.width;
904 client_resize(c, geometry, c->size_hints_honor);
905 client_stack();
906 ewmh_client_update_hints(c);
907 hook_property(client, c, "maximized_horizontal");
911 /** Set a client vertically maximized.
912 * \param c The client.
913 * \param s The maximized status.
915 void
916 client_setmaxvert(client_t *c, bool s)
918 if(c->ismaxvert != s)
920 area_t geometry;
922 if((c->ismaxvert = s))
924 /* remove fullscreen mode */
925 client_setfullscreen(c, false);
927 geometry = screen_area_get(c->screen, true);
928 geometry.x = c->geometry.x;
929 geometry.width = c->geometry.width;
930 c->geometries.max.y = c->geometry.y;
931 c->geometries.max.height = c->geometry.height;
933 else
935 geometry = c->geometry;
936 geometry.y = c->geometries.max.y;
937 geometry.height = c->geometries.max.height;
940 client_resize(c, geometry, c->size_hints_honor);
941 client_stack();
942 ewmh_client_update_hints(c);
943 hook_property(client, c, "maximized_vertical");
947 /** Set a client above, or not.
948 * \param c The client.
949 * \param s Set or not the client above.
951 void
952 client_setabove(client_t *c, bool s)
954 if(c->isabove != s)
956 /* You can only be part of one of the special layers. */
957 if(s)
959 client_setbelow(c, false);
960 client_setontop(c, false);
961 client_setfullscreen(c, false);
963 c->isabove = s;
964 client_stack();
965 ewmh_client_update_hints(c);
966 /* execute hook */
967 hook_property(client, c, "above");
971 /** Set a client below, or not.
972 * \param c The client.
973 * \param s Set or not the client below.
975 void
976 client_setbelow(client_t *c, bool s)
978 if(c->isbelow != s)
980 /* You can only be part of one of the special layers. */
981 if(s)
983 client_setabove(c, false);
984 client_setontop(c, false);
985 client_setfullscreen(c, false);
987 c->isbelow = s;
988 client_stack();
989 ewmh_client_update_hints(c);
990 /* execute hook */
991 hook_property(client, c, "below");
995 /** Set a client modal, or not.
996 * \param c The client.
997 * \param s Set or not the client moda.
999 void
1000 client_setmodal(client_t *c, bool s)
1002 if(c->ismodal != s)
1004 c->ismodal = s;
1005 client_stack();
1006 ewmh_client_update_hints(c);
1007 /* execute hook */
1008 hook_property(client, c, "modal");
1012 /** Set a client ontop, or not.
1013 * \param c The client.
1014 * \param s Set or not the client moda.
1016 void
1017 client_setontop(client_t *c, bool s)
1019 if(c->isontop != s)
1021 /* You can only be part of one of the special layers. */
1022 if(s)
1024 client_setabove(c, false);
1025 client_setbelow(c, false);
1026 client_setfullscreen(c, false);
1028 c->isontop = s;
1029 client_stack();
1030 /* execute hook */
1031 hook_property(client, c, "ontop");
1035 /** Unban a client and move it back into the viewport.
1036 * \param c The client.
1038 void
1039 client_unban(client_t *c)
1041 if(c->isbanned)
1043 xcb_map_window(globalconf.connection, c->win);
1045 c->isbanned = false;
1049 /** Unmanage a client.
1050 * \param c The client.
1052 void
1053 client_unmanage(client_t *c)
1055 tag_array_t *tags = &c->screen->tags;
1057 /* Reset transient_for attributes of widows that maybe refering to us */
1058 foreach(_tc, globalconf.clients)
1060 client_t *tc = *_tc;
1061 if(tc->transient_for == c)
1062 tc->transient_for = NULL;
1065 if(globalconf.screens.tab[c->phys_screen].prev_client_focus == c)
1066 globalconf.screens.tab[c->phys_screen].prev_client_focus = NULL;
1068 if(globalconf.screens.tab[c->phys_screen].client_focus == c)
1069 client_unfocus(c);
1071 /* remove client from global list and everywhere else */
1072 foreach(elem, globalconf.clients)
1073 if(*elem == c)
1075 client_array_remove(&globalconf.clients, elem);
1076 break;
1078 stack_client_remove(c);
1079 for(int i = 0; i < tags->len; i++)
1080 untag_client(c, tags->tab[i]);
1082 /* call hook */
1083 if(globalconf.hooks.unmanage != LUA_REFNIL)
1085 client_push(globalconf.L, c);
1086 luaA_dofunction_from_registry(globalconf.L, globalconf.hooks.unmanage, 1, 0);
1089 /* Call hook to notify list change */
1090 if(globalconf.hooks.clients != LUA_REFNIL)
1091 luaA_dofunction_from_registry(globalconf.L, globalconf.hooks.clients, 0, 0);
1093 window_state_set(c->win, XCB_WM_STATE_WITHDRAWN);
1095 titlebar_client_detach(c);
1097 ewmh_update_net_client_list(c->phys_screen);
1099 /* set client as invalid */
1100 c->invalid = true;
1102 client_unref(globalconf.L, c);
1105 /** Kill a client via a WM_DELETE_WINDOW request or KillClient if not
1106 * supported.
1107 * \param c The client to kill.
1109 void
1110 client_kill(client_t *c)
1112 if(client_hasproto(c, WM_DELETE_WINDOW))
1114 xcb_client_message_event_t ev;
1116 /* Initialize all of event's fields first */
1117 p_clear(&ev, 1);
1119 ev.response_type = XCB_CLIENT_MESSAGE;
1120 ev.window = c->win;
1121 ev.format = 32;
1122 ev.data.data32[1] = XCB_CURRENT_TIME;
1123 ev.type = WM_PROTOCOLS;
1124 ev.data.data32[0] = WM_DELETE_WINDOW;
1126 xcb_send_event(globalconf.connection, false, c->win,
1127 XCB_EVENT_MASK_NO_EVENT, (char *) &ev);
1129 else
1130 xcb_kill_client(globalconf.connection, c->win);
1133 /** Get all clients into a table.
1134 * \param L The Lua VM state.
1135 * \return The number of elements pushed on stack.
1136 * \luastack
1137 * \lparam An optional screen nunmber.
1138 * \lreturn A table with all clients.
1140 static int
1141 luaA_client_get(lua_State *L)
1143 int i = 1, screen;
1145 screen = luaL_optnumber(L, 1, 0) - 1;
1147 lua_newtable(L);
1149 if(screen == -1)
1150 foreach(c, globalconf.clients)
1152 client_push(L, *c);
1153 lua_rawseti(L, -2, i++);
1155 else
1157 luaA_checkscreen(screen);
1158 foreach(c, globalconf.clients)
1159 if((*c)->screen == &globalconf.screens.tab[screen])
1161 client_push(L, *c);
1162 lua_rawseti(L, -2, i++);
1166 return 1;
1169 /** Check if a client is visible on its screen.
1170 * \param L The Lua VM state.
1171 * \return The number of elements pushed on stack.
1172 * \luastack
1173 * \lvalue A client.
1174 * \lreturn A boolean value, true if the client is visible, false otherwise.
1176 static int
1177 luaA_client_isvisible(lua_State *L)
1179 client_t *c = luaA_client_checkudata(L, 1);
1180 lua_pushboolean(L, client_isvisible(c, c->screen));
1181 return 1;
1184 /** Set client border width.
1185 * \param c The client.
1186 * \param width The border width.
1188 void
1189 client_setborder(client_t *c, int width)
1191 uint32_t w = width;
1193 if(width > 0 && (c->type == WINDOW_TYPE_DOCK
1194 || c->type == WINDOW_TYPE_SPLASH
1195 || c->type == WINDOW_TYPE_DESKTOP
1196 || c->isfullscreen))
1197 return;
1199 if(width == c->border || width < 0)
1200 return;
1202 /* Update geometry with the new border. */
1203 c->geometry.width -= 2 * c->border;
1204 c->geometry.height -= 2 * c->border;
1206 c->border = width;
1207 xcb_configure_window(globalconf.connection, c->win,
1208 XCB_CONFIG_WINDOW_BORDER_WIDTH, &w);
1210 c->geometry.width += 2 * c->border;
1211 c->geometry.height += 2 * c->border;
1213 /* Changing border size also affects the size of the titlebar. */
1214 titlebar_update_geometry(c);
1216 hook_property(client, c, "border_width");
1219 /** Kill a client.
1220 * \param L The Lua VM state.
1222 * \luastack
1223 * \lvalue A client.
1225 static int
1226 luaA_client_kill(lua_State *L)
1228 client_t *c = luaA_client_checkudata(L, 1);
1229 client_kill(c);
1230 return 0;
1233 /** Swap a client with another one.
1234 * \param L The Lua VM state.
1235 * \luastack
1236 * \lvalue A client.
1237 * \lparam A client to swap with.
1239 static int
1240 luaA_client_swap(lua_State *L)
1242 client_t *c = luaA_client_checkudata(L, 1);
1243 client_t *swap = luaA_client_checkudata(L, 2);
1245 if(c != swap)
1247 client_t **ref_c = NULL, **ref_swap = NULL;
1248 foreach(item, globalconf.clients)
1250 if(*item == c)
1251 ref_c = item;
1252 else if(*item == swap)
1253 ref_swap = item;
1254 if(ref_c && ref_swap)
1255 break;
1257 /* swap ! */
1258 *ref_c = swap;
1259 *ref_swap = c;
1261 /* Call hook to notify list change */
1262 if(globalconf.hooks.clients != LUA_REFNIL)
1263 luaA_dofunction_from_registry(L, globalconf.hooks.clients, 0, 0);
1266 return 0;
1269 /** Access or set the client tags.
1270 * \param L The Lua VM state.
1271 * \return The number of elements pushed on stack.
1272 * \lparam A table with tags to set, or none to get the current tags table.
1273 * \return The clients tag.
1275 static int
1276 luaA_client_tags(lua_State *L)
1278 client_t *c = luaA_client_checkudata(L, 1);
1279 tag_array_t *tags = &c->screen->tags;
1280 int j = 0;
1282 if(lua_gettop(L) == 2)
1284 luaA_checktable(L, 2);
1285 for(int i = 0; i < tags->len; i++)
1286 untag_client(c, tags->tab[i]);
1287 lua_pushnil(L);
1288 while(lua_next(L, 2))
1289 tag_client(c);
1290 lua_pop(L, 1);
1293 lua_newtable(L);
1294 foreach(tag, *tags)
1295 if(is_client_tagged(c, *tag))
1297 tag_push(L, *tag);
1298 lua_rawseti(L, -2, ++j);
1301 return 1;
1304 /** Raise a client on top of others which are on the same layer.
1305 * \param L The Lua VM state.
1306 * \luastack
1307 * \lvalue A client.
1309 static int
1310 luaA_client_raise(lua_State *L)
1312 client_t *c = luaA_client_checkudata(L, 1);
1313 client_raise(c);
1314 return 0;
1317 /** Lower a client on bottom of others which are on the same layer.
1318 * \param L The Lua VM state.
1319 * \luastack
1320 * \lvalue A client.
1322 static int
1323 luaA_client_lower(lua_State *L)
1325 client_t *c = luaA_client_checkudata(L, 1);
1326 client_lower(c);
1327 return 0;
1330 /** Redraw a client by unmapping and mapping it quickly.
1331 * \param L The Lua VM state.
1333 * \luastack
1334 * \lvalue A client.
1336 static int
1337 luaA_client_redraw(lua_State *L)
1339 client_t *c = luaA_client_checkudata(L, 1);
1341 xcb_unmap_window(globalconf.connection, c->win);
1342 xcb_map_window(globalconf.connection, c->win);
1344 /* Set the focus on the current window if the redraw has been
1345 performed on the window where the pointer is currently on
1346 because after the unmapping/mapping, the focus is lost */
1347 if(globalconf.screen_focus->client_focus == c)
1349 client_unfocus(c);
1350 client_focus(c);
1353 return 0;
1356 /** Stop managing a client.
1357 * \param L The Lua VM state.
1358 * \return The number of elements pushed on stack.
1359 * \luastack
1360 * \lvalue A client.
1362 static int
1363 luaA_client_unmanage(lua_State *L)
1365 client_t *c = luaA_client_checkudata(L, 1);
1366 client_unmanage(c);
1367 return 0;
1370 /** Return client geometry.
1371 * \param L The Lua VM state.
1372 * \return The number of elements pushed on stack.
1373 * \luastack
1374 * \lparam A table with new coordinates, or none.
1375 * \lreturn A table with client coordinates.
1377 static int
1378 luaA_client_geometry(lua_State *L)
1380 client_t *c = luaA_client_checkudata(L, 1);
1382 if(lua_gettop(L) == 2)
1384 area_t geometry;
1386 luaA_checktable(L, 2);
1387 geometry.x = luaA_getopt_number(L, 2, "x", c->geometry.x);
1388 geometry.y = luaA_getopt_number(L, 2, "y", c->geometry.y);
1389 if(client_isfixed(c))
1391 geometry.width = c->geometry.width;
1392 geometry.height = c->geometry.height;
1394 else
1396 geometry.width = luaA_getopt_number(L, 2, "width", c->geometry.width);
1397 geometry.height = luaA_getopt_number(L, 2, "height", c->geometry.height);
1400 client_resize(c, geometry, c->size_hints_honor);
1403 return luaA_pusharea(L, c->geometry);
1406 /** Push a strut type to a table on stack.
1407 * \param L The Lua VM state.
1408 * \param struts The struts to push.
1409 * \return The number of elements pushed on stack.
1411 static inline int
1412 luaA_pushstruts(lua_State *L, strut_t struts)
1414 lua_createtable(L, 4, 0);
1415 lua_pushnumber(L, struts.left);
1416 lua_setfield(L, -2, "left");
1417 lua_pushnumber(L, struts.right);
1418 lua_setfield(L, -2, "right");
1419 lua_pushnumber(L, struts.top);
1420 lua_setfield(L, -2, "top");
1421 lua_pushnumber(L, struts.bottom);
1422 lua_setfield(L, -2, "bottom");
1423 return 1;
1426 /** Return client struts (reserved space at the edge of the screen).
1427 * \param L The Lua VM state.
1428 * \return The number of elements pushed on stack.
1429 * \luastack
1430 * \lparam A table with new strut values, or none.
1431 * \lreturn A table with strut values.
1433 static int
1434 luaA_client_struts(lua_State *L)
1436 client_t *c = luaA_client_checkudata(L, 1);
1438 if(lua_gettop(L) == 2)
1440 strut_t struts;
1441 area_t screen_area = display_area_get(c->phys_screen);
1443 struts.left = luaA_getopt_number(L, 2, "left", c->strut.left);
1444 struts.right = luaA_getopt_number(L, 2, "right", c->strut.right);
1445 struts.top = luaA_getopt_number(L, 2, "top", c->strut.top);
1446 struts.bottom = luaA_getopt_number(L, 2, "bottom", c->strut.bottom);
1448 if(struts.left != c->strut.left || struts.right != c->strut.right ||
1449 struts.top != c->strut.top || struts.bottom != c->strut.bottom) {
1450 /* Struts are not so well defined in the context of xinerama. So we just
1451 * give the entire root window and let the window manager decide. */
1452 struts.left_start_y = 0;
1453 struts.left_end_y = !struts.left ? 0 : screen_area.height;
1454 struts.right_start_y = 0;
1455 struts.right_end_y = !struts.right ? 0 : screen_area.height;
1456 struts.top_start_x = 0;
1457 struts.top_end_x = !struts.top ? 0 : screen_area.width;
1458 struts.bottom_start_x = 0;
1459 struts.bottom_end_x = !struts.bottom ? 0 : screen_area.width;
1461 c->strut = struts;
1463 ewmh_update_client_strut(c);
1465 hook_property(client, c, "struts");
1469 return luaA_pushstruts(L, c->strut);
1472 /** Client newindex.
1473 * \param L The Lua VM state.
1474 * \return The number of elements pushed on stack.
1476 static int
1477 luaA_client_newindex(lua_State *L)
1479 size_t len;
1480 client_t *c = luaA_client_checkudata(L, 1);
1481 const char *buf = luaL_checklstring(L, 2, &len);
1482 bool b;
1483 double d;
1484 int i;
1486 switch(a_tokenize(buf, len))
1488 case A_TK_SCREEN:
1489 if(globalconf.xinerama_is_active)
1491 i = luaL_checknumber(L, 3) - 1;
1492 luaA_checkscreen(i);
1493 screen_client_moveto(c, &globalconf.screens.tab[i], true, true);
1495 break;
1496 case A_TK_HIDE:
1497 b = luaA_checkboolean(L, 3);
1498 if(b != c->ishidden)
1500 client_need_reban(c);
1501 c->ishidden = b;
1502 client_need_reban(c);
1503 hook_property(client, c, "hide");
1505 break;
1506 case A_TK_MINIMIZED:
1507 client_setminimized(c, luaA_checkboolean(L, 3));
1508 break;
1509 case A_TK_FULLSCREEN:
1510 client_setfullscreen(c, luaA_checkboolean(L, 3));
1511 break;
1512 case A_TK_MAXIMIZED_HORIZONTAL:
1513 client_setmaxhoriz(c, luaA_checkboolean(L, 3));
1514 break;
1515 case A_TK_MAXIMIZED_VERTICAL:
1516 client_setmaxvert(c, luaA_checkboolean(L, 3));
1517 break;
1518 case A_TK_ICON:
1519 luaA_object_unref_item(L, 1, c->icon);
1520 c->icon = NULL;
1521 c->icon = luaA_object_ref_item(L, 1, 3);
1522 /* execute hook */
1523 hook_property(client, c, "icon");
1524 break;
1525 case A_TK_OPACITY:
1526 if(lua_isnil(L, 3))
1528 window_opacity_set(c->win, -1);
1529 c->opacity = -1;
1531 else
1533 d = luaL_checknumber(L, 3);
1534 if(d >= 0 && d <= 1)
1536 window_opacity_set(c->win, d);
1537 c->opacity = d;
1540 break;
1541 case A_TK_STICKY:
1542 client_setsticky(c, luaA_checkboolean(L, 3));
1543 break;
1544 case A_TK_SIZE_HINTS_HONOR:
1545 c->size_hints_honor = luaA_checkboolean(L, 3);
1546 hook_property(client, c, "size_hints_honor");
1547 break;
1548 case A_TK_BORDER_WIDTH:
1549 client_setborder(c, luaL_checknumber(L, 3));
1550 break;
1551 case A_TK_ONTOP:
1552 client_setontop(c, luaA_checkboolean(L, 3));
1553 break;
1554 case A_TK_ABOVE:
1555 client_setabove(c, luaA_checkboolean(L, 3));
1556 break;
1557 case A_TK_BELOW:
1558 client_setbelow(c, luaA_checkboolean(L, 3));
1559 break;
1560 case A_TK_URGENT:
1561 client_seturgent(c, luaA_checkboolean(L, 3));
1562 break;
1563 case A_TK_BORDER_COLOR:
1564 if((buf = luaL_checklstring(L, 3, &len))
1565 && xcolor_init_reply(xcolor_init_unchecked(&c->border_color, buf, len)))
1566 xcb_change_window_attributes(globalconf.connection, c->win,
1567 XCB_CW_BORDER_PIXEL, &c->border_color.pixel);
1568 break;
1569 case A_TK_TITLEBAR:
1570 if(lua_isnil(L, 3))
1571 titlebar_client_detach(c);
1572 else
1573 titlebar_client_attach(c);
1574 break;
1575 case A_TK_SKIP_TASKBAR:
1576 c->skiptb = luaA_checkboolean(L, 3);
1577 hook_property(client, c, "skip_taskbar");
1578 break;
1579 default:
1580 return 0;
1583 return 0;
1586 /** Client object.
1587 * \param L The Lua VM state.
1588 * \return The number of elements pushed on stack.
1589 * \luastack
1590 * \lfield id The window X id.
1591 * \lfield name The client title.
1592 * \lfield skip_taskbar If true the client won't be shown in the tasklist.
1593 * \lfield type The window type (desktop, normal, dock, …).
1594 * \lfield class The client class.
1595 * \lfield instance The client instance.
1596 * \lfield pid The client PID, if available.
1597 * \lfield role The window role, if available.
1598 * \lfield machine The machine client is running on.
1599 * \lfield icon_name The client name when iconified.
1600 * \lfield screen Client screen number.
1601 * \lfield hide Define if the client must be hidden, i.e. never mapped,
1602 * invisible in taskbar.
1603 * \lfield minimized Define it the client must be iconify, i.e. only visible in
1604 * taskbar.
1605 * \lfield size_hints_honor Honor size hints, i.e. respect size ratio.
1606 * \lfield border_width The client border width.
1607 * \lfield border_color The client border color.
1608 * \lfield titlebar The client titlebar.
1609 * \lfield urgent The client urgent state.
1610 * \lfield content An image representing the client window content (screenshot).
1611 * \lfield focus The focused client.
1612 * \lfield opacity The client opacity between 0 and 1.
1613 * \lfield ontop The client is on top of every other windows.
1614 * \lfield above The client is above normal windows.
1615 * \lfield below The client is below normal windows.
1616 * \lfield fullscreen The client is fullscreen or not.
1617 * \lfield maximized_horizontal The client is maximized horizontally or not.
1618 * \lfield maximized_vertical The client is maximized vertically or not.
1619 * \lfield transient_for Return the client the window is transient for.
1620 * \lfield group_id Identification unique to a group of windows.
1621 * \lfield leader_id Identification unique to windows spawned by the same command.
1622 * \lfield size_hints A table with size hints of the client: user_position,
1623 * user_size, program_position, program_size, etc.
1625 static int
1626 luaA_client_index(lua_State *L)
1628 size_t len;
1629 client_t *c = luaA_client_checkudata(L, 1);
1630 const char *buf = luaL_checklstring(L, 2, &len);
1632 if(luaA_usemetatable(L, 1, 2))
1633 return 1;
1635 switch(a_tokenize(buf, len))
1637 case A_TK_NAME:
1638 lua_pushstring(L, c->name);
1639 break;
1640 case A_TK_TRANSIENT_FOR:
1641 return client_push(globalconf.L, c->transient_for);
1642 case A_TK_SKIP_TASKBAR:
1643 lua_pushboolean(L, c->skiptb);
1644 break;
1645 case A_TK_CONTENT:
1646 return client_getcontent(c);
1647 case A_TK_TYPE:
1648 switch(c->type)
1650 case WINDOW_TYPE_DESKTOP:
1651 lua_pushliteral(L, "desktop");
1652 break;
1653 case WINDOW_TYPE_DOCK:
1654 lua_pushliteral(L, "dock");
1655 break;
1656 case WINDOW_TYPE_SPLASH:
1657 lua_pushliteral(L, "splash");
1658 break;
1659 case WINDOW_TYPE_DIALOG:
1660 lua_pushliteral(L, "dialog");
1661 break;
1662 case WINDOW_TYPE_MENU:
1663 lua_pushliteral(L, "menu");
1664 break;
1665 case WINDOW_TYPE_TOOLBAR:
1666 lua_pushliteral(L, "toolbar");
1667 break;
1668 case WINDOW_TYPE_UTILITY:
1669 lua_pushliteral(L, "utility");
1670 break;
1671 case WINDOW_TYPE_DROPDOWN_MENU:
1672 lua_pushliteral(L, "dropdown_menu");
1673 break;
1674 case WINDOW_TYPE_POPUP_MENU:
1675 lua_pushliteral(L, "popup_menu");
1676 break;
1677 case WINDOW_TYPE_TOOLTIP:
1678 lua_pushliteral(L, "tooltip");
1679 break;
1680 case WINDOW_TYPE_NOTIFICATION:
1681 lua_pushliteral(L, "notification");
1682 break;
1683 case WINDOW_TYPE_COMBO:
1684 lua_pushliteral(L, "combo");
1685 break;
1686 case WINDOW_TYPE_DND:
1687 lua_pushliteral(L, "dnd");
1688 break;
1689 case WINDOW_TYPE_NORMAL:
1690 lua_pushliteral(L, "normal");
1691 break;
1693 break;
1694 case A_TK_CLASS:
1695 lua_pushstring(L, c->class);
1696 break;
1697 case A_TK_INSTANCE:
1698 lua_pushstring(L, c->instance);
1699 break;
1700 case A_TK_ROLE:
1701 lua_pushstring(L, c->role);
1702 break;
1703 case A_TK_PID:
1704 lua_pushnumber(L, c->pid);
1705 break;
1706 case A_TK_ID:
1707 lua_pushnumber(L, c->win);
1708 break;
1709 case A_TK_LEADER_ID:
1710 lua_pushnumber(L, c->leader_win);
1711 break;
1712 case A_TK_MACHINE:
1713 lua_pushstring(L, c->machine);
1714 break;
1715 case A_TK_ICON_NAME:
1716 lua_pushstring(L, c->icon_name);
1717 break;
1718 case A_TK_SCREEN:
1719 lua_pushnumber(L, 1 + screen_array_indexof(&globalconf.screens, c->screen));
1720 break;
1721 case A_TK_HIDE:
1722 lua_pushboolean(L, c->ishidden);
1723 break;
1724 case A_TK_MINIMIZED:
1725 lua_pushboolean(L, c->isminimized);
1726 break;
1727 case A_TK_FULLSCREEN:
1728 lua_pushboolean(L, c->isfullscreen);
1729 break;
1730 case A_TK_GROUP_ID:
1731 if(c->group_win)
1732 lua_pushnumber(L, c->group_win);
1733 else
1734 return 0;
1735 break;
1736 case A_TK_MAXIMIZED_HORIZONTAL:
1737 lua_pushboolean(L, c->ismaxhoriz);
1738 break;
1739 case A_TK_MAXIMIZED_VERTICAL:
1740 lua_pushboolean(L, c->ismaxvert);
1741 break;
1742 case A_TK_ICON:
1743 luaA_object_push_item(L, 1, c->icon);
1744 break;
1745 case A_TK_OPACITY:
1746 lua_pushnumber(L, c->opacity);
1747 break;
1748 case A_TK_ONTOP:
1749 lua_pushboolean(L, c->isontop);
1750 break;
1751 case A_TK_ABOVE:
1752 lua_pushboolean(L, c->isabove);
1753 break;
1754 case A_TK_BELOW:
1755 lua_pushboolean(L, c->isbelow);
1756 break;
1757 case A_TK_STICKY:
1758 lua_pushboolean(L, c->issticky);
1759 break;
1760 case A_TK_SIZE_HINTS_HONOR:
1761 lua_pushboolean(L, c->size_hints_honor);
1762 break;
1763 case A_TK_BORDER_WIDTH:
1764 lua_pushnumber(L, c->border);
1765 break;
1766 case A_TK_BORDER_COLOR:
1767 luaA_pushxcolor(L, c->border_color);
1768 break;
1769 case A_TK_TITLEBAR:
1770 return wibox_push(L, c->titlebar);
1771 case A_TK_URGENT:
1772 lua_pushboolean(L, c->isurgent);
1773 break;
1774 case A_TK_SIZE_HINTS:
1776 const char *u_or_p = NULL;
1778 lua_createtable(L, 0, 1);
1780 if(c->size_hints.flags & XCB_SIZE_HINT_US_POSITION)
1781 u_or_p = "user_position";
1782 else if(c->size_hints.flags & XCB_SIZE_HINT_P_POSITION)
1783 u_or_p = "program_position";
1785 if(u_or_p)
1787 lua_createtable(L, 0, 2);
1788 lua_pushnumber(L, c->size_hints.x);
1789 lua_setfield(L, -2, "x");
1790 lua_pushnumber(L, c->size_hints.y);
1791 lua_setfield(L, -2, "y");
1792 lua_setfield(L, -2, u_or_p);
1793 u_or_p = NULL;
1796 if(c->size_hints.flags & XCB_SIZE_HINT_US_SIZE)
1797 u_or_p = "user_size";
1798 else if(c->size_hints.flags & XCB_SIZE_HINT_P_SIZE)
1799 u_or_p = "program_size";
1801 if(u_or_p)
1803 lua_createtable(L, 0, 2);
1804 lua_pushnumber(L, c->size_hints.width);
1805 lua_setfield(L, -2, "width");
1806 lua_pushnumber(L, c->size_hints.height);
1807 lua_setfield(L, -2, "height");
1808 lua_setfield(L, -2, u_or_p);
1811 if(c->size_hints.flags & XCB_SIZE_HINT_P_MIN_SIZE)
1813 lua_pushnumber(L, c->size_hints.min_width);
1814 lua_setfield(L, -2, "min_width");
1815 lua_pushnumber(L, c->size_hints.min_height);
1816 lua_setfield(L, -2, "min_height");
1819 if(c->size_hints.flags & XCB_SIZE_HINT_P_MAX_SIZE)
1821 lua_pushnumber(L, c->size_hints.max_width);
1822 lua_setfield(L, -2, "max_width");
1823 lua_pushnumber(L, c->size_hints.max_height);
1824 lua_setfield(L, -2, "max_height");
1827 if(c->size_hints.flags & XCB_SIZE_HINT_P_RESIZE_INC)
1829 lua_pushnumber(L, c->size_hints.width_inc);
1830 lua_setfield(L, -2, "width_inc");
1831 lua_pushnumber(L, c->size_hints.height_inc);
1832 lua_setfield(L, -2, "height_inc");
1835 if(c->size_hints.flags & XCB_SIZE_HINT_P_ASPECT)
1837 lua_pushnumber(L, c->size_hints.min_aspect_num);
1838 lua_setfield(L, -2, "min_aspect_num");
1839 lua_pushnumber(L, c->size_hints.min_aspect_den);
1840 lua_setfield(L, -2, "min_aspect_den");
1841 lua_pushnumber(L, c->size_hints.max_aspect_num);
1842 lua_setfield(L, -2, "max_aspect_num");
1843 lua_pushnumber(L, c->size_hints.max_aspect_den);
1844 lua_setfield(L, -2, "max_aspect_den");
1847 if(c->size_hints.flags & XCB_SIZE_HINT_BASE_SIZE)
1849 lua_pushnumber(L, c->size_hints.base_width);
1850 lua_setfield(L, -2, "base_width");
1851 lua_pushnumber(L, c->size_hints.base_height);
1852 lua_setfield(L, -2, "base_height");
1855 if(c->size_hints.flags & XCB_SIZE_HINT_P_WIN_GRAVITY)
1857 switch(c->size_hints.win_gravity)
1859 default:
1860 lua_pushliteral(L, "north_west");
1861 break;
1862 case XCB_GRAVITY_NORTH:
1863 lua_pushliteral(L, "north");
1864 break;
1865 case XCB_GRAVITY_NORTH_EAST:
1866 lua_pushliteral(L, "north_east");
1867 break;
1868 case XCB_GRAVITY_WEST:
1869 lua_pushliteral(L, "west");
1870 break;
1871 case XCB_GRAVITY_CENTER:
1872 lua_pushliteral(L, "center");
1873 break;
1874 case XCB_GRAVITY_EAST:
1875 lua_pushliteral(L, "east");
1876 break;
1877 case XCB_GRAVITY_SOUTH_WEST:
1878 lua_pushliteral(L, "south_west");
1879 break;
1880 case XCB_GRAVITY_SOUTH:
1881 lua_pushliteral(L, "south");
1882 break;
1883 case XCB_GRAVITY_SOUTH_EAST:
1884 lua_pushliteral(L, "south_east");
1885 break;
1886 case XCB_GRAVITY_STATIC:
1887 lua_pushliteral(L, "static");
1888 break;
1890 lua_setfield(L, -2, "win_gravity");
1893 break;
1894 default:
1895 return 0;
1898 return 1;
1901 /** Get or set mouse buttons bindings for a client.
1902 * \param L The Lua VM state.
1903 * \return The number of element pushed on stack.
1904 * \luastack
1905 * \lvalue A client.
1906 * \lparam An array of mouse button bindings objects, or nothing.
1907 * \return The array of mouse button bindings objects of this client.
1909 static int
1910 luaA_client_buttons(lua_State *L)
1912 client_t *client = luaA_client_checkudata(L, 1);
1913 button_array_t *buttons = &client->buttons;
1915 if(lua_gettop(L) == 2)
1916 luaA_button_array_set(L, 1, 2, buttons);
1918 window_buttons_grab(client->win, &client->buttons);
1920 return luaA_button_array_get(L, 1, buttons);
1923 /** Get or set keys bindings for a client.
1924 * \param L The Lua VM state.
1925 * \return The number of element pushed on stack.
1926 * \luastack
1927 * \lvalue A client.
1928 * \lparam An array of key bindings objects, or nothing.
1929 * \return The array of key bindings objects of this client.
1931 static int
1932 luaA_client_keys(lua_State *L)
1934 client_t *c = luaA_client_checkudata(L, 1);
1935 key_array_t *keys = &c->keys;
1937 if(lua_gettop(L) == 2)
1939 luaA_key_array_set(L, 1, 2, keys);
1940 xcb_ungrab_key(globalconf.connection, XCB_GRAB_ANY, c->win, XCB_BUTTON_MASK_ANY);
1941 window_grabkeys(c->win, keys);
1944 return luaA_key_array_get(L, 1, keys);
1947 /* Client module.
1948 * \param L The Lua VM state.
1949 * \return The number of pushed elements.
1951 static int
1952 luaA_client_module_index(lua_State *L)
1954 size_t len;
1955 const char *buf = luaL_checklstring(L, 2, &len);
1957 switch(a_tokenize(buf, len))
1959 case A_TK_FOCUS:
1960 return client_push(globalconf.L, globalconf.screen_focus->client_focus);
1961 break;
1962 default:
1963 return 0;
1967 /* Client module new index.
1968 * \param L The Lua VM state.
1969 * \return The number of pushed elements.
1971 static int
1972 luaA_client_module_newindex(lua_State *L)
1974 size_t len;
1975 const char *buf = luaL_checklstring(L, 2, &len);
1976 client_t *c;
1978 switch(a_tokenize(buf, len))
1980 case A_TK_FOCUS:
1981 c = luaA_client_checkudata(L, 3);
1982 client_focus(c);
1983 break;
1984 default:
1985 break;
1988 return 0;
1991 const struct luaL_reg awesome_client_methods[] =
1993 LUA_CLASS_METHODS(client)
1994 { "get", luaA_client_get },
1995 { "__index", luaA_client_module_index },
1996 { "__newindex", luaA_client_module_newindex },
1997 { NULL, NULL }
1999 const struct luaL_reg awesome_client_meta[] =
2001 LUA_OBJECT_META(client)
2002 { "isvisible", luaA_client_isvisible },
2003 { "geometry", luaA_client_geometry },
2004 { "struts", luaA_client_struts },
2005 { "buttons", luaA_client_buttons },
2006 { "keys", luaA_client_keys },
2007 { "tags", luaA_client_tags },
2008 { "kill", luaA_client_kill },
2009 { "swap", luaA_client_swap },
2010 { "raise", luaA_client_raise },
2011 { "lower", luaA_client_lower },
2012 { "redraw", luaA_client_redraw },
2013 { "unmanage", luaA_client_unmanage },
2014 { "__index", luaA_client_index },
2015 { "__newindex", luaA_client_newindex },
2016 { "__gc", luaA_client_gc },
2017 { NULL, NULL }
2020 // vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80