awesome/tag.c

/*
 * tag.c - tag management
 *
 * Copyright © 2007-2008 Julien Danjou <julien@danjou.info>
 *
 * 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.
 *
 */

#include <stdio.h>
#include <X11/Xutil.h>

#include "screen.h"
#include "tag.h"
#include "client.h"
#include "ewmh.h"
#include "widget.h"

#include "layouts/magnifier.h"
#include "layouts/tile.h"
#include "layouts/max.h"
#include "layouts/floating.h"
#include "layouts/fibonacci.h"

#include "layoutgen.h"

extern awesome_t globalconf;

DO_LUA_NEW(extern, tag_t, tag, "tag", tag_ref)
DO_LUA_GC(tag_t, tag, "tag", tag_unref)
DO_LUA_EQ(tag_t, tag, "tag")

/** View or unview a tag.
 * \param tag the tag
 * \param view set visible or not
 */
static void
tag_view(tag_t *tag, bool view)
{
    tag->selected = view;
    ewmh_update_net_current_desktop(screen_virttophys(tag->screen));
    widget_invalidate_cache(tag->screen, WIDGET_CACHE_TAGS);
    globalconf.screens[tag->screen].need_arrange = true;
}

/** Create a new tag. Parameters values are checked.
 * \param name tag name
 * \param layout layout to use
 * \param mwfact master width factor
 * \param nmaster number of master windows
 * \param ncol number of columns for slaves windows
 * \return a new tag with all these parameters
 */
tag_t *
tag_new(const char *name, layout_t *layout, double mwfact, int nmaster, int ncol)
{
    tag_t *tag;

    tag = p_new(tag_t, 1);
    a_iso2utf8(name, &tag->name);
    tag->layout = layout;

    tag->mwfact = mwfact;
    if(tag->mwfact <= 0 || tag->mwfact >= 1)
        tag->mwfact = 0.5;

    if((tag->nmaster = nmaster) < 0)
        tag->nmaster = 1;

    if((tag->ncol = ncol) < 1)
        tag->ncol = 1;

    return tag;
}

/** Append a tag to a screen.
 * \param tag the tag to append
 * \param screen the screen id
 */
void
tag_append_to_screen(tag_t *tag, int screen)
{
    int phys_screen = screen_virttophys(screen);

    tag->screen = screen;
    tag_list_append(&globalconf.screens[screen].tags, tag);
    tag_ref(&tag);
    ewmh_update_net_numbers_of_desktop(phys_screen);
    ewmh_update_net_desktop_names(phys_screen);
    ewmh_update_workarea(phys_screen);
    widget_invalidate_cache(screen, WIDGET_CACHE_TAGS);
}

/** Tag a client with specified tag.
 * \param c the client to tag
 * \param t the tag to tag the client with
 */
void
tag_client(client_t *c, tag_t *t)
{
    tag_client_node_t *tc;

    /* don't tag twice */
    if(is_client_tagged(c, t))
        return;

    tc = p_new(tag_client_node_t, 1);
    tc->client = c;
    tc->tag = t;
    tag_client_node_list_push(&globalconf.tclink, tc);

    client_saveprops(c);
    widget_invalidate_cache(c->screen, WIDGET_CACHE_CLIENTS);
    globalconf.screens[c->screen].need_arrange = true;
}

/** Untag a client with specified tag.
 * \param c the client to tag
 * \param t the tag to tag the client with
 */
void
untag_client(client_t *c, tag_t *t)
{
    tag_client_node_t *tc;

    for(tc = globalconf.tclink; tc; tc = tc->next)
        if(tc->client == c && tc->tag == t)
        {
            tag_client_node_list_detach(&globalconf.tclink, tc);
            p_delete(&tc);
            client_saveprops(c);
            widget_invalidate_cache(c->screen, WIDGET_CACHE_CLIENTS);
            globalconf.screens[c->screen].need_arrange = True;
            break;
        }
}

/** Check if a client is tagged with the specified tag.
 * \param c the client
 * \param t the tag
 * \return true if the client is tagged with the tag, false otherwise.
 */
bool
is_client_tagged(client_t *c, tag_t *t)
{
    tag_client_node_t *tc;

    if(!c)
        return false;

    for(tc = globalconf.tclink; tc; tc = tc->next)
        if(tc->client == c && tc->tag == t)
            return true;

    return false;
}

/** Tag the client with the currently selected (visible) tags.
 * \param c the client
 */
void
tag_client_with_current_selected(client_t *c)
{
    tag_t *tag;
    screen_t vscreen = globalconf.screens[c->screen];

    for(tag = vscreen.tags; tag; tag = tag->next)
        if(tag->selected)
            tag_client(c, tag);
        else
            untag_client(c, tag);
}

/** Get the current tags for the specified screen.
 * Returned pointer must be p_delete'd after.
 * \param screen screen id
 * \return a double pointer of tag list finished with a NULL element
 */
tag_t **
tags_get_current(int screen)
{
    tag_t *tag, **tags = NULL;
    int n = 1;

    tags = p_new(tag_t *, n);
    for(tag = globalconf.screens[screen].tags; tag; tag = tag->next)
        if(tag->selected)
        {
            p_realloc(&tags, ++n);
            tags[n - 2] = tag;
        }

    /* finish with null */
    tags[n - 1] = NULL;

    return tags;
}


/** Set a tag to be the only one viewed.
 * \param target the tag to see
 */
static void
tag_view_only(tag_t *target)
{
    tag_t *tag;

    if(!target) return;

    for(tag = globalconf.screens[target->screen].tags; tag; tag = tag->next)
        tag_view(tag, tag == target);
}

/** View only a tag, selected by its index.
 * \param screen screen id
 * \param dindex the index
 */
void
tag_view_only_byindex(int screen, int dindex)
{
    tag_t *tag;

    if(dindex < 0)
        return;

    for(tag = globalconf.screens[screen].tags; tag && dindex > 0;
        tag = tag->next, dindex--);
    tag_view_only(tag);
}

/** Convert a tag to a printable string.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lreturn A string.
 */
static int
luaA_tag_tostring(lua_State *L)
{
    tag_t **p = luaA_checkudata(L, 1, "tag");
    lua_pushfstring(L, "[tag udata(%p) name(%s)]", *p, (*p)->name);
    return 1;
}

/** Add a tag to a screen.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lparam A screen number.
 */
static int
luaA_tag_add(lua_State *L)
{
    tag_t *t, **tag = luaA_checkudata(L, 1, "tag");
    int i, screen = luaL_checknumber(L, 2) - 1;
    luaA_checkscreen(screen);

    for(i = 0; i < globalconf.screens_info->nscreen; i++)
        for(t = globalconf.screens[i].tags; t; t = t->next)
            if(*tag == t)
                luaL_error(L, "tag already on screen %d", i + 1);
            else if(t->screen == screen && !a_strcmp((*tag)->name, t->name))
                luaL_error(L, "a tag with the name `%s' is already on screen %d", t->name, i + 1);

    (*tag)->screen = screen;
    tag_append_to_screen(*tag, screen);
    return 0;
}

/** Get all tags from a screen.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lparam A screen number.
 * \lreturn A table with all tags from the screen specified, indexed by tag name.
 */
static int
luaA_tag_get(lua_State *L)
{
    int screen = luaL_checknumber(L, 1) - 1;
    tag_t *tag;

    luaA_checkscreen(screen);

    lua_newtable(L);

    for(tag = globalconf.screens[screen].tags; tag; tag = tag->next)
    {
        luaA_tag_userdata_new(L, tag);
        lua_setfield(L, -2, tag->name);
    }

    return 1;
}

/** Get all tags from a screen.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lparam A screen number.
 * \lreturn A table with all tags from the screen specified, ordered and indexed
 * by number.
 */
static int
luaA_tag_geti(lua_State *L)
{
    int i = 1, screen = luaL_checknumber(L, 1) - 1;
    tag_t *tag;

    luaA_checkscreen(screen);

    lua_newtable(L);

    for(tag = globalconf.screens[screen].tags; tag; tag = tag->next)
    {
        luaA_tag_userdata_new(L, tag);
        lua_rawseti(L, -2, i++);
    }

    return 1;
}

/** Create a new tag.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lparam A table with at least a name attribute.
 * Optional attributes are: mwfact, ncol, nmaster and layout.
 * \lreturn A new tag object.
 */
static int
luaA_tag_new(lua_State *L)
{
    tag_t *tag;
    int ncol, nmaster;
    const char *name, *lay;
    double mwfact;
    layout_t *layout;

    luaA_checktable(L, 1);

    name = luaA_name_init(L);
    mwfact = luaA_getopt_number(L, 1, "mwfact", 0.5);
    ncol = luaA_getopt_number(L, 1, "ncol", 1);
    nmaster = luaA_getopt_number(L, 1, "nmaster", 1);
    lay = luaA_getopt_string(L, 1, "layout", "tile", NULL);

    layout = name_func_lookup(lay, LayoutList);

    tag = tag_new(name,
                  layout,
                  mwfact, nmaster, ncol);

    return luaA_tag_userdata_new(L, tag);
}

/** Add or remove a tag from the current view.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lparam A boolean value, true to view tag, false otherwise.
 */
static int
luaA_tag_view(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    bool view = luaA_checkboolean(L, 2);
    tag_view(*tag, view);
    return 0;
}

/** Get the tag selection attribute.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lreturn True if the tag is viewed, false otherwise.
 */
static int
luaA_tag_isselected(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    lua_pushboolean(L, (*tag)->selected);
    return 1;
}

/** Set the tag master width factor. This value is used in various layouts to
 * determine the size of the master window.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lparam The master width ratio value, between 0 and 1.
 */
static int
luaA_tag_mwfact_set(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    double mwfact = luaL_checknumber(L, 2);

    if(mwfact < 1 && mwfact > 0)
    {
        (*tag)->mwfact = mwfact;
        globalconf.screens[(*tag)->screen].need_arrange = true;
    }
    else
        luaL_error(L, "bad value, must be between 0 and 1");

    return 0;
}

/** Get the tag master width factor.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lreturn The master width ratio value.
 */
static int
luaA_tag_mwfact_get(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    lua_pushnumber(L, (*tag)->mwfact);
    return 1;
}

/** Set the number of columns. This is used in various layouts to set the number
 * of columns used to display non-master windows.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lparam The number of columns, at least 1.
 */
static int
luaA_tag_ncol_set(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    int ncol = luaL_checknumber(L, 2);

    if(ncol >= 1)
    {
        (*tag)->ncol = ncol;
        globalconf.screens[(*tag)->screen].need_arrange = true;
    }
    else
        luaL_error(L, "bad value, must be greater than 1");

    return 0;
}

/** Get the number of columns used to display non-master windows on this tag.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lreturn The number of column.
 */
static int
luaA_tag_ncol_get(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    lua_pushnumber(L, (*tag)->ncol);
    return 1;
}

/** Set the number of master windows. This is used in various layouts to
 * determine how many windows are in the master area.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lparam The number of master windows.
 */
static int
luaA_tag_nmaster_set(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    int nmaster = luaL_checknumber(L, 2);

    if(nmaster >= 0)
    {
        (*tag)->nmaster = nmaster;
        globalconf.screens[(*tag)->screen].need_arrange = true;
    }
    else
        luaL_error(L, "bad value, must be greater than 0");

    return 0;
}

/** Get the number of master windows of the tag.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lreturn The number of master windows.
 */
static int
luaA_tag_nmaster_get(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    lua_pushnumber(L, (*tag)->nmaster);
    return 1;
}

/** Get the tag name.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lreturn The tag name.
 */
static int
luaA_tag_name_get(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    lua_pushstring(L, (*tag)->name);
    return 1;
}

/** Set the tag name.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lparam A string with the new tag name.
 */
static int
luaA_tag_name_set(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    const char *name = luaL_checkstring(L, 2);
    p_delete(&(*tag)->name);
    a_iso2utf8(name, &(*tag)->name);
    return 0;
}

/** Get the layout of the tag.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lreturn The layout name.
 */
static int
luaA_tag_layout_get(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    const char *name = a_strdup(name_func_rlookup((*tag)->layout, LayoutList));
    lua_pushstring(L, name);
    return 1;
}

/** Set the layout of the tag.
 * \param L The Lua VM state.
 *
 * \luastack
 * \lvalue A tag.
 * \lparam A layout name.
 */
static int
luaA_tag_layout_set(lua_State *L)
{
    tag_t **tag = luaA_checkudata(L, 1, "tag");
    const char *name = luaL_checkstring(L, 2);
    layout_t *l = name_func_lookup(name, LayoutList);

    if(l)
    {
        (*tag)->layout = l;
        globalconf.screens[(*tag)->screen].need_arrange = true;
    }
    else
        luaL_error(L, "unknown layout: %s", name);

    return 0;

}

const struct luaL_reg awesome_tag_methods[] =
{
    { "new", luaA_tag_new },
    { "get", luaA_tag_get },
    { "geti", luaA_tag_geti },
    { NULL, NULL }
};
const struct luaL_reg awesome_tag_meta[] =
{
    { "add", luaA_tag_add },
    { "view", luaA_tag_view },
    { "isselected", luaA_tag_isselected },
    { "mwfact_set", luaA_tag_mwfact_set },
    { "mwfact_get", luaA_tag_mwfact_get },
    { "ncol_set", luaA_tag_ncol_set },
    { "ncol_get", luaA_tag_ncol_get },
    { "nmaster_set", luaA_tag_nmaster_set },
    { "nmaster_get", luaA_tag_nmaster_get },
    { "name_get", luaA_tag_name_get },
    { "name_set", luaA_tag_name_set },
    { "layout_get", luaA_tag_layout_get },
    { "layout_set", luaA_tag_layout_set },
    { "__eq", luaA_tag_eq },
    { "__gc", luaA_tag_gc },
    { "__tostring", luaA_tag_tostring },
    { NULL, NULL },
};
// vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80