[wiki] [sites] Essentially a layout for a special class of foregrounded'' floating windows. When a window is foregrounded, it is floated, resized, and moved to a predictable location. || espro1

From: <git_AT_suckless.org>
Date: Tue, 20 Feb 2024 21:35:44 +0100

commit 230fda53a0f6bbb16d8bfed48dcdb659d7166583
Author: espro1 <ericspero_AT_icloud.com>
Date: Tue Feb 20 15:35:28 2024 -0500

    Essentially a layout for a special class of foregrounded'' floating windows. When a window is foregrounded, it is floated, resized, and moved to a predictable location.

diff --git a/dwm.suckless.org/patches/foreground/dwm-foreground-20240220-9f88553.diff b/dwm.suckless.org/patches/foreground/dwm-foreground-20240220-9f88553.diff
new file mode 100644
index 00000000..d41527fe
--- /dev/null
+++ b/dwm.suckless.org/patches/foreground/dwm-foreground-20240220-9f88553.diff
_AT_@ -0,0 +1,168 @@
+From 601ad7a18345fbbcfe634143a0cced0de7d94dbe Mon Sep 17 00:00:00 2001
+From: espro1 <ericspero_AT_icloud.com>
+Date: Tue, 20 Feb 2024 15:19:41 -0500
+Subject: [PATCH] Essentially a layout for a special class of floating windows.
+ When a window is foregrounded, it is floated, resized, and moved to a
+ predictable location
+
+---
+ config.def.h | 3 ++
+ dwm.c | 77 +++++++++++++++++++++++++++++++++++++++++++++++++++-
+ 2 files changed, 79 insertions(+), 1 deletion(-)
+
+diff --git a/config.def.h b/config.def.h
+index 9efa774..718e7c3 100644
+--- a/config.def.h
++++ b/config.def.h
+_AT_@ -37,6 +37,8 @@ static const int nmaster = 1; /* number of clients in master area */
+ static const int resizehints = 1; /* 1 means respect size hints in tiled resizals */
+ static const int lockfullscreen = 1; /* 1 will force focus on the fullscreen window */
+
++static const float fgw = .6,fgh = .6;
++
+ static const Layout layouts[] = {
+ /* symbol arrange function */
+ { "[]=", tile }, /* first entry is default */
+_AT_@ -78,6 +80,7 @@ static const Key keys[] = {
+ { MODKEY, XK_f, setlayout, {.v = &layouts[1]} },
+ { MODKEY, XK_m, setlayout, {.v = &layouts[2]} },
+ { MODKEY, XK_space, setlayout, {0} },
++ { MODKEY|Mod4Mask, XK_space, toggleforegrounded, {0} },
+ { MODKEY|ShiftMask, XK_space, togglefloating, {0} },
+ { MODKEY, XK_0, view, {.ui = ~0 } },
+ { MODKEY|ShiftMask, XK_0, tag, {.ui = ~0 } },
+diff --git a/dwm.c b/dwm.c
+index f1d86b2..cf6deb0 100644
+--- a/dwm.c
++++ b/dwm.c
+_AT_@ -92,9 +92,10 @@ struct Client {
+ int basew, baseh, incw, inch, maxw, maxh, minw, minh, hintsvalid;
+ int bw, oldbw;
+ unsigned int tags;
+- int isfixed, isfloating, isurgent, neverfocus, oldstate, isfullscreen;
++ int isfixed, isfloating, isurgent, neverfocus, oldstate, isfullscreen, isforegrounded;
+ Client *next;
+ Client *snext;
++ Client *tnext;
+ Monitor *mon;
+ Window win;
+ };
+_AT_@ -127,6 +128,7 @@ struct Monitor {
+ Client *clients;
+ Client *sel;
+ Client *stack;
++ Client *foregrounded;
+ Monitor *next;
+ Window barwin;
+ const Layout *lt[2];
+_AT_@ -210,6 +212,7 @@ static void tag(const Arg *arg);
+ static void tagmon(const Arg *arg);
+ static void tile(Monitor *m);
+ static void togglebar(const Arg *arg);
++static void toggleforegrounded(const Arg *arg);
+ static void togglefloating(const Arg *arg);
+ static void toggletag(const Arg *arg);
+ static void toggleview(const Arg *arg);
+_AT_@ -415,6 +418,21 @@ attachstack(Client *c)
+ c->mon->stack = c;
+ }
+
++void
++attachforegrounded (Client *c)
++{
++ c->tnext = c->mon->foregrounded;
++ c->mon->foregrounded = c;
++}
++
++void
++detachforegrounded (Client *c)
++{
++ Client **tc;
++ for (tc = &c->mon->foregrounded; *tc && *tc != c; tc = &(*tc)->tnext);
++ *tc = c->tnext;
++}
++
+ void
+ buttonpress(XEvent *e)
+ {
+_AT_@ -1209,6 +1227,39 @@ nexttiled(Client *c)
+ return c;
+ }
+
++Client *
++nextforegrounded(Client *c)
++{
++ for (; c && (!c->isforegrounded || !ISVISIBLE(c)); c = c->tnext);
++ return c;
++}
++
++void
++arrangeforegrounded (Monitor *m)
++{
++ unsigned int n,i,x,y,w,h;
++ Client *c;
++
++ for (n = 0, c = nextforegrounded(m->foregrounded); c; c = nextforegrounded(c->tnext), n++);
++ if (n == 0)
++ return;
++
++ for (i = 0, c = nextforegrounded(m->foregrounded); c; c = nextforegrounded(c->tnext), i++){
++ if (n == 1) {
++ x = m->mx + (m->mw - m->mw * fgw) / 2;
++ y = m->my + (m->mh - m->mh * fgh) / 2;
++ w = (m->mw * fgw) - (2 * (m->foregrounded->bw));
++ h = (m->mh * fgh) - (2 * (m->foregrounded->bw));
++ } else {
++ x = (n - 1 - i) * (m->mw / n);
++ y = m->my + (m->mh - m->mh * fgh) / 2;
++ w = (m->mw * (1 / (float)n)) - (2 * (m->foregrounded->bw));
++ h = (m->mh * fgh) - (2 * (m->foregrounded->bw));
++ }
++ resize(c,x,y,w,h,0);
++ }
++}
++
+ void
+ pop(Client *c)
+ {
+_AT_@ -1721,6 +1772,24 @@ togglebar(const Arg *arg)
+ arrange(selmon);
+ }
+
++void
++toggleforegrounded(const Arg *arg)
++{
++ if (!selmon->sel)
++ return;
++ if (selmon->sel->isfullscreen) /* no support for fullscreen windows */
++ return;
++
++ selmon->sel->isforegrounded || selmon->sel->isfloating ?
++ detachforegrounded(selmon->sel) : attachforegrounded(selmon->sel);
++
++ selmon->sel->isforegrounded = selmon->sel->isfloating =
++ !selmon->sel->isfloating && !selmon->sel->isforegrounded;
++
++ arrangeforegrounded(selmon);
++ arrange(selmon);
++}
++
+ void
+ togglefloating(const Arg *arg)
+ {
+_AT_@ -1783,6 +1852,12 @@ unmanage(Client *c, int destroyed)
+
+ detach(c);
+ detachstack(c);
++
++ if (c->isforegrounded){
++ detachforegrounded(c);
++ arrangeforegrounded(m);
++ }
++
+ if (!destroyed) {
+ wc.border_width = c->oldbw;
+ XGrabServer(dpy); /* avoid race conditions */
+--
+2.43.0
+
diff --git a/dwm.suckless.org/patches/foreground/index.md b/dwm.suckless.org/patches/foreground/index.md
new file mode 100644
index 00000000..674416f3
--- /dev/null
+++ b/dwm.suckless.org/patches/foreground/index.md
_AT_@ -0,0 +1,75 @@
+foreground
+============
+
+Description
+-----------
+Essentially a layout for a special class of ``foregrounded'' floating windows. When a window is foregrounded, it is floated, resized, and moved to a predictable location.
+
+Useful for when there are several windows in the stack (which makes their heights small), and you want to temporarily enlarge one or more of them with minimal disturbance to the current tag context.
+
+Layout
+-----------
+When there is one foregrounded window, it is centred on the monitor. It's size is specified by the user-defined `fgw` and `fgh` floats, are proportions of the monitor's width and height respectively.
+
+When there are n > 1 foregrounded windows, they are arranged in n equally-spaced columns that combined take up 100% of the monitor's width, and [`fgh` * 100]% of the monitor's height.
+
+In the diagram below, clients marked with an asterisk will be foregrounded next.
+
+ +--------------------------+
+ | | B* |
+ | | |
+ | +----------+
+ | A | C |
+ | | |
+ | +----------+
+ | | D |
+ | | |
+ +--------------------------+
+
+ +--------------------------+
+ | A | C |
+ | +----------------+ |
+ | | | |
+ | | B +----+
+ | | | |
+ | | | |
+ | +----------------+ |
+ | | D* |
+ +--------------------------+
+
+ +--------------------------+
+ | A* | C |
+ +--------------------------+
+ | | |
+ | B | D |
+ | | |
+ | | |
+ +--------------------------+
+ | | |
+ +--------------------------+
+
+ +--------------------------+
+ | C |
+ +--------------------------+
+ | | | |
+ | B | C | A |
+ | | | |
+ | | | |
+ +--------------------------+
+ | |
+ +--------------------------+
+
+Usage
+-----------
+Set `fgw` and `fgh` floats in config.h.
+
+Foreground a window by calling the `toggleforeground` function. By default this is set to Mod1 + Mod4 + Spacebar.
+
+Download
+--------
+* [dwm-foreground-20240220-9f88553.diff](dwm-foreground-20240220-9f88553.diff)
+
+Authors
+-------
+* Eric Spero - <eric_AT_ericspero.com>
+
Received on Tue Feb 20 2024 - 21:35:44 CET