/* * tag.c - tag management * * Copyright © 2007-2008 Julien Danjou * * 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 #include #include "screen.h" #include "tag.h" #include "rules.h" #include "client.h" #include "ewmh.h" #include "widget.h" extern AwesomeConf globalconf; /** Create a new tag. Parameteres 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 * tag_new(const char *name, Layout *layout, double mwfact, int nmaster, int ncol) { Tag *tag; tag = p_new(Tag, 1); tag->name = a_strdup(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 *tag, int screen) { int phys_screen = screen_virttophys(screen); tag->screen = screen; tag_list_append(&globalconf.screens[screen].tags, tag); ewmh_update_net_numbers_of_desktop(phys_screen); ewmh_update_net_desktop_names(phys_screen); widget_invalidate_cache(screen, WIDGET_CACHE_TAGS); } /** Push a tag to a screen tag list. * \param tag the tag to push * \param screen the screen */ void tag_push_to_screen(Tag *tag, int screen) { tag->screen = screen; tag_list_push(&globalconf.screens[screen].tags, tag); 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 *c, Tag *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 *c, Tag *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 *c, Tag *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 *c) { Tag *tag; VirtScreen 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); } /** Tag the client according to a rule. * \param c the client * \param r the rule */ void tag_client_with_rule(Client *c, Rule *r) { Tag *tag; Bool matched = False; if(!r) return; /* check if at least one tag match */ for(tag = globalconf.screens[c->screen].tags; tag; tag = tag->next) if(tag_match_rule(tag, r)) { matched = True; break; } if(matched) for(tag = globalconf.screens[c->screen].tags; tag; tag = tag->next) if(tag_match_rule(tag, r)) 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 ** tags_get_current(int screen) { Tag *tag, **tags = NULL; int n = 1; tags = p_new(Tag *, 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; } /** Tag the focused client with the given tag. * \param screen Screen ID * \param arg Tag name * \ingroup ui_callback */ void uicb_client_tag(int screen, char *arg) { int tag_id = -1; Tag *tag, *target_tag; Client *sel = globalconf.focus->client; if(!sel) return; if(arg) { tag_id = atoi(arg) - 1; if(tag_id != -1) { for(target_tag = globalconf.screens[screen].tags; target_tag && tag_id > 0; target_tag = target_tag->next, tag_id--); if(target_tag) { for(tag = globalconf.screens[screen].tags; tag; tag = tag->next) untag_client(sel, tag); tag_client(sel, target_tag); } } } else for(tag = globalconf.screens[screen].tags; tag; tag = tag->next) tag_client(sel, tag); } /** Toggle a tag on the focused client. * \param screen virtual screen id * \param arg tag number * \ingroup ui_callback */ void uicb_client_toggletag(int screen, char *arg) { Client *sel = globalconf.focus->client; int i; Bool is_sticky = True; Tag *tag, *target_tag; if(!sel) return; if(arg) { i = atoi(arg) - 1; for(target_tag = globalconf.screens[screen].tags; target_tag && i > 0; target_tag = target_tag->next, i--); if(target_tag) { if(is_client_tagged(sel, target_tag)) untag_client(sel, target_tag); else tag_client(sel, target_tag); } /* check that there's at least one tag selected for this client*/ for(tag = globalconf.screens[screen].tags; tag && !is_client_tagged(sel, tag); tag = tag->next); if(!tag) tag_client(sel, target_tag); } else { for(tag = globalconf.screens[screen].tags; tag; tag = tag->next) if(!is_client_tagged(sel, tag)) { is_sticky = False; tag_client(sel, tag); } if(is_sticky) tag_client_with_current_selected(sel); } } /** Toggle the visibility of a tag. * \param screen Screen ID * \param arg Tag name * \ingroup ui_callback */ void uicb_tag_toggleview(int screen, char *arg) { int i; Tag *tag, *target_tag, **backtag, **curtags = tags_get_current(screen); if(arg) { i = atoi(arg) - 1; for(target_tag = globalconf.screens[screen].tags; target_tag && i > 0; target_tag = target_tag->next, i--); if(target_tag) tag_view(target_tag, !target_tag->selected); } else for(tag = globalconf.screens[screen].tags; tag; tag = tag->next) tag_view(tag, !tag->selected); /* check that there's at least one tag selected */ for(tag = globalconf.screens[screen].tags; tag && !tag->selected; tag = tag->next); if(!tag) for(backtag = curtags; *backtag; backtag++) tag_view(*backtag, True); p_delete(&curtags); } /** Set a tag to be the only one viewed. * \param target the tag to see */ static void tag_view_only(Tag *target) { Tag *tag; if(!target) return; for(tag = globalconf.screens[target->screen].tags; tag; tag = tag->next) tag_view(tag, tag == target); } /** Use an index to set a tag viewable. * \param screen the screen id * \param dindex the index * \param view the view value */ void tag_view_byindex(int screen, int dindex, Bool view) { Tag *tag; if(dindex < 0) return; for(tag = globalconf.screens[screen].tags; tag && dindex > 0; tag = tag->next, dindex--); tag_view(tag, view); } /** 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 *tag; if(dindex < 0) return; for(tag = globalconf.screens[screen].tags; tag && dindex > 0; tag = tag->next, dindex--); tag_view_only(tag); } /** View or unview a tag. * \param tag the tag * \param view set visible or not */ void tag_view(Tag *tag, Bool view) { tag->was_selected = tag->selected; 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; } /** View only this tag. * \param screen Screen ID * \param arg tag to view * \ingroup ui_callback */ void uicb_tag_view(int screen, char *arg) { Tag *tag; if(arg) tag_view_only_byindex(screen, atoi(arg) - 1); else for(tag = globalconf.screens[screen].tags; tag; tag = tag->next) tag_view(tag, True); } /** View the previously selected tags. * \param screen Screen ID * \param arg unused * \ingroup ui_callback */ void uicb_tag_prev_selected(int screen, char *arg __attribute__ ((unused))) { Tag *tag; for(tag = globalconf.screens[screen].tags; tag; tag = tag->next) tag_view(tag, tag->was_selected); } /** View the next tag. * \param screen Screen ID * \param arg unused * \ingroup ui_callback */ void uicb_tag_viewnext(int screen, char *arg __attribute__ ((unused))) { Tag *tag, **curtags = tags_get_current(screen); tag = tag_list_next_cycle(&globalconf.screens[screen].tags, curtags[0]); tag_view(curtags[0], False); tag_view(tag, True); p_delete(&curtags); } /** View the previous tag. * \param screen Screen ID * \param arg unused * \ingroup ui_callback */ void uicb_tag_viewprev(int screen, char *arg __attribute__ ((unused))) { Tag *tag, **curtags = tags_get_current(screen); tag = tag_list_prev_cycle(&globalconf.screens[screen].tags, curtags[0]); tag_view(curtags[0], False); tag_view(tag, True); p_delete(&curtags); } /** Create a new tag. Argument must be the tag name. * \param screen the screen id * \param arg the tag name */ void uicb_tag_create(int screen, char *arg) { Tag *tag; if(!a_strlen(arg)) return; tag = tag_new(arg, globalconf.screens[screen].layouts, 0.5, 1, 1); tag_append_to_screen(tag, screen); } // vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80