From 471aab4846aef397d82e8966f5a748c8fe55549b Mon Sep 17 00:00:00 2001
From: Nicholas Hayashi <hayashi.nicholas@gmail.com>
Date: Sat, 20 Feb 2021 13:28:53 -0500
Subject: [PATCH] refactor hexyz

---
 main.lua            |  62 ++++++++++++++-
 res/shaded_hex1.png | Bin 0 -> 56727 bytes
 src/extra.lua       |   4 -
 src/game.lua        |  30 +++----
 src/grid.lua        |  92 +++++++++------------
 src/gui.lua         | 129 ++++++++++++++++++++++--------
 src/hexyz.lua       | 189 ++++++++++++++++++++++++--------------------
 src/mob.lua         |  14 ++--
 src/projectile.lua  |   6 +-
 src/tower.lua       |  19 +++--
 texture.lua         |   1 +
 11 files changed, 330 insertions(+), 216 deletions(-)
 create mode 100644 res/shaded_hex1.png

diff --git a/main.lua b/main.lua
index 906da57..a69f87e 100644
--- a/main.lua
+++ b/main.lua
@@ -26,7 +26,7 @@ do
     }
 end
 
--- assets and/or trivial code
+-- asset interfaces and/or trivial code
 require "color"
 require "sound"
 require "texture"
@@ -42,10 +42,64 @@ require "src/mob"
 require "src/projectile"
 require "src/tower"
 
-function main_action() end
-function main_scene() end
+
+function main_action(self)
+    self"hex_backdrop""rotate".angle = math.wrapf(self"hex_backdrop""rotate".angle - 0.002 * am.delta_time, math.pi*2)
+end
+
+function make_main_scene_toolbelt()
+    local options = {
+        {
+            label = "new game",
+            action = function(self) end
+        },
+        {
+            label = "load game",
+            action = function(self) game_init(am.load_state("save", "json")) end
+        },
+        {
+            label = "map editor",
+            action = function(self) log("map editor not implemented") end
+        },
+        {
+            label = "settings",
+            action = function(self) end
+        },
+    }
+    --local map = hex_rectangular_map(10, 20, HEX_ORIENTATION.POINTY)
+
+    return group
+end
+
+function main_scene()
+    local group = am.group()
+
+    local map = hex_hexagonal_map(30)
+    local hex_backdrop = (am.rotate(0) ^ am.group()):tag"hex_backdrop"
+    for i,_ in pairs(map) do
+        for j,n in pairs(map[i]) do
+            local color = map_elevation_color(n)
+            color = color{a=color.a - 0.1}
+
+            local node = am.translate(hex_to_pixel(vec2(i, j), vec2(HEX_SIZE)))
+                         ^ am.circle(vec2(0), HEX_SIZE, vec4(0), 6)
+
+            node"circle":action(am.tween(1, { color = color }))
+
+            hex_backdrop:append(node)
+        end
+    end
+    group:append(hex_backdrop)
+
+    group:append(am.translate(0, 200) ^ am.sprite("res/logo.png"))
+    group:append(make_main_scene_toolbelt())
+
+    group:action(main_action)
+
+    return group
+end
 
 win.scene = am.group()
-game_init(nil)
+game_init()
 noglobals()
 
diff --git a/res/shaded_hex1.png b/res/shaded_hex1.png
new file mode 100644
index 0000000000000000000000000000000000000000..0a5fe4ebca8cf7721cd8726ca6d6666150fe001e
GIT binary patch
literal 56727
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

literal 0
HcmV?d00001

diff --git a/src/extra.lua b/src/extra.lua
index 3c38873..491c7d0 100644
--- a/src/extra.lua
+++ b/src/extra.lua
@@ -9,10 +9,6 @@ function fprofile(f, ...)
     return result
 end
 
-function booltostring(bool)
-    return bool and "true" or "false"
-end
-
 function math.wrapf(float, range)
     return float - range * math.floor(float / range)
 end
diff --git a/src/game.lua b/src/game.lua
index 4c8d113..8c2a130 100644
--- a/src/game.lua
+++ b/src/game.lua
@@ -82,7 +82,7 @@ local function get_top_right_display_text(hex, evenq, centered_evenq, display_ty
         str = "SEED: " .. state.map.seed
 
     elseif display_type == TRDTS.TILE then
-        str = table.tostring(map_get(state.map, hex))
+        str = table.tostring(hex_map_get(state.map, hex))
     end
     return str
 end
@@ -247,7 +247,7 @@ local function game_action(scene)
     local evenq          = hex_to_evenq(hex)
     local centered_evenq = evenq{ y = -evenq.y } - vec2(math.floor(HEX_GRID_WIDTH/2)
                                                       , math.floor(HEX_GRID_HEIGHT/2))
-    local tile = map_get(state.map, hex)
+    local tile = hex_map_get(state.map, hex)
 
     local interactable = evenq_is_in_interactable_region(evenq{ y = -evenq.y })
     local buildable = tower_type_is_buildable_on(hex, tile, state.selected_tower_type)
@@ -416,7 +416,8 @@ local function make_game_toolbelt()
     local toolbelt = am.group{
         am.group():tag"tower_tooltip_text",
         am.rect(win.left, win.bottom, win.right, win.bottom + toolbelt_height, COLORS.TRANSPARENT)
-    }:tag"toolbelt"
+    }
+    :tag"toolbelt"
 
     local padding = 15
     local size = toolbelt_height - padding
@@ -430,7 +431,9 @@ local function make_game_toolbelt()
     local tower_select_square = (
         am.translate(vec2(size + padding, half_size) + offset)
         ^ am.rect(-size/2-3, -size/2-3, size/2+3, size/2+3, COLORS.SUNRAY)
-    ):tag"tower_select_square"
+    )
+    :tag"tower_select_square"
+
     tower_select_square.hidden = true
     toolbelt:append(tower_select_square)
 
@@ -503,7 +506,7 @@ end
 -- optionally, |action_f| is a function that operates on the group node every frame
 function make_hex_cursor(radius, color_f, action_f)
     local color = type(color_f) == "userdata" and color_f or nil
-    local map = spiral_map(vec2(0), radius)
+    local map = hex_spiral_map(vec2(0), radius)
     local group = am.group()
 
     for _,h in pairs(map) do
@@ -557,22 +560,15 @@ end
 function game_init(saved_state)
     if saved_state then
         state = game_deserialize(saved_state)
-
-        -- scene nodes aren't (can't be?) serialized, so we re-generate them if we're loading from a save
-
-
     else
         state = get_initial_game_state()
+        local home_tower = build_tower(HEX_GRID_CENTER, TOWER_TYPE.RADAR)
+        for _,h in pairs(home_tower.hexes) do
+            -- @HACK to make the center tile(s) passable even though there's a tower on it
+            hex_map_get(state.map, h).elevation = 0
+        end
     end
 
-    --[[
-    local home_tower = build_tower(HEX_GRID_CENTER, TOWER_TYPE.RADAR)
-    for _,h in pairs(home_tower.hexes) do
-        -- @HACK to make the center tile(s) passable even though there's a tower on it
-        map_get(state.map, h).elevation = 0
-    end
-    ]]
-
     win.scene:remove("game")
     win.scene:append(game_scene())
 end
diff --git a/src/grid.lua b/src/grid.lua
index 2f43e96..6e3c70d 100644
--- a/src/grid.lua
+++ b/src/grid.lua
@@ -3,8 +3,8 @@
 -- distance from hex centerpoint to any vertex
 HEX_SIZE = 26
 
-HEX_PIXEL_WIDTH = hex_width(HEX_SIZE, ORIENTATION.FLAT)
-HEX_PIXEL_HEIGHT = hex_height(HEX_SIZE, ORIENTATION.FLAT)
+HEX_PIXEL_WIDTH = hex_width(HEX_SIZE, HEX_ORIENTATION.FLAT)
+HEX_PIXEL_HEIGHT = hex_height(HEX_SIZE, HEX_ORIENTATION.FLAT)
 HEX_PIXEL_DIMENSIONS = vec2(HEX_PIXEL_WIDTH, HEX_PIXEL_HEIGHT)
 
 do
@@ -80,7 +80,7 @@ function grid_heuristic(source, target)
 end
 
 function grid_cost(map, from, to)
-    local t1, t2 = map_get(map, from), map_get(map, to)
+    local t1, t2 = hex_map_get(map, from), hex_map_get(map, to)
 
     -- i have no fucking clue why, but adding +0.2 to the end of this fixes a bug where sometimes two (or more)
     -- equivalent paths are found and mobs backpedal trying to decide between them
@@ -97,13 +97,13 @@ end
 
 function grid_neighbours(map, hex)
     return table.filter(hex_neighbours(hex), function(_hex)
-        local tile = map_get(map, _hex)
+        local tile = hex_map_get(map, _hex)
         return tile and tile_is_medium_elevation(tile)
     end)
 end
 
 function generate_flow_field(map, start)
-    return dijkstra(map, start, nil, grid_cost, grid_neighbours)
+    return hex_dijkstra(map, start, nil, grid_cost, grid_neighbours)
 end
 
 function apply_flow_field(map, flow_field, world)
@@ -115,7 +115,7 @@ function apply_flow_field(map, flow_field, world)
     local overlay_group = am.group():tag"flow_field"
     for i,_ in pairs(map) do
         for j,f in pairs(map[i]) do
-            local flow = map_get(flow_field, i, j)
+            local flow = hex_map_get(flow_field, i, j)
 
             if flow then
                 map[i][j].priority = flow.priority
@@ -134,38 +134,12 @@ function apply_flow_field(map, flow_field, world)
     end
 end
 
--- some convenience functions for setting and retrieving values from a 2d sparse array
--- where the first index might return a nil value, causing the second second to crash the game
--- and where it's often the case that the indexer is a vec2
-function map_get(map, hex, y)
-    if y then return map[hex] and map[hex][y] end
-    return map[hex.x] and map[hex.x][hex.y]
-end
-
-function map_set(map, hex, y, v)
-    if v then
-        if map[hex] then
-            map[hex][y] = v
-        else
-            map[hex] = {}
-            map[hex][y] = v
-        end
-    else
-        if map[hex.x] then
-            map[hex.x][hex.y] = y
-        else
-            map[hex.x] = {}
-            map[hex.x][hex.y] = y
-        end
-    end
-end
-
 function building_tower_breaks_flow_field(tower_type, hex)
     local original_elevations = {}
     local all_impassable = true
-    local hexes = spiral_map(hex, get_tower_size(tower_type))
+    local hexes = hex_spiral_map(hex, get_tower_size(tower_type))
     for _,h in pairs(hexes) do
-        local tile = map_get(state.map, h)
+        local tile = hex_map_get(state.map, h)
 
         if all_impassable and mob_can_pass_through(nil, h) then
             all_impassable = false
@@ -182,41 +156,42 @@ function building_tower_breaks_flow_field(tower_type, hex)
     -- (besides return all the tile's elevations back to their original state)
     if all_impassable then
         for i,h in pairs(hexes) do
-            map_get(state.map, h).elevation = original_elevations[i]
+            hex_map_get(state.map, h).elevation = original_elevations[i]
         end
         return false
     end
 
     local flow_field = generate_flow_field(state.map, HEX_GRID_CENTER)
-    local result = not map_get(flow_field, 0, 0)
+    local result = not hex_map_get(flow_field, 0, 0)
 
     for i,h in pairs(hexes) do
-        map_get(state.map, h).elevation = original_elevations[i]
+        hex_map_get(state.map, h).elevation = original_elevations[i]
     end
 
     return result, flow_field
 end
 
-function make_hex_grid_scene(map)
-    local function color_at(elevation)
-        if elevation < -0.5 then -- lowest elevation
-            return COLORS.WATER{ a = (elevation + 1.4) / 2 + 0.2 }
+function map_elevation_color(elevation)
+    if elevation < -0.5 then -- lowest elevation
+        return COLORS.WATER{ a = (elevation + 1.4) / 2 + 0.2 }
 
-        elseif elevation < 0 then -- med-low elevation
-            return math.lerp(COLORS.DIRT, COLORS.GRASS, elevation + 0.5){ a = (elevation + 1.8) / 2 + 0.3 }
+    elseif elevation < 0 then -- med-low elevation
+        return math.lerp(COLORS.DIRT, COLORS.GRASS, elevation + 0.5){ a = (elevation + 1.8) / 2 + 0.3 }
 
-        elseif elevation < 0.5 then -- med-high elevation
-            return math.lerp(COLORS.DIRT, COLORS.GRASS, elevation + 0.5){ a = (elevation + 1.6) / 2 + 0.3 }
+    elseif elevation < 0.5 then -- med-high elevation
+        return math.lerp(COLORS.DIRT, COLORS.GRASS, elevation + 0.5){ a = (elevation + 1.6) / 2 + 0.3 }
 
-        elseif elevation < 1 then     -- high elevation
-            return COLORS.MOUNTAIN{ ra = elevation }
+    elseif elevation < 1 then     -- high elevation
+        return COLORS.MOUNTAIN{ ra = elevation }
 
-        else
-            -- @TODO probably fix... this only happens when loading a save, and the tile has an elevation that's
-            -- higher that anything here
-            return vec4(0.1)
-        end
+    else
+        -- @TODO probably fix... this only happens when loading a save, and the tile has an elevation that's
+        -- higher that anything here
+        return vec4(0.1)
     end
+end
+
+function make_hex_grid_scene(map)
     -- the world's appearance relies largely on a backdrop which can be scaled in
     -- tone to give the appearance of light or darkness
     -- @NOTE replace this with a shader program
@@ -239,12 +214,12 @@ function make_hex_grid_scene(map)
             local mask = vec4(0, 0, 0, math.max(((evenq.x - HEX_GRID_WIDTH/2) / HEX_GRID_WIDTH) ^ 2
                                              , ((-evenq.y - HEX_GRID_HEIGHT/2) / HEX_GRID_HEIGHT) ^ 2))
 
-            local color = color_at(tile.elevation) - mask
+            local color = map_elevation_color(tile.elevation) - mask
 
             local node = am.translate(hex_to_pixel(vec2(i, j), vec2(HEX_SIZE)))
                         ^ am.circle(vec2(0), HEX_SIZE, color, 6)
 
-            map_set(map, i, j, {
+            hex_map_set(map, i, j, {
                 elevation = tile.elevation,
                 node = node
             })
@@ -259,7 +234,12 @@ function make_hex_grid_scene(map)
 end
 
 function random_map(seed)
-    local map = rectangular_map(HEX_GRID_DIMENSIONS.x, HEX_GRID_DIMENSIONS.y, seed)
+    local map = hex_rectangular_map(
+        HEX_GRID_DIMENSIONS.x,
+        HEX_GRID_DIMENSIONS.y,
+        HEX_ORIENTATION.FLAT,
+        seed
+    )
     math.randomseed(map.seed)
 
     -- there are some things about the generated map we'd like to change...
@@ -286,7 +266,7 @@ function random_map(seed)
                 noise = noise * d^0.125 -- arbitrary, seems to work good
             end
 
-            map_set(map, i, j, {
+            hex_map_set(map, i, j, {
                 elevation = noise,
             })
         end
diff --git a/src/gui.lua b/src/gui.lua
index 21d033c..20d179f 100644
--- a/src/gui.lua
+++ b/src/gui.lua
@@ -4,19 +4,25 @@ function gui_numberfield(dimensions, opts)
 
 end
 
-
-function gui_textfield(position, dimensions, max, disallowed_keys)
+function gui_textfield(position, dimensions, max, disallowed_chars)
     local width, height = dimensions.x, dimensions.y
-    local disallowed_keys = disallowed_keys or {}
-    local max = max or 99
-
-    local padding = 2
-    local outer_rect = am.rect(-width/2, -height/2, width/2, height/2, COLORS.VERY_DARK_GRAY)
-    local inner_rect = am.rect(-width/2 + padding
-                             , -height/2 + padding
-                             , width/2 - padding
-                             , height/2 - padding
-                             , COLORS.PALE_SILVER)
+    local disallowed_chars = disallowed_chars or {}
+    local max = max or 10
+
+    local outer_rect = am.rect(
+        -width/2,
+        -height/2,
+        width/2,
+        height/2,
+        COLORS.VERY_DARK_GRAY
+    )
+    local inner_rect = am.rect(
+        -width/2 + 1,
+        -height/2 + 1,
+        width/2 - 2,
+        height/2 - 2,
+        COLORS.PALE_SILVER
+    )
 
     local group = am.group{
         outer_rect,
@@ -29,29 +35,90 @@ function gui_textfield(position, dimensions, max, disallowed_keys)
         local keys = win:keys_pressed()
         if #keys == 0 then return end
 
-        -- @HACK all characters and digits are represented by a single string in amulet
-        -- so we don't have to iterate over everything
-        -- pattern matching doesn't work because control characters are also just normal strings
+        local chars = {}
+        local shift = win:key_down("lshift") or win:key_down("rshift")
         for i,k in pairs(keys) do
-            if not disallowed_keys[k] then
-                if k:len() == 1 then
-                    if string.match(k, "%d") then
-                        self"text".text = self"text".text .. k
-
-                    elseif win:key_down("lshift") or win:key_down("rshift") then
-                        self"text".text = self"text".text .. k:upper()
-
+            if k:len() == 1 then -- @HACK alphabetical or digit characters
+                if string.match(k, "%a") then
+                    if shift then
+                        table.insert(chars, k:upper())
                     else
-                        self"text".text = self"text".text .. k
+                        table.insert(chars, k)
                     end
-                elseif k == "space" then
-                    self"text".text = self"text".text .. " "
-
-                elseif k == "backspace" then
-                    self"text".text = self"text".text:sub(1, self"text".text:len() - 1)
-
-                elseif k == "enter" then
+                elseif string.match(k, "%d") then
+                    if shift then
+                        if k == "1" then table.insert(chars, "!")
+                        elseif k == "2" then table.insert(chars, "@")
+                        elseif k == "3" then table.insert(chars, "#")
+                        elseif k == "4" then table.insert(chars, "$")
+                        elseif k == "5" then table.insert(chars, "%")
+                        elseif k == "6" then table.insert(chars, "^")
+                        elseif k == "7" then table.insert(chars, "&")
+                        elseif k == "8" then table.insert(chars, "*")
+                        elseif k == "9" then table.insert(chars, "(")
+                        elseif k == "0" then table.insert(chars, ")")
+                        end
+                    else
+                        table.insert(chars, k)
+                    end
+                end
+            -- begin non-alphabetical/digit
+            elseif k == "minus" then
+                if shift then table.insert(chars, "_")
+                else          table.insert(chars, "-") end
+            elseif k == "equals" then
+                if shift then table.insert(chars, "=")
+                else          table.insert(chars, "+") end
+            elseif k == "leftbracket" then
+                if shift then table.insert(chars, "{")
+                else          table.insert(chars, "[") end
+            elseif k == "rightbracket" then
+                if shift then table.insert(chars, "}")
+                else          table.insert(chars, "]") end
+            elseif k == "backslash" then
+                if shift then table.insert(chars, "|")
+                else          table.insert(chars, "\\") end
+            elseif k == "semicolon" then
+                if shift then table.insert(chars, ":")
+                else          table.insert(chars, ";") end
+            elseif k == "quote" then
+                if shift then table.insert(chars, "\"")
+                else          table.insert(chars, "'") end
+            elseif k == "backquote" then
+                if shift then table.insert(chars, "~")
+                else          table.insert(chars, "`") end
+            elseif k == "comma" then
+                if shift then table.insert(chars, "<")
+                else          table.insert(chars, ",") end
+            elseif k == "period" then
+                if shift then table.insert(chars, ">")
+                else          table.insert(chars, ".") end
+            elseif k == "slash" then
+                if shift then table.insert(chars, "?")
+                else          table.insert(chars, "/") end
+
+            -- control characters
+            elseif k == "backspace" then
+                -- @NOTE this doesn't preserve the order of chars in the array so if
+                -- someone presses a the key "a" then the backspace key in the same frame, in that order
+                -- the backspace occurs first
+                self"text".text = self"text".text:sub(1, self"text".text:len() - 1)
+
+            elseif k == "tab" then
+                -- @TODO
+
+            elseif k == "space" then
+                table.insert(chars, " ")
+
+            elseif k == "capslock" then
+                -- @OTOD
+            end
+        end
 
+        for _,c in pairs(chars) do
+            if not disallowed_chars[c] then
+                if self"text".text:len() <= max then
+                    self"text".text = self"text".text .. c
                 end
             end
         end
diff --git a/src/hexyz.lua b/src/hexyz.lua
index 87cdc82..8403f77 100644
--- a/src/hexyz.lua
+++ b/src/hexyz.lua
@@ -1,14 +1,26 @@
 
 
+-- this is a single file with no dependencies which is meant to perform a bunch of mathy stuff
+-- related to hexagons, grids of them, and pathfinding on them
+--
+-- it basically owes its entire existence to this resource: https://www.redblobgames.com/grids/hexagons/
+-- it uses some datatypes internal to the amulet game engine: http://www.amulet.xyz/
+-- (vec2, mat2)
+-- and some utility functions not present in your standard lua, like:
+--  table.append
+
 if not math.round then
     math.round = function(n) return math.floor(n + 0.5) end
 else
-    log("clobbering a math.round function.")
+    error("clobbering a math.round function, oopsie!")
+end
+
+if not table.append then
 end
 
 
 -- wherever 'orientation' appears as an argument, use one of these two, or set a default just below
-ORIENTATION = {
+HEX_ORIENTATION = {
     -- Forward & Inverse Matrices used for the Flat Orientation
     FLAT = {
         M = mat2(3.0/2.0, 0.0, 3.0^0.5/2.0, 3.0^0.5    ),
@@ -23,70 +35,71 @@ ORIENTATION = {
     }
 }
 
--- whenver |orientation| appears as an argument, if it isn't provided, this is used instead.
-local DEFAULT_ORIENTATION = ORIENTATION.FLAT
+-- whenever |orientation| appears as an argument, if it isn't provided, this is used instead.
+-- this is useful because most of the time you will only care about one orientation
+local HEX_DEFAULT_ORIENTATION = HEX_ORIENTATION.FLAT
 
 -- whenever |size| for a hexagon appears as an argument, if it isn't provided, use this
 -- 'size' here is distance from the centerpoint to any vertex in pixel
-local DEFAULT_HEX_SIZE = vec2(20)
+local HEX_DEFAULT_SIZE = vec2(20)
 
 -- actual width (longest contained horizontal line) of the hexagon
 function hex_width(size, orientation)
-    local orientation = orientation or DEFAULT_ORIENTATION
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
 
-    if orientation == ORIENTATION.FLAT then
+    if orientation == HEX_ORIENTATION.FLAT then
         return size * 2
 
-    elseif orientation == ORIENTATION.POINTY then
+    elseif orientation == HEX_ORIENTATION.POINTY then
         return math.sqrt(3) * size
     end
 end
 
 -- actual height (tallest contained vertical line) of the hexagon
 function hex_height(size, orientation)
-    local orientation = orientation or DEFAULT_ORIENTATION
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
 
-    if orientation == ORIENTATION.FLAT then
+    if orientation == HEX_ORIENTATION.FLAT then
         return math.sqrt(3) * size
 
-    elseif orientation == ORIENTATION.POINTY then
+    elseif orientation == HEX_ORIENTATION.POINTY then
         return size * 2
     end
 end
 
 -- returns actual width and height of a hexagon given it's |size| which is the distance from the centerpoint to any vertex in pixels
 function hex_dimensions(size, orientation)
-    local orientation = orientation or DEFAULT_ORIENTATION
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
     return vec2(hex_width(size, orientation), hex_height(size, orientation))
 end
 
 -- distance between two horizontally adjacent hexagon centerpoints
 function hex_horizontal_spacing(size, orientation)
-    local orientation = orientation or DEFAULT_ORIENTATION
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
 
-    if orientation == ORIENTATION.FLAT then
+    if orientation == HEX_ORIENTATION.FLAT then
         return hex_width(size, orientation) * 3/4
 
-    elseif orientation == ORIENTATION.POINTY then
+    elseif orientation == HEX_ORIENTATION.POINTY then
         return hex_height(size, orientation)
     end
 end
 
 -- distance between two vertically adjacent hexagon centerpoints
 function hex_vertical_spacing(size, orientation)
-    local orientation = orientation or DEFAULT_ORIENTATION
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
 
-    if orientation == ORIENTATION.FLAT then
+    if orientation == HEX_ORIENTATION.FLAT then
         return hex_height(size, orientation)
 
-    elseif orientation == ORIENTATION.POINTY then
+    elseif orientation == HEX_ORIENTATION.POINTY then
         return hex_width(size, orientation) * 3/4
     end
 end
 
 -- returns the distance between adjacent hexagon centers in a grid
 function hex_spacing(size, orientation)
-    local orientation = orientation or DEFAULT_ORIENTATION
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
     return vec2(hex_horizontal_spacing(size, orientation), hex_vertical_spacing(size, orientation))
 end
 
@@ -137,19 +150,19 @@ end
 
 -- Hex to Screen -- Orientation Must be Either POINTY or FLAT
 function hex_to_pixel(hex, size, orientation)
-    local M = orientation and orientation.M or DEFAULT_ORIENTATION.M
+    local M = orientation and orientation.M or HEX_DEFAULT_ORIENTATION.M
 
-    local x = (M[1][1] * hex[1] + M[1][2] * hex[2]) * (size and size[1] or DEFAULT_HEX_SIZE[1])
-    local y = (M[2][1] * hex[1] + M[2][2] * hex[2]) * (size and size[2] or DEFAULT_HEX_SIZE[2])
+    local x = (M[1][1] * hex[1] + M[1][2] * hex[2]) * (size and size[1] or HEX_DEFAULT_SIZE[1])
+    local y = (M[2][1] * hex[1] + M[2][2] * hex[2]) * (size and size[2] or HEX_DEFAULT_SIZE[2])
 
     return vec2(x, y)
 end
 
 -- Screen to Hex -- Orientation Must be Either POINTY or FLAT
 function pixel_to_hex(pix, size, orientation)
-    local W = orientation and orientation.W or DEFAULT_ORIENTATION.W
+    local W = orientation and orientation.W or HEX_DEFAULT_ORIENTATION.W
 
-    local pix = pix / (size or vec2(DEFAULT_HEX_SIZE))
+    local pix = pix / (size or vec2(HEX_DEFAULT_SIZE))
 
     local x = W[1][1] * pix[1] + W[1][2] * pix[2]
     local y = W[2][1] * pix[1] + W[2][2] * pix[2]
@@ -159,14 +172,14 @@ end
 
 -- TODO test, learn am.draw
 function hex_corner_offset(corner, size, orientation)
-    local orientation = orientation or DEFAULT_ORIENTATION
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
     local angle = 2.0 * math.pi * orientation.angle + corner / 6
     return vec2(size[1] * math.cos(angle), size[2] * math.sin(angle))
 end
 
 -- TODO test this thing
 function hex_corners(hex, size, orientation)
-    local orientation = orientation or DEFAULT_ORIENTATION
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
     local corners = {}
     local center = hex_to_pixel(hex, size, orientation)
     for i = 0, 5 do
@@ -220,7 +233,7 @@ end
 -- MAPS & STORAGE
 
 -- Returns Ordered Ring-Shaped Map of |radius| from |center|
-function ring_map(center, radius)
+function hex_ring_map(center, radius)
     local map = {}
 
     local walk = center + HEX_DIRECTIONS[6] * radius
@@ -235,21 +248,21 @@ function ring_map(center, radius)
 end
 
 -- Returns Ordered Spiral Hexagonal Map of |radius| Rings from |center|
-function spiral_map(center, radius)
+function hex_spiral_map(center, radius)
     local map = { center }
 
     for i = 1, radius do
-        table.append(map, ring_map(center, i))
+        table.append(map, hex_ring_map(center, i))
     end
     return setmetatable(map, {__index={center=center, radius=radius}})
 end
 
-local function map_get(map, hex, y)
+function hex_map_get(map, hex, y)
     if y then return map[hex] and map[hex][y] end
     return map[hex.x] and map[hex.x][hex.y]
 end
 
-local function map_set(map, hex, y, v)
+function hex_map_set(map, hex, y, v)
     if v then
         if map[hex] then
             map[hex][y] = v
@@ -268,7 +281,7 @@ local function map_set(map, hex, y, v)
 end
 
 -- Returns Unordered Parallelogram-Shaped Map of |width| and |height| with Simplex Noise
-function parallelogram_map(width, height, seed)
+function hex_parallelogram_map(width, height, seed)
     local seed = seed or math.random(width * height)
 
     local map = {}
@@ -296,14 +309,14 @@ function parallelogram_map(width, height, seed)
         seed = seed,
         neighbours = function(hex)
             return table.filter(hex_neighbours(hex), function(_hex)
-                return map_get(map, _hex)
+                return hex_map_get(map, _hex)
             end)
         end
     }})
 end
 
 -- Returns Unordered Triangular (Equilateral) Map of |size| with Simplex Noise
-function triangular_map(size, seed)
+function hex_triangular_map(size, seed)
     local seed = seed or math.random(size * math.cos(size) / 2)
 
     local map = {}
@@ -330,14 +343,14 @@ function triangular_map(size, seed)
         seed = seed,
         neighbours = function(hex)
             return table.filter(hex_neighbours(hex), function(_hex)
-                return map_get(map, _hex)
+                return hex_map_get(map, _hex)
             end)
         end
     }})
 end
 
 -- Returns Unordered Hexagonal Map of |radius| with Simplex Noise
-function hexagonal_map(radius, seed)
+function hex_hexagonal_map(radius, seed)
     local seed = seed or math.random(radius * 2 * math.pi)
 
     local map = {}
@@ -369,7 +382,7 @@ function hexagonal_map(radius, seed)
         seed = seed,
         neighbours = function(hex)
             return table.filter(hex_neighbours(hex), function(_hex)
-                return map_get(map, _hex.x, _hex.y)
+                return hex_map_get(map, _hex.x, _hex.y)
             end)
         end
     }})
@@ -377,37 +390,43 @@ end
 
 -- Returns Unordered Rectangular Map of |width| and |height| with Simplex Noise
 -- @TODO - this doesn't work for pointy orientations
-function rectangular_map(width, height, seed)
+function hex_rectangular_map(width, height, orientation, seed)
+    local orientation = orientation or HEX_DEFAULT_ORIENTATION
     local seed = seed or math.random(width * height)
 
     local map = {}
-    for i = 0, width - 1 do
-        map[i] = {}
-        for j = 0, height - 1 do
-
-            -- Begin to Calculate Noise
-            local idelta = i / width
-            local jdelta = j / height
-            local noise = 0
-
-            for oct = 1, 6 do
-                local f = 2/3^oct
-                local l = 2^oct
-                local pos = vec2(idelta + seed * width, jdelta + seed * height)
-                noise = noise + f * math.simplex(pos * l)
+    if orientation == HEX_ORIENTATION.FLAT then
+        for i = 0, width - 1 do
+            map[i] = {}
+            for j = 0, height - 1 do
+
+                -- begin to calculate noise
+                local idelta = i / width
+                local jdelta = j / height
+                local noise = 0
+
+                for oct = 1, 6 do
+                    local f = 2/3^oct
+                    local l = 2^oct
+                    local pos = vec2(idelta + seed * width, jdelta + seed * height)
+                    noise = noise + f * math.simplex(pos * l)
+                end
+                j = j - math.floor(i/2) -- this is what makes it rectangular
+
+                map[i][j] = noise
             end
-            j = j - math.floor(i/2) -- this is what makes it rectangular
-
-            map[i][j] = noise
         end
+    elseif orientation == HEX_ORIENTATION.POINTY then
+        error("don't use this, it's broken")
     end
+
     return setmetatable(map, { __index = {
         width = width,
         height = height,
         seed = seed,
         neighbours = function(hex)
             return table.filter(hex_neighbours(hex), function(_hex)
-                return map_get(map, _hex)
+                return hex_map_get(map, _hex)
             end)
         end
     }})
@@ -415,25 +434,30 @@ end
 
 --============================================================================
 -- PATHFINDING
-
-
-function breadth_first(map, start)
+-- note:
+--  i kinda feel like after implementing these and making the game, there are tons of reasons
+--  why you might want to specialize pathfinding, like you would any other kind of algorithm
+--
+--  so, while (in theory) these algorithms work with the maps in this file, your maps and game
+--  will have lots of other data which you may want your pathfinding algorithms to care about in some way,
+--  that these don't.
+--
+function hex_breadth_first(map, start)
     local frontier = {}
     frontier[1] = start
 
     local distance = {}
-    distance[start.x] = {}
-    distance[start.x][start.y] = 0
+    hex_map_set(distance, start, 0)
 
     while not (#frontier == 0) do
         local current = table.remove(frontier, 1)
 
         for _,neighbour in pairs(map.neighbours(current)) do
-            local d = map_get(distance, neighbour.x, neighbour.y)
+            local d = hex_map_get(distance, neighbour.x, neighbour.y)
             if not d then
                 table.insert(frontier, neighbour)
-                local current_distance = map_get(distance, current.x, current.y)
-                map_set(distance, neighbour.x, neighbour.y, current_distance + 1)
+                local current_distance = hex_map_get(distance, current.x, current.y)
+                hex_map_set(distance, neighbour.x, neighbour.y, current_distance + 1)
             end
         end
     end
@@ -441,17 +465,15 @@ function breadth_first(map, start)
     return distance
 end
 
-function dijkstra(map, start, goal, cost_f, neighbour_f)
+function hex_dijkstra(map, start, goal, cost_f, neighbour_f)
     local frontier = {}
     frontier[1] = { hex = start, priority = 0 }
 
     local came_from = {}
-    came_from[start.x] = {}
-    came_from[start.x][start.y] = false
+    hex_map_set(came_from, start, false)
 
     local cost_so_far = {}
-    cost_so_far[start.x] = {}
-    cost_so_far[start.x][start.y] = 0
+    hex_map_set(cost_so_far, start, 0)
 
     while not (#frontier == 0) do
         local current = table.remove(frontier, 1)
@@ -461,14 +483,14 @@ function dijkstra(map, start, goal, cost_f, neighbour_f)
         end
 
         for _,neighbour in pairs(neighbour_f(map, current.hex)) do
-            local new_cost = map_get(cost_so_far, current.hex) + cost_f(map, current.hex, neighbour)
-            local neighbour_cost = map_get(cost_so_far, neighbour)
+            local new_cost = hex_map_get(cost_so_far, current.hex) + cost_f(map, current.hex, neighbour)
+            local neighbour_cost = hex_map_get(cost_so_far, neighbour)
 
             if not neighbour_cost or (new_cost < neighbour_cost) then
-                map_set(cost_so_far, neighbour, new_cost)
+                hex_map_set(cost_so_far, neighbour, new_cost)
                 local priority = new_cost + math.distance(start, neighbour)
                 table.insert(frontier, { hex = neighbour, priority = priority })
-                map_set(came_from, neighbour, current)
+                hex_map_set(came_from, neighbour, current)
             end
         end
     end
@@ -476,7 +498,7 @@ function dijkstra(map, start, goal, cost_f, neighbour_f)
     return came_from
 end
 
--- generic A* pathfinding
+-- A* pathfinding
 --
 --  |heuristic| has the form:
 --  function(source, target)     -- source and target are vec2's
@@ -486,20 +508,15 @@ end
 --  function (from, to)         -- from and to are vec2's
 --      return some numeric value
 --
--- returns a map that has map[hex.x][hex.y] = { hex = vec2, priority = number },
--- where the hex is the spot it thinks you should go to from the indexed hex, and priority is the cost of that decision,
--- as well as 'made_it' a bool that tells you if we were successful in reaching |goal|
-function Astar(map, start, goal, heuristic, cost_f)
+function hex_Astar(map, start, goal, heuristic, cost_f)
     local path = {}
-    path[start.x] = {}
-    path[start.x][start.y] = false
+    hex_map_set(path, start, false)
 
     local frontier = {}
     frontier[1] = { hex = start, priority = 0 }
 
     local path_so_far = {}
-    path_so_far[start.x] = {}
-    path_so_far[start.x][start.y] = 0
+    hex_map_set(path_so_far, start, 0)
 
     local made_it = false
     while not (#frontier == 0) do
@@ -511,14 +528,14 @@ function Astar(map, start, goal, heuristic, cost_f)
         end
 
         for _,next_ in pairs(map.neighbours(current.hex)) do
-            local new_cost = map_get(path_so_far, current.hex.x, current.hex.y) + cost_f(map, current.hex, next_)
-            local next_cost = map_get(path_so_far, next_.x, next_.y)
+            local new_cost = hex_map_get(path_so_far, current.hex.x, current.hex.y) + cost_f(map, current.hex, next_)
+            local next_cost = hex_map_get(path_so_far, next_.x, next_.y)
 
             if not next_cost or new_cost < next_cost then
-                map_set(path_so_far, next_.x, next_.y, new_cost)
+                hex_map_set(path_so_far, next_.x, next_.y, new_cost)
                 local priority = new_cost + heuristic(goal, next_)
                 table.insert(frontier, { hex = next_, priority = priority })
-                map_set(path, next_.x, next_.y, current)
+                hex_map_set(path, next_.x, next_.y, current)
             end
         end
     end
diff --git a/src/mob.lua b/src/mob.lua
index b0aa007..986cf5f 100644
--- a/src/mob.lua
+++ b/src/mob.lua
@@ -7,7 +7,7 @@ MOB_TYPE = {
     SPOODER = 2
 }
 
-MAX_MOB_SIZE = hex_height(HEX_SIZE, ORIENTATION.FLAT) / 2
+MAX_MOB_SIZE = hex_height(HEX_SIZE, HEX_ORIENTATION.FLAT) / 2
 MOB_SIZE = MAX_MOB_SIZE
 
 MOB_SPECS = {
@@ -63,7 +63,7 @@ end
 
 -- check if a the tile at |hex| is passable by |mob|
 function mob_can_pass_through(mob, hex)
-    local tile = map_get(state.map, hex)
+    local tile = hex_map_get(state.map, hex)
     return tile_is_medium_elevation(tile)
 end
 
@@ -158,7 +158,7 @@ local function resolve_frame_target_for_mob(mob, mob_index)
         local frame_target, tile = false, false
         if mob.path then
             -- we (should) have an explicitly stored target
-            local path_entry = map_get(mob.path, mob.hex)
+            local path_entry = hex_map_get(mob.path, mob.hex)
 
             if not path_entry then
                 -- we should be just about to reach the target, delete the path.
@@ -180,12 +180,12 @@ local function resolve_frame_target_for_mob(mob, mob_index)
 
             if #neighbours > 0 then
                 local first_neighbour = neighbours[1]
-                tile = map_get(state.map, first_neighbour)
+                tile = hex_map_get(state.map, first_neighbour)
                 local lowest_cost_hex = first_neighbour
                 local lowest_cost = tile.priority or 0
 
                 for _,n in pairs(neighbours) do
-                    tile = map_get(state.map, n)
+                    tile = hex_map_get(state.map, n)
 
                     if not tile.priority then
                         -- if there's no stored priority, that should mean it's the center tile
@@ -247,8 +247,8 @@ local function update_mob_beeper(mob, mob_index)
         -- or between when we last calculated this target and now
         -- check for that now
         if mob_can_pass_through(mob, mob.frame_target) then
-            local from = map_get(state.map, mob.hex)
-            local to = map_get(state.map, mob.frame_target)
+            local from = hex_map_get(state.map, mob.hex)
+            local to = hex_map_get(state.map, mob.frame_target)
             local rate = (4 * mob.speed - math.abs(to.elevation - from.elevation)) * am.delta_time
 
             mob.position = mob.position + math.normalize(hex_to_pixel(mob.frame_target, vec2(HEX_SIZE)) - mob.position) * rate
diff --git a/src/projectile.lua b/src/projectile.lua
index b716b95..0b01dc1 100644
--- a/src/projectile.lua
+++ b/src/projectile.lua
@@ -85,7 +85,7 @@ local function update_projectile_shell(projectile, projectile_index)
     -- right now, it's just the hex we're on and all of its neighbours.
     -- this is done to avoid having to check every mob on screen, though maybe it's not necessary.
     local do_explode = false
-    local search_hexes = spiral_map(projectile.hex, 1)
+    local search_hexes = hex_spiral_map(projectile.hex, 1)
     local mobs = {}
     for _,hex in pairs(search_hexes) do
         for index,mob in pairs(mobs_on_hex(hex)) do
@@ -103,7 +103,7 @@ local function update_projectile_shell(projectile, projectile_index)
         end
     end
 
-    local tile = map_get(state.map, projectile.hex)
+    local tile = hex_map_get(state.map, projectile.hex)
     if tile and tile.elevation >= projectile.props.z then
         --do_explode = true
 
@@ -143,7 +143,7 @@ local function update_projectile_laser(projectile, projectile_index)
     -- get a list of hexes that could have something we could hit on them
     -- right now, it's just the hex we're on and all of its neighbours.
     -- this is done to avoid having to check every mob on screen, though maybe it's not necessary.
-    local search_hexes = spiral_map(projectile.hex, 1)
+    local search_hexes = hex_spiral_map(projectile.hex, 1)
     local hit_mob_count = 0
     local hit_mobs = {}
     for _,hex in pairs(search_hexes) do
diff --git a/src/tower.lua b/src/tower.lua
index 506c662..f55247c 100644
--- a/src/tower.lua
+++ b/src/tower.lua
@@ -131,9 +131,9 @@ function make_tower_node(tower_type)
 
     elseif tower_type == TOWER_TYPE.HOWITZER then
         return am.group{
-            am.circle(vec2(0), HEX_SIZE, COLORS.VERY_DARK_GRAY, 6),
+            am.circle(vec2(0), HEX_SIZE, COLORS.VERY_DARK_GRAY{a=0.8}, 6),
             am.rotate(state.time or 0) ^ am.group{
-                pack_texture_into_sprite(TEXTURES.CANNON1, HEX_PIXEL_HEIGHT, HEX_PIXEL_WIDTH*2) -- CHONK
+                pack_texture_into_sprite(TEXTURES.CANNON1, HEX_PIXEL_HEIGHT*2, HEX_PIXEL_WIDTH*3) -- CHONK
             }
         }
     elseif tower_type == TOWER_TYPE.LIGHTHOUSE then
@@ -276,11 +276,11 @@ function tower_type_is_buildable_on(hex, tile, tower_type)
     local has_mountain = false
     local has_ground = false
 
-    for _,h in pairs(spiral_map(hex, get_tower_size(tower_type))) do
+    for _,h in pairs(hex_spiral_map(hex, get_tower_size(tower_type))) do
         table.merge(blocking_towers, towers_on_hex(h))
         table.merge(blocking_mobs, mobs_on_hex(h))
 
-        local tile = map_get(state.map, h)
+        local tile = hex_map_get(state.map, h)
         -- this should always be true, unless it is possible to place a tower
         -- where part of the tower overflows the edge of the map
         if tile then
@@ -332,7 +332,7 @@ function tower_type_is_buildable_on(hex, tile, tower_type)
     elseif tower_type == TOWER_TYPE.LIGHTHOUSE then
         local has_water_neighbour = false
         for _,h in pairs(hex_neighbours(hex)) do
-            local tile = map_get(state.map, h)
+            local tile = hex_map_get(state.map, h)
 
             if tile and tile.elevation < -0.5 then
                 has_water_neighbour = true
@@ -442,7 +442,7 @@ function update_tower_lighthouse(tower, tower_index)
                 -- is within some angle range...? if the mob is heading directly away from the tower, then
                 -- the lighthouse shouldn't do much
 
-                local path, made_it = Astar(state.map, tower.hex, m.hex, grid_heuristic, grid_cost)
+                local path, made_it = hex_Astar(state.map, tower.hex, m.hex, grid_heuristic, grid_cost)
 
                 if made_it then
                     m.path = path
@@ -485,17 +485,20 @@ function make_and_register_tower(hex, tower_type)
     if tower.size == 0 then
         tower.hexes = { tower.hex }
     else
-        tower.hexes = spiral_map(tower.hex, tower.size)
+        tower.hexes = hex_spiral_map(tower.hex, tower.size)
     end
     tower.height = spec.height
 
     for _,h in pairs(tower.hexes) do
-        local tile = map_get(state.map, h.x, h.y)
+        local tile = hex_map_get(state.map, h.x, h.y)
         tile.elevation = tile.elevation + tower.height
     end
 
     if tower.type == TOWER_TYPE.HOWITZER then
         tower.props.z = tower.height
+
+    elseif tower.type == TOWER_TYPE.LIGHTHOUSE then
+        tower.perimeter = hex_ring_map(tower.hex, tower.range)
     end
 
     register_entity(state.towers, tower)
diff --git a/texture.lua b/texture.lua
index f3bae30..c22c8dd 100644
--- a/texture.lua
+++ b/texture.lua
@@ -13,6 +13,7 @@ end
 TEXTURES = {
     LOGO                    = load_texture("res/logo.png"),
     GEM1                    = load_texture("res/gem1.png"),
+    SHADED_HEX              = load_texture("res/shaded_hex1.png"),
 
     -- gui stuff
     BUTTON1                 = load_texture("res/button1.png"),