2007-10-03 17:26:14 +02:00
|
|
|
/*
|
2007-09-12 14:29:51 +02:00
|
|
|
* client.h - client management header
|
2007-10-03 17:26:14 +02:00
|
|
|
*
|
2008-01-02 16:59:43 +01:00
|
|
|
* Copyright © 2007-2008 Julien Danjou <julien@danjou.info>
|
2007-10-03 17:26:14 +02: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.,
|
|
|
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
|
|
*
|
2007-09-12 14:29:51 +02:00
|
|
|
*/
|
2007-09-05 20:15:00 +02:00
|
|
|
|
2007-09-10 16:11:57 +02:00
|
|
|
#ifndef AWESOME_CLIENT_H
|
|
|
|
|
#define AWESOME_CLIENT_H
|
2007-09-05 20:15:00 +02:00
|
|
|
|
2008-03-21 16:50:17 +01:00
|
|
|
#include <xcb/xcb_icccm.h>
|
|
|
|
|
|
2008-01-13 15:44:01 +01:00
|
|
|
#include "structs.h"
|
2007-09-05 20:15:00 +02:00
|
|
|
|
2008-04-11 11:35:11 +02:00
|
|
|
bool client_isvisible(client_t *, int);
|
2008-06-05 09:25:38 +02:00
|
|
|
client_t * client_getbywin(xcb_window_t);
|
2008-06-26 23:42:51 +02:00
|
|
|
void client_focus(client_t *, int);
|
2008-06-25 22:26:53 +02:00
|
|
|
void client_setlayer(client_t *, layer_t);
|
2008-08-05 16:59:54 +02:00
|
|
|
void client_stack(void);
|
2008-05-26 16:17:57 +02:00
|
|
|
void client_raise(client_t *);
|
2008-04-11 11:35:11 +02:00
|
|
|
void client_ban(client_t *);
|
|
|
|
|
void client_unban(client_t *);
|
2008-03-21 16:50:17 +01:00
|
|
|
void client_manage(xcb_window_t, xcb_get_geometry_reply_t *, int);
|
2008-06-18 13:58:31 +02:00
|
|
|
area_t client_geometry_hints(client_t *, area_t);
|
2008-04-11 11:35:11 +02:00
|
|
|
bool client_resize(client_t *, area_t, bool);
|
|
|
|
|
void client_unmanage(client_t *);
|
|
|
|
|
void client_updatewmhints(client_t *);
|
|
|
|
|
xcb_size_hints_t *client_updatesizehints(client_t *);
|
2008-07-08 18:04:08 +02:00
|
|
|
bool client_updatetitle(client_t *);
|
2008-04-11 11:35:11 +02:00
|
|
|
void client_saveprops(client_t *);
|
|
|
|
|
void client_kill(client_t *);
|
2008-06-25 22:26:53 +02:00
|
|
|
void client_setfloating(client_t *, bool);
|
2008-06-11 08:12:38 +02:00
|
|
|
void client_setborder(client_t *, int);
|
2007-09-05 20:15:00 +02:00
|
|
|
|
2008-07-08 10:54:57 +02:00
|
|
|
int luaA_client_newindex(lua_State *);
|
|
|
|
|
|
2008-06-18 18:31:35 +02:00
|
|
|
int luaA_client_userdata_new(lua_State *, client_t *);
|
2008-05-23 22:49:39 +02:00
|
|
|
|
2008-07-31 17:29:05 +02:00
|
|
|
DO_SLIST(client_t, client, client_unref)
|
Alternative export method of arrays from C to Lua
The patch is mainly to export client_array_t object to Lua,
but can be used to export any ..._array_t object.
The idea: export to Lua not a table, but userdata with
metamethods to get/set/define length of ..._array_t object
directly.
Now when I get clients field from tag object C code
creates full copy of client_array_t structure into Lua table.
It takes traversing a whole array of data.
I did it in other way: userdata is exported, with __index,
__newindex, and __len meta-methods defined, and Lua
script gains direct access to client_array_t C-array:
it can get client object, get length of array and assign
client objects to some index in C-array.
Pros:
No overhead of creation a copy of C-structure into Lua-table:
if I want just to test a number of clients for a tag, I don't need
a whole loop to build table, I just want to read clients->len field,
and I do so via __len meta-method.
Also if I want to get some client from tags.clients, I don't need
to create ALL clients Lua-objects, I just get client_t C-struct
and create Lua-object from it. Just in place.
So Lua-loop enuming all tag.clients is not 2 loops internally
(first create copy of tag.clients into Lua-table, then enum this table),
but only one, and if I break out of loop in the middle, I create
only some client Lua-objects, not all of them from tag.clients.
Contras:
As far as clients field is not a table, I cant use pairs/ipairs
and other table functions for it.
But it can be implemented in other way:
for k,c pairs(tag.clients) => for k = 1, #tag.clients,
table.insert(tag.clients, client) => tag.clients[#tag.clients+1] = client
etc.
One more Pro now:
As far as tag.clients in current implementation returns copy of data
table.insert doesn't do what's expected: it doesn't really add client
into tag.clients "array".
With my implementation client is added as expected, as we work with
client_array_t structure directly.
Signed-off-by: Julien Danjou <julien@danjou.info>
2008-08-10 14:05:50 +02:00
|
|
|
DO_LUA_EXPORT_ARRAY(client, "client_array", client_t, client_array_t, luaA_client_userdata_new)
|
2008-01-13 15:44:01 +01:00
|
|
|
|
2007-09-05 20:15:00 +02:00
|
|
|
#endif
|
2007-12-18 09:24:15 +01:00
|
|
|
// vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80
|
