Uselessfair code refactoring

layout/uselessfair.lua

@@ -2,7 +2,7 @@
 --[[
 
      Licensed under GNU General Public License v2
-      * (c) 2014,      projektile
+      * (c) 2014,      projektile, worron
       * (c) 2013,      Luke Bonham
       * (c) 2012,      Josh Komoroske
       * (c) 2010-2012, Peter Hofmann
@@ -11,98 +11,98 @@
 
 local beautiful = require("beautiful")
 local ipairs    = ipairs
-local math      = { ceil = math.ceil, sqrt = math.sqrt }
+local math      = { ceil = math.ceil, sqrt = math.sqrt, floor = math.floor, max = math.max }
 local tonumber  = tonumber
 
 local uselessfair = {}
 
+-- Transformation functions
+local function swap(geometry)
+    return { x = geometry.y, y = geometry.x, width = geometry.height, height = geometry.width }
+end
+
+-- Client geometry correction depending on useless gap and window border
+local function size_correction(c, geometry, useless_gap)
+    geometry.width  = math.max(geometry.width  - 2 * c.border_width - useless_gap, 1)
+    geometry.height = math.max(geometry.height - 2 * c.border_width - useless_gap, 1)
+    geometry.x = geometry.x + useless_gap / 2
+    geometry.y = geometry.y + useless_gap / 2
+end
+
+-- Main tiling function
 local function fair(p, orientation)
-    -- A useless gap (like the dwm patch) can be defined with
-    -- beautiful.useless_gap_width.
-    local useless_gap = tonumber(beautiful.useless_gap_width) or 0
-    if useless_gap < 0 then useless_gap = 0 end
 
-    -- A global border can be defined with
+    -- Theme vars
-    -- beautiful.global_border_width.
+    local useless_gap = beautiful.useless_gap_width or 0
-    local global_border = tonumber(beautiful.global_border_width) or 0
+    local global_border = beautiful.global_border_width or 0
-    if global_border < 0 then global_border = 0 end
 
-    -- Themes border width requires an offset.
+    -- Aliases
-    local bw = tonumber(beautiful.border_width) or 0
-
-    -- Total window size extend
-    local ext = 2 * bw + useless_gap
-
-    -- get our orientation right.
     local wa = p.workarea
     local cls = p.clients
 
+    -- Nothing to tile here
+    if #cls == 0 then return end
+
+    -- Workarea size correction depending on useless gap and global border
     wa.height = wa.height - 2 * global_border - useless_gap
     wa.width  = wa.width -  2 * global_border - useless_gap
-    wa.x = wa.x + useless_gap + global_border
+    wa.x = wa.x + useless_gap / 2 + global_border
-    wa.y = wa.y + useless_gap + global_border
+    wa.y = wa.y + useless_gap / 2 + global_border
 
-    if #cls > 0 then
+    -- Geometry calculation
-        local cells = math.ceil(math.sqrt(#cls))
+    local row, col = 0, 0
-        local strips = math.ceil(#cls / cells)
 
-        local cell = 0
+    local rows = math.ceil(math.sqrt(#cls))
-        local strip = 0
+    local cols = math.ceil(#cls / rows)
-        for k, c in ipairs(cls) do
+
+    for i, c in ipairs(cls) do
         local g = {}
 
-            if ( orientation == "east" and #cls > 2 )
+        -- find tile orientation for current client and swap geometry if need
-            or ( orientation == "south" and #cls <= 2 ) then
+        local need_swap = (orientation == "east" and #cls <= 2) or (orientation == "south" and #cls > 2)
-                if #cls < (strips * cells) and strip == strips - 1 then
+        local area = need_swap and swap(wa) or wa
-                    g.width = wa.width / (cells - ((strips * cells) - #cls))
+
+        -- calculate geometry
+        if #cls < (cols * rows) and row == cols - 1 then
+            g.width = area.width / (rows - ((cols * rows) - #cls))
         else
-                    g.width = wa.width / cells
+            g.width = area.width / rows
-                end
-                g.height = wa.height / strips
-
-                g.x = wa.x + cell * g.width
-                g.y = wa.y + strip * g.height
-
-            else
-                if #cls < (strips * cells) and strip == strips - 1 then
-                    g.height = wa.height / (cells - ((strips * cells) - #cls))
-                else
-                    g.height = wa.height / cells
-                end
-                g.width = wa.width / strips
-
-                g.x = wa.x + strip * g.width
-                g.y = wa.y + cell * g.height
-
         end
 
-            g.width = g.width - ext
+        g.height = area.height / cols
-            g.height = g.height - ext
+        g.x = area.x + col * g.width
+        g.y = area.y + row * g.height
 
+        -- turn back to real if geometry was swapped
+        if need_swap then g = swap(g) end
+
+        -- window size correction depending on useless gap and window border
+        size_correction(c, g, useless_gap)
+
+        -- set geometry
         c:geometry(g)
 
-            cell = cell + 1
+        -- update tile grid coordinates
-            if cell == cells then
+        col = i % rows
-                cell = 0
+        row = math.floor(i / rows)
-                strip = strip + 1
-            end
-        end
     end
 end
 
---- Horizontal fair layout.
+-- Layout constructor
--- @param screen The screen to arrange.
+local function construct_layout(name, direction)
-uselessfair.horizontal = {}
+    return {
-uselessfair.horizontal.name = "uselessfairh"
+        name = name,
-function uselessfair.horizontal.arrange(p)
+        -- @p screen The screen number to tile
-    return fair(p, "east")
+        arrange = function(p) return fair(p, direction) end
+    }
 end
 
--- Vertical fair layout.
+-- Build layouts with different tile direction
--- @param screen The screen to arrange.
+uselessfair.vertical   = construct_layout("uselessfair", "south")
-uselessfair.name = "uselessfair"
+uselessfair.horizontal = construct_layout("uselessfairh", "east")
-function uselessfair.arrange(p)
+
-    return fair(p, "south")
+-- Module aliase
-end
+uselessfair.arrange = uselessfair.vertical.arrange
+uselessfair.name = uselessfair.vertical.name
 
 return uselessfair