Add Blur and Grid Transformation

app.py

@@ -46,6 +46,7 @@ from utils.misc import (
 
 from utils.image_utils import (
     change_color,
+    blur_image,
     open_image,
     upscale_image,
     lerp_imagemath,
@@ -67,7 +68,8 @@ from utils.image_utils import (
 from utils.hex_grid import (
     generate_hexagon_grid,
     generate_hexagon_grid_interface,
-    map_sides
+    map_sides,
+    transform_grid
 )
 
 from utils.excluded_colors import (
@@ -1221,6 +1223,7 @@ with gr.Blocks(css_paths="style_20250314.css", title=title, theme='Surn/beeuty',
                             height=120)
                 with gr.Row():
                     lut_intensity = gr.Slider(label="Filter Intensity", minimum=-200, maximum=200, value=100, info="0 none, negative inverts the filter", interactive=True)
+                with gr.Row():
                     apply_lut_button = gr.Button("Apply Filter  to Input Image", elem_classes="solid", elem_id="apply_lut_button")
                     apply_lut_to_sketch_button = gr.Button("Apply Filter to Sketch", elem_classes="solid", elem_id="apply_lut_to_sketch_button")
                 with gr.Row():
@@ -1261,7 +1264,14 @@ with gr.Blocks(css_paths="style_20250314.css", title=title, theme='Surn/beeuty',
                     composite_color = gr.ColorPicker(label="Color", value="#ede9ac44")
                     composite_opacity = gr.Slider(label="Opacity %", minimum=0, maximum=100, value=50, interactive=True)
                 with gr.Row():
-                    composite_button = gr.Button("Composite", elem_classes="solid")
+                    composite_button = gr.Button("Composite to Input Image", elem_classes="solid")
+                    composite_sketch_button = gr.Button("Composite to Sketh", elem_classes="solid")
+            with gr.Accordion("Blur", open = False):
+                with gr.Row():                    
+                    blur_amount = gr.Slider(label="Blur Amount", minimum=0, maximum=100, value=5, interactive=True)
+                with gr.Row():
+                    blur_button = gr.Button("Blur Input Image", elem_classes="solid")
+                    blur_sketch_button = gr.Button("Blur Sketch", elem_classes="solid")
     with gr.Row(elem_id="image_gen"):
         with gr.Accordion("Generate AI Image (optional, fun)", open = False):
             with gr.Row():
@@ -1324,14 +1334,14 @@ with gr.Blocks(css_paths="style_20250314.css", title=title, theme='Surn/beeuty',
                         label="Prompt",
                         visible=False,
                         elem_classes="solid",
-                        value="Planetary overhead view, directly from above, centered on the planet’s surface, (rectangular tabletop_map) alien planet map, Battletech_boardgame scifi world with forests, lakes, oceans, continents and snow at the top and bottom, (middle is dark, no_reflections, no_shadows), looking straight down.",
+                        value="Planetary overhead view, directly from above, centered on the planet’s surface, orthographic (rectangular tabletop_map) alien planet map, Battletech_boardgame scifi world with forests, lakes, oceans, continents and snow at the top and bottom, (middle is dark, no_reflections, no_shadows), looking straight down.",
                         lines=4
                     )
                     negative_prompt_textbox = gr.Textbox(
                         label="Negative Prompt",
                         visible=False,
                         elem_classes="solid",
-                        value="Earth, low quality, bad anatomy, blurry, cropped, worst quality, shadows, people, humans, reflections, shadows, realistic map of the Earth, isometric, text"
+                        value="Earth, low quality, bad anatomy, blurry, cropped, worst quality, shadows, people, humans, reflections, shadows, realistic map of the Earth, isometric, text, camera_angle"
                     )
                     prompt_notes_label = gr.Label(
                         "You should use FRM$ as trigger words. @1.5 minutes",
@@ -1425,11 +1435,16 @@ with gr.Blocks(css_paths="style_20250314.css", title=title, theme='Surn/beeuty',
             hex_button = gr.Button("Generate Hex Grid!", elem_classes="solid", elem_id="btn-generate")
         with gr.Row():
             output_image = gr.Image(label="Hexagon Grid Image", image_mode = "RGBA", elem_classes="centered solid imgcontainer", format="PNG", type="filepath", key="ImgOutput",interactive=True)
-            overlay_image = gr.Image(label="Hexagon Overlay Image", image_mode = "RGBA", elem_classes="centered solid imgcontainer", format="PNG", type="filepath", key="ImgOverlay",interactive=True)
-        with gr.Row():
-            output_blend_multiply_composite = gr.Slider(0,100,50,0.5, label="Multiply Intensity*")
-            output_overlay_composite = gr.Slider(0,100,50,0.5, label="Interpolate Intensity")
-            output_alpha_composite = gr.Slider(0,100,50,0.5, label="Alpha Composite Intensity")
+            overlay_image = gr.Image(label="Hexagon Overlay Image", image_mode = "RGBA", elem_classes="centered solid imgcontainer", format="PNG", type="filepath", key="ImgOverlay",interactive=True)        
+        with gr.Accordion("Grid adjustments", open=True):
+            with gr.Row():
+                with gr.Column(scale=1):
+                    output_grid_tilt = gr.Slider(minimum=-90, maximum=90, value=0, step=0.05, label="Tilt Angle (degrees)")
+                    output_grid_rotation = gr.Slider(minimum=-180, maximum=180, value=0, step=0.05, label="Rotation Angle (degrees)")
+                with gr.Column(scale=1):
+                    output_alpha_composite = gr.Slider(0,100,50,0.5, label="Alpha Composite Intensity*")
+                    output_blend_multiply_composite = gr.Slider(0,100,50,0.5, label="Multiply Intensity")
+                    output_overlay_composite = gr.Slider(0,100,50,0.5, label="Interpolate Intensity")            
     with gr.Accordion("Add Margins (for printing)", open=False):
         with gr.Row():
             border_image_source = gr.Radio(label="Add Margins around which Image", choices=["Input Image", "Overlay Image"], value="Overlay Image")
@@ -1492,13 +1507,14 @@ with gr.Blocks(css_paths="style_20250314.css", title=title, theme='Surn/beeuty',
     ddd_file_name = gr.State("Hexagon_file")
     with gr.Row():
         gr.Examples(examples=[
-            ["assets//examples//hex_map_p1.png", False, True, -32,-31,80,80,-1.8,0,35,0,1,"#FFD0D0", 15],
-            ["assets//examples//hex_map_p1_overlayed.png", False, False, -32,-31,80,80,-1.8,0,35,0,1,"#FFD0D0", 75],
-            ["assets//examples//hex_flower_logo.png", False, True, -95,-95,100,100,-24,-2,190,30,2,"#FF8951", 50],
-            ["assets//examples//hexed_fract_1.png", False, True, 0,0,0,0,0,0,10,0,0,"#000000", 5],
-            ["assets//examples//tmpzt3mblvk.png", False, True, -20,10,0,0,-6,-2,35,30,1,"#ffffff", 0],
+            ["assets//examples//hex_map_p1.png", False, True, -32,-31,80,80,-1.8,0,35,0,1,"#FFD0D0", 15,0,0],
+            ["assets//examples//hex_map_p1_overlayed.png", False, False, -32,-31,80,80,-1.8,0,35,0,1,"#FFD0D0", 75,0,0],
+            ["assets//examples//hex_flower_logo.png", False, True, -95,-95,100,100,-24,-2,190,30,2,"#FF8951", 50,0,0],
+            ["assets//examples//hexed_fract_1.png", False, True, 0,0,0,0,0,0,10,0,0,"#000000", 5,0,0],
+            ["assets//examples//tmpzt3mblvk.png", False, True, -20,10,0,0,-6,-2,35,30,1,"#ffffff", 0,0,0],
+            ["assets//examples//scifi_city_dof.png", False, False, -95,-95,150,150,-14,1,100,-45,2,"#808080",70,0,45.0 ],
             ],
-            inputs=[input_image, filter_color, fill_hex, start_x, start_y, end_x, end_y, x_spacing, y_spacing, hex_size, rotation, border_size, border_color, border_opacity],
+            inputs=[input_image, filter_color, fill_hex, start_x, start_y, end_x, end_y, x_spacing, y_spacing, hex_size, rotation, border_size, border_color, border_opacity, output_grid_tilt, output_grid_rotation],
             elem_id="examples")
     # with gr.Row():
     #     login_button = gr.LoginButton(size="sm", elem_classes="solid centered", elem_id="hf_login_btn")
@@ -1551,27 +1567,14 @@ with gr.Blocks(css_paths="style_20250314.css", title=title, theme='Surn/beeuty',
         inputs=[sketch_image],
         outputs=[input_image], scroll_to_output=True
     )
-    # sketch_replace_lut_example_image_button.click(
-    #     lambda sketch_image: replace_with_sketch_image(sketch_image, True),
-    #     inputs=[sketch_image],
-    #     outputs=[lut_example_image], scroll_to_output=True
-    # )
+
     ##################### model #######################################
     model_textbox.change(
         fn=update_prompt_notes,
         inputs=model_textbox,
         outputs=prompt_notes_label,preprocess=False
     )
-    # model_options.change(
-    #     fn=lambda x: (gr.update(visible=(x == "Manual Entry")), gr.update(value=x) if x != "Manual Entry" else gr.update()),
-    #     inputs=model_options,
-    #     outputs=[model_textbox, model_textbox]
-    # )
-    # model_options.change(
-    #     fn=update_prompt_notes,
-    #     inputs=model_options,
-    #     outputs=prompt_notes_label
-    # )
+
     lora_gallery.select(
         fn=update_selection,
         inputs=[image_size_ratio],
@@ -1579,13 +1582,27 @@ with gr.Blocks(css_paths="style_20250314.css", title=title, theme='Surn/beeuty',
     )
 
     #################### model end ########################################
-
+    ########### special effects ###############
     composite_button.click(
         fn=lambda input_image, composite_color, composite_opacity: gr.Warning("Please upload an Input Image to get started.") if input_image is None else change_color(input_image, composite_color, composite_opacity),
         inputs=[input_image, composite_color, composite_opacity],
         outputs=[input_image]
     )
-
+    composite_sketch_button.click(
+        fn=lambda sketch_image, composite_color, composite_opacity: gr.Warning("Please upload an Sketch Image to get started.") if Sketch_image is None else change_color(sketch_image, composite_color, composite_opacity),
+        inputs=[sketch_image, composite_color, composite_opacity],
+        outputs=[sketch_image]
+    )
+    blur_button.click(
+        fn=lambda input_image, blur_amount: gr.Warning("Please upload an Input Image to get started.") if input_image is None else blur_image(input_image, blur_amount),
+        inputs=[input_image, blur_amount],
+        outputs=[input_image])
+    blur_sketch_button.click(
+        fn=lambda sketch_image, blur_amount: gr.Warning("Please upload an Sketch Image to get started.") if sketch_image is None else blur_image(sketch_image, blur_amount),
+        inputs=[sketch_image, blur_amount],
+        outputs=[sketch_image])
+
+    ################ end special effects ############################
     #use conditioned_image as the input_image for generate_input_image_click
     generate_input_image_from_gallery.click(
         fn=unload_3d_models,
@@ -1618,6 +1635,17 @@ with gr.Blocks(css_paths="style_20250314.css", title=title, theme='Surn/beeuty',
         inputs=[input_image, sketch_image],
         outputs=[sketch_image, sketch_image]
     )
+
+    output_grid_tilt.change(
+        fn=transform_grid,
+        inputs=[output_image, output_grid_tilt, output_grid_rotation],
+        outputs=[output_image]
+    )
+    output_grid_rotation.change(
+        fn=transform_grid,
+        inputs=[output_image, output_grid_tilt, output_grid_rotation],
+        outputs=[output_image]
+    )
     output_overlay_composite.change(
         fn=combine_images_with_lerp,
         inputs=[input_image, output_image, output_overlay_composite],

utils/constants.py

@@ -69,32 +69,32 @@ os.makedirs(TMPDIR, exist_ok=True)
 
 
 PROMPTS = {
-    "Mecha Wasteland Arena": "Regional overhead view, directly from above, centered on the map, of a Mecha battlefield map. post-industrial wasteland with crumbling structures, volcanic ridges, scrapyards, and ash plains. Features elevated overwatch positions for long-range combat and tight brawling areas for close-quarters engagements. Partial edge hexes are black. Colors: red, gray, muted orange, ash white, dark brown.",
-    "BorderBlack": "Planetary overhead view, directly from above, centered on the planet’s surface, of a hexagon-based alien world map with black borders. Features rivers, mountains, volcanoes, and polar snow regions. Colors: light blue, green, tan, brown. No reflections or shadows. Partial edge hexes are black.",
-    "Earth": "Planetary overhead view, directly from above, centered on the planet’s surface, of an Earth-like world map with rivers, mountains, volcanoes, and polar snow regions. Colors: light blue, green, tan, brown. No reflections or shadows. Partial edge hexes are black.",
-    "Beeuty": "Regional overhead view, directly from above, centered on the map, of a tabletop gaming map with honeycomb-shaped terrain, lakes, dense forests, magical flora, and hex grids. Designed for clarity and strategic gameplay. Colors: yellow, green, purple, brown. Partial edge hexes are black.",
-    "Scifi City": "Regional overhead view, directly from above, centered on the map, of a futuristic urban battlefield map with lakes, forests, ruined buildings, and city streets. Designed for clarity and strategic gameplay in tabletop games. Colors: teal, dark green, violet, brown. Partial edge hexes are black.",
-    "Alien Landscape": "Planetary overhead view, directly from above, centered on the planet’s surface, of a barren alien world map composed of hexagon tiles. Features light blue rivers, brown mountains, red volcanoes, and white polar snow. Colors: light blue, green, tan, brown. Partial edge hexes are black.",
-    "Alien World": "Planetary overhead view, directly from above, centered on the planet’s surface, of an alien world map built from hexagon tiles. Includes rivers, mountains, volcanoes, and snowy regions. Colors: light blue, green, tan, brown. Partial edge hexes are black.",
-    "Mystic Forest": "Regional overhead view, directly from above, centered on the map, of a mystic forest map with lakes, dense forests, magical flora, and hex grids. Designed for clarity and strategic gameplay in tabletop gaming. Colors: light blue, green, purple, brown. Partial edge hexes are black.",
-    "Medieval Battlefield": "Regional overhead view, directly from above, centered on the map, of a medieval battlefield map with lakes, forests, and magical fauna. Designed for clarity and strategic gameplay in tabletop games. Colors: teal, dark green, violet, brown. Partial edge hexes are black.",
-    "Dungeon Interior": "Regional overhead view, directly from above, centered on the map, of a dungeon interior map for tabletop gaming. Features stone walls, corridors, rooms with doors, traps, and treasure chests. Designed for clarity and strategic gameplay. Colors: gray, brown, dark blue. Partial edge hexes are black.",
-    "Desert Wasteland": "Regional overhead view, directly from above, centered on the map, of a desert wasteland map for tabletop gaming. Features sand dunes, rocky canyons, oases, and ancient ruins. Colors: yellow, tan, brown, blue, green. Partial edge hexes are black.",
+    "Mecha Wasteland Arena": "Regional overhead view, directly from above, centered on the map, orthographic Mecha battlefield map. post-industrial wasteland with crumbling structures, volcanic ridges, scrapyards, and ash plains. Features elevated overwatch positions for long-range combat and tight brawling areas for close-quarters engagements. Partial edge hexes are black. Colors: red, gray, muted orange, ash white, dark brown.",
+    "BorderBlack": "Planetary overhead view, directly from above, centered on the planet’s surface, orthographic hexagon-based alien world map with black borders. Features rivers, mountains, volcanoes, and polar snow regions. Colors: light blue, green, tan, brown. No reflections or shadows. Partial edge hexes are black.",
+    "Earth": "Planetary overhead view, directly from above, centered on the planet’s surface, orthographic Earth-like world map with rivers, mountains, volcanoes, and polar snow regions. Colors: light blue, green, tan, brown. No reflections or shadows. Partial edge hexes are black.",
+    "Beeuty": "Regional overhead view, directly from above, centered on the map, orthographic tabletop gaming map with honeycomb-shaped terrain, lakes, dense forests, magical flora, and hex grids. Designed for clarity and strategic gameplay. Colors: yellow, green, purple, brown. Partial edge hexes are black.",
+    "Scifi City": "Regional overhead view, directly from above, centered on the map, orthographic futuristic urban battlefield map with lakes, forests, ruined buildings, and city streets. Designed for clarity and strategic gameplay in tabletop games. Colors: teal, dark green, violet, brown. Partial edge hexes are black.",
+    "Alien Landscape": "Planetary overhead view, directly from above, centered on the planet’s surface, orthographic barren alien world map composed of hexagon tiles. Features light blue rivers, brown mountains, red volcanoes, and white polar snow. Colors: light blue, green, tan, brown. Partial edge hexes are black.",
+    "Alien World": "Planetary overhead view, directly from above, centered on the planet’s surface, orthographic alien world map built from hexagon tiles. Includes rivers, mountains, volcanoes, and snowy regions. Colors: light blue, green, tan, brown. Partial edge hexes are black.",
+    "Mystic Forest": "Regional overhead view, directly from above, centered on the map, orthographic mystic forest map with lakes, dense forests, magical flora, and hex grids. Designed for clarity and strategic gameplay in tabletop gaming. Colors: light blue, green, purple, brown. Partial edge hexes are black.",
+    "Medieval Battlefield": "Regional overhead view, directly from above, centered on the map, orthographic medieval battlefield map with lakes, forests, and magical fauna. Designed for clarity and strategic gameplay in tabletop games. Colors: teal, dark green, violet, brown. Partial edge hexes are black.",
+    "Dungeon Interior": "Regional overhead view, directly from above, centered on the map, orthographic dungeon interior map for tabletop gaming. Features stone walls, corridors, rooms with doors, traps, and treasure chests. Designed for clarity and strategic gameplay. Colors: gray, brown, dark blue. Partial edge hexes are black.",
+    "Desert Wasteland": "Regional overhead view, directly from above, centered on the map, orthographic desert wasteland map for tabletop gaming. Features sand dunes, rocky canyons, oases, and ancient ruins. Colors: yellow, tan, brown, blue, green. Partial edge hexes are black.",
     "Prompt": None  # Indicates that the prompt should be taken from prompt_textbox
 }
 
 NEGATIVE_PROMPTS = {
-    "Mecha Wasteland Arena": "humans, old_buildings, water, bright colors, text, logos, shadows, Earth geography, isometric",
-    "BorderBlack": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric",
-    "Earth": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, missing map of the Earth, isometric",
-    "Beeuty": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, map of the Earth, isometric",
-    "Scifi City": "humans, missing_buildings, vehicles, text, logos, reflections, shadows, Earth, isometric",
-    "Alien Landscape": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric",
-    "Alien World": "Earth, humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric",
-    "Mystic Forest": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric",
-    "Medieval Battlefield": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric",
-    "Dungeon Interior":"humans, modern_buildings, vehicles, text, logos, reflections, shadows, outdoor elements, realistic map of the Earth, isometric",
-    "Desert Wasteland":"humans, modern_buildings, vehicles, text, logos, reflections, shadows, lush forests, large bodies of water, snow, realistic map of the Earth, isometric",
+    "Mecha Wasteland Arena": "humans, old_buildings, water, bright colors, text, logos, shadows, Earth geography, isometric, camera_angle",
+    "BorderBlack": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric, camera_angle",
+    "Earth": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, missing map of the Earth, isometric, camera_angle",
+    "Beeuty": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, map of the Earth, isometric, camera_angle",
+    "Scifi City": "humans, missing_buildings, vehicles, text, logos, reflections, shadows, Earth, isometric, camera_angle",
+    "Alien Landscape": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric, camera_angle",
+    "Alien World": "Earth, humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric, camera_angle",
+    "Mystic Forest": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric, camera_angle",
+    "Medieval Battlefield": "humans, modern_buildings, vehicles, text, logos, reflections, shadows, realistic map of the Earth, isometric, camera_angle",
+    "Dungeon Interior":"humans, modern_buildings, vehicles, text, logos, reflections, shadows, outdoor elements, realistic map of the Earth, isometric, camera_angle",
+    "Desert Wasteland":"humans, modern_buildings, vehicles, text, logos, reflections, shadows, lush forests, large bodies of water, snow, realistic map of the Earth, isometric, camera_angle",
     "Prompt": None  # Indicates that the negative prompt should be taken from negative_prompt_textbox
 }
 

utils/hex_grid.py

@@ -5,17 +5,21 @@ from PIL import Image
 import cairocffi as cairo
 import pangocffi
 import pangocairocffi
+import numpy as np
+import cv2
 from PIL import Image, ImageDraw, ImageChops, ImageFont #, ImageColor
 #from pilmoji import Pilmoji  # Import Pilmoji for handling emojis
 from utils.excluded_colors import (
     excluded_color_list,
 )
-from utils.image_utils import multiply_and_blend_images
+from utils.image_utils import alpha_composite_with_control, open_image
 from utils.color_utils import update_color_opacity, parse_hex_color, draw_rotated_text_with_emojis, hex_to_rgb
 import random  # For random text options
 import utils.constants as constants  # Import constants
 import ast
 from utils.misc import number_to_letter
+from utils.file_utils import get_file_parts
+current_grid = None
 
 def calculate_font_size(hex_size, padding=0.6, size_ceil=20, min_font_size=8):
     """
@@ -71,8 +75,8 @@ def generate_hexagon_grid(hex_size, border_size, input_image=None, image_width=0
     draw = ImageDraw.Draw(image, mode="RGBA")
     hex_width = hex_size * 2
     hex_height = hex_size * 2
-    hex_horizontal_spacing = hex_width + (hex_border_size if hex_border_size < 0 else 0) + x_spacing #* 0.8660254
-    hex_vertical_spacing = hex_height + (hex_border_size if hex_border_size < 0 else 0) + y_spacing
+    hex_horizontal_spacing = (hex_width + (hex_border_size if hex_border_size < 0 else 0) + x_spacing) * ((6 / sides) if sides > 3 else 1.3333) #* 0.8660254
+    hex_vertical_spacing = (hex_height + (hex_border_size if hex_border_size < 0 else 0) + y_spacing) * ((6 / sides) if sides > 3 else 3.0)
     col = 0
     row = 0
     def draw_hexagon(x, y, color="#FFFFFFFF", rotation=0, outline_color="#12165380", outline_width=0, sides=6):
@@ -96,18 +100,19 @@ def generate_hexagon_grid(hex_size, border_size, input_image=None, image_width=0
             # Calculate offsets based on the number of sides
             if sides == 4:
                 # Squares line up perfectly; no vertical offset is needed.
-                x_offset = int(hex_width + hex_horizontal_spacing * 2)
+                x_offset = hex_size
                 y_offset = 0
                 rotation_offset = -45
             elif sides == 3:
                 # For equilateral triangles, you might offset rows by about one-third
                 # of the triangle�s height. Adjust as needed.
-                x_offset = hex_width + hex_horizontal_spacing
-                y_offset = int((hex_height * 2) + hex_vertical_spacing)
+                x_offset = -hex_border_size * 2 #hex_width * math.tan(math.pi / sides) - hex_border_size * 2
+                y_offset = -hex_border_size * 2
                 rotation_offset = -60
-                # Adjust y_offset for columns 1 and 3 to overlap
+                # Adjust y_offset for columns 1 and 2 to overlap
                 if col % 2 == 1:
-                    y_offset -= (hex_height // 2) #* 0.8660254
+                    x_offset += int(hex_size * 0.8660254)
+                    y_offset -= int(hex_height * 1.5) 
                     rotation_offset = 0
             else:
                 # Default behavior (6 sides)
@@ -468,5 +473,95 @@ def generate_hexagon_grid_interface(hex_size, border_size, image, start_x, start
         custom_text_list = custom_text_list,
         custom_text_color_list= custom_text_color_list, sides=sides
     )
-    overlay_image = multiply_and_blend_images(image, hexagon_grid_image, 50)
-    return hexagon_grid_image, overlay_image
+    overlay_image = alpha_composite_with_control(image, hexagon_grid_image, 50)
+    return hexagon_grid_image, overlay_image
+
+
+def transform_grid(grid_path, tilt_angle=0, rotation_angle=0):
+    """
+    Transform a 2D grid image with a perspective tilt and optional rotation.
+    
+    Args:
+        grid_path (str): Filepath to the 2D grid image.
+        tilt_angle (float): Tilt angle in degrees (0 to 90) for z-axis perspective.
+        rotation_angle (float): Rotation angle in degrees (0 to 360) in the x-y plane.
+    
+    Returns:
+        str: Filepath to the transformed grid image.
+    """
+    if grid_path is None or tilt_angle is None or rotation_angle is None:
+        return grid_path
+
+    global current_grid
+    if "_transform" not in grid_path:
+        #save current grid for next round
+        current_grid = grid_path
+    else:
+        grid_path = current_grid    
+
+    # Load the grid image
+    grid_original = open_image(grid_path).convert('RGBA')  # RGBA for transparency
+    grid = grid_original.copy()
+    width, height = grid.size
+
+    # Step 1: Rotate the grid in the x-y plane (around z-axis) if needed
+    if rotation_angle != 0:
+        grid = grid.rotate(rotation_angle, expand=True, fillcolor=(0, 0, 0, 0))
+        # Resize back to original dimensions if necessary
+        if grid.size != (width, height):
+            grid = grid.resize((width, height), Image.Resampling.LANCZOS)
+
+    # Step 2: Define the perspective transformation
+    # Original corners of the grid (in grid space)
+    src_pts = np.array([
+        [0, 0],           # Top-left
+        [width, 0],       # Top-right
+        [width, height],  # Bottom-right
+        [0, height]       # Bottom-left
+    ], dtype=np.float32)
+
+    # Calculate the perspective shift based on tilt_angle
+    # Tilt angle of 0 means no perspective (flat), 90 means extreme perspective
+    # We simulate the top moving away by shrinking the top width
+    perspective_factor = np.sin(np.radians(tilt_angle))  # 0 to 1
+    top_width_shrink = width * (1 - perspective_factor * 0.8)  # Shrink top by up to 80%
+    top_shift = (width - top_width_shrink) / 2
+
+    # Destination points after perspective transform
+    dst_pts = np.array([
+        [top_shift, 0],                    # Top-left
+        [width - top_shift, 0],            # Top-right
+        [width, height],                   # Bottom-right
+        [0, height]                        # Bottom-left
+    ], dtype=np.float32)
+
+    # Step 3: Compute the perspective transformation matrix
+    M = cv2.getPerspectiveTransform(src_pts, dst_pts)
+
+    # Step 4: Apply the perspective transformation using OpenCV
+    grid_np = np.array(grid)
+    transformed = cv2.warpPerspective(
+        grid_np,
+        M,
+        (width, height),
+        flags=cv2.INTER_LINEAR,
+        borderMode=cv2.BORDER_CONSTANT,
+        borderValue=(0, 0, 0, 0)  # Transparent background
+    )
+
+    # Step 5: Convert back to PIL image
+    transformed_image = Image.fromarray(transformed)
+
+    # Step 6: Save the result
+    directory, _, name, _, new_ext = get_file_parts(grid_path)
+    if constants.TMPDIR:
+        directory = constants.TMPDIR
+    #save original image to temp folder
+    # output_path = os.path.join(directory, name + new_ext)
+    # grid_original.save(output_path)
+    # save new image to temp folder
+    new_filename = name + "_transform" + new_ext
+    output_path = os.path.join(directory, new_filename)
+    transformed_image.save(output_path)
+
+    return output_path

utils/image_utils.py

@@ -10,7 +10,7 @@ from typing import List, Union, is_typeddict
 #import numpy as np
 #import math
 from pathlib import Path
-from utils.constants import default_lut_example_img, PRE_RENDERED_MAPS_JSON_LEVELS, BASE_HEIGHT
+from utils.constants import default_lut_example_img, PRE_RENDERED_MAPS_JSON_LEVELS, BASE_HEIGHT, TMPDIR
 from utils.color_utils import (
     detect_color_format,
     update_color_opacity
@@ -233,6 +233,42 @@ def change_color(image, color, opacity=0.75):
         return image
     return result
 
+def blur_image(input_path, radius=5, blur_type="gaussian"):
+    input_path, _ = get_image_from_dict(input_path)
+    directory, _, name, _, new_ext = get_file_parts(input_path)
+    # If the extension changes, rename the file
+    name = name + "_blur"
+    output_path = os.path.join(directory, name + new_ext)
+
+    try:
+        # Open and verify the image
+        with open_image(input_path) as img:
+            # Convert to RGB if needed (handles RGBA, etc.)
+            if img.mode in ('RGBA', 'P'):
+                img = img.convert('RGB')
+            
+            # Apply selected blur type
+            if blur_type.lower() == "gaussian":
+                blurred = img.filter(ImageFilter.GaussianBlur(radius=radius))
+            elif blur_type.lower() == "box":
+                blurred = img.filter(ImageFilter.BoxBlur(radius=radius))
+            elif blur_type.lower() == "simple":
+                blurred = img.filter(ImageFilter.BLUR)
+            else:
+                raise ValueError("Unsupported blur type")
+            
+            # Save with quality setting
+            blurred.save(output_path, quality=95)
+            print(f"Successfully blurred image saved to {output_path}")
+            
+    except FileNotFoundError:
+        print(f"Error: Input file '{input_path}' not found")
+        return None
+    except Exception as e:
+        print(f"Error processing image: {str(e)}")
+        return input_path
+    return output_path
+
 def convert_str_to_int_or_zero(value):
     """
     Converts a string to an integer, or returns zero if the conversion fails.
@@ -434,6 +470,8 @@ def multiply_and_blend_images(base_image, image2, alpha_percent=50):
     # Blend the multiplied result with the original
     blended_image = Image.blend(base_image, multiplied_image, alpha)
     if name is not None:
+        if TMPDIR:
+            directory = TMPDIR
         new_image_path = os.path.join(directory, name + f"_mb{str(alpha_percent)}.png")
         blended_image.save(new_image_path)
         return new_image_path
@@ -475,6 +513,8 @@ def alpha_composite_with_control(base_image, image_with_alpha, alpha_percent=100
     # Composite the images
     result = Image.alpha_composite(base_image, image_with_alpha)
     if name is not None:
+        if TMPDIR:
+            directory = TMPDIR
         new_image_path = os.path.join(directory, name + f"_alpha{str(alpha_percent)}.png")
         result.save(new_image_path)
         return new_image_path
@@ -890,6 +930,8 @@ def apply_lut_to_image_path(lut_filename: str, image_path: str, intensity: int =
 
     # Split the path into directory and filename
     directory, file_name = os.path.split(image_path)
+    if TMPDIR:
+        directory = TMPDIR
     lut_directory, lut_file_name = os.path.split(lut_filename)
     
     # Split the filename into name and extension