Maze Generator

Quick Start

1. Start simple: Click New Maze to see the baseline.
2. Add a pattern:
   • Go to Image → Upload and upload an image, or
   • Go to Text and add a text item.
3. Adjust the look:
   • Image → Thresholds: choose Edges/Dots/Lines, then tune the controls.
   • Maze Settings: change wall color/thickness and background.
4. Regenerate: Click New Maze (or Hard Mode for a tougher puzzle).
5. Play: Click ▶ Play and use the D-pad to reach the red square.

Maze Settings

Background

• Background Color / Opacity: controls the base fill behind the maze.
• Solid: just the color + opacity.
• Mirrored: uses the Image pattern as a background, aligned to Image placement settings.
• Custom Image: upload a separate background image with independent placement controls.

Wall

• Cell Size: maze resolution (smaller = more detail, slower).
• Wall Thickness / Opacity / Color: the rendered maze style.

Image

Preview strip

• Original: your uploaded image (or background-removed version, if applied).
• Filtered: the image after Filters + Placement.
• Edge / Processed: what Thresholds uses to decide where the maze follows your image.

Upload

• Image Upload: pick an image to drive the maze’s pattern.
• Reset Upload: clears the image and its derived previews.

Background Removal

• Remove Background: runs an AI segmentation model and applies the resulting mask.
• Restore Original: undo background removal.
• Refine with Depth: optionally refines the mask using depth estimation:
  • Depth Target (Near → Far): which depth slice to keep.
  • Tolerance (Precise → Fuzzy): how wide the kept depth band is.
• Mask Threshold / Edge Blur / Expand-Shrink: post-process the combined mask edges.
• Edit Mask: paint to remove/restore areas, then Apply.

Filters

• RGB levels: per-channel scaling.
• Brightness / Contrast: global tone adjustments.
• Posterize: reduce colors to fewer bands; Blend controls strength.
• Blur: softens before thresholding (use sparingly).
• Invert: invert after other filters.

Placement

• Maintain Aspect Ratio: preserve image proportions.
• Image Scale / Pan X / Pan Y: align the pattern with the maze canvas.

Thresholds

• Pattern Intensity: how strongly the pattern influences maze carving.
• Edges: uses edge detection to trace outlines.
• Dots: tone-based dotted pattern.
• Lines: tone-based hatch lines.
• Cleanup / Thickness: post-processing of the computed mask used to bias the maze.

Text

• Add Text: create a new text layer (supports multi-line).
• Move Up / Move Down: reorder text layers.
• Delete: remove the selected text layer.
• Size / Letter Spacing: controls the text pattern scale.
• Font / Style: choose the typeface and weight/style.

Play Mode

• ▶ Play: enter play mode.
• D-pad: move through the maze (it’s draggable on screen).
• Green square: start. Red square: finish.

Solve + Hard Mode

• Solve: finds and shows solution paths.
• Hard Mode: generates a maze, then blocks parts of the shortest routes to force longer detours while keeping the puzzle solvable.

Tips & Troubleshooting

• Performance: increase Cell Size, reduce blur, or avoid very large images.
• Background removal fails: try again, or turn off depth refinement first.
• Pattern alignment feels off: adjust Image Placement (Scale/Pan).
• Nothing shows up from the image: go to Thresholds and increase Pattern Intensity, then tweak thresholds/cleanup.

Shortcuts

• Mask editor pan: hold Space or Alt and drag (desktop), or use the Pan tool (mobile).
• Straight strokes: hold Shift while painting.
• Close dialogs: Esc