]> Untitled Git - axy/ft/a-maze-ing.git/commitdiff
Showcase and extras in readme
authorAxy <gilliardmarthey.axel@gmail.com>
Mon, 30 Mar 2026 02:50:49 +0000 (04:50 +0200)
committerAxy <gilliardmarthey.axel@gmail.com>
Mon, 30 Mar 2026 02:50:49 +0000 (04:50 +0200)
README.md
animations_scrolling.mp4 [new file with mode: 0644]
error_handling.png [new file with mode: 0644]
flexible_layout.mp4 [new file with mode: 0644]
minimal_visual_screensaver.conf [new file with mode: 0644]

index 8f36542ba7b3b2f656d0eaa0ef0f63f7544a1d08..1e6c3958e04212807b623a80bdb51a0418229f38 100644 (file)
--- a/README.md
+++ b/README.md
@@ -2,6 +2,23 @@
 A-maze-ing consists of making a maze generator, with a pattern in the middle, and visualiser, which outputs to a file in a specific format.
 The project is configured through a config format whose format is specified in the [Configuration](#Configuration)
 
+# Overview
+
+## Features:
+
+- Customizeable looks for the visualizer!
+- Fancy error reporting
+- Animations, colors, and scrolling for large mazes
+- Flexible displaying, using adaptive layouts
+- ðŸš€ Blazingly slow ðŸš€ thanks to python limitations
+- No runtime dependencies
+
+## Showcase
+
+![Fancy error reporting!](./error_handling.png)
+![Animations, colors, and scrolling!](./animations_scrolling.mp4)
+![Flexible layout!](./flexible_layout.mp4)
+
 # Instructions
 
 To install or run the library, do the following:
@@ -157,4 +174,11 @@ Very little LLM assistance has been utilized, an attempt was made to use them to
 - Current build system
 - This documentation
 
+# Retrospect
+
+The project has generally been overly complex, certain approaches abandonned for the sake of time, notably shortest path pruning through subcountour bounding volume higherarchies, for which stubs can be found in the AVL implementation.
+
+Although a lot of code is present, it should be noted that said code achieves a lot of features and through that lens, the complexity is somewhat justified.
+Some things might be better refactored but the current state of the project is workable-enough for use, and spending more time on this might be excessive.
 
+Feature creep might generally be considered an issue, and we have definitely gone through our fair share, but as an approach to learning it managed to make a fairly simple project very enriching.
diff --git a/animations_scrolling.mp4 b/animations_scrolling.mp4
new file mode 100644 (file)
index 0000000..eb36cc1
Binary files /dev/null and b/animations_scrolling.mp4 differ
diff --git a/error_handling.png b/error_handling.png
new file mode 100644 (file)
index 0000000..70e41aa
Binary files /dev/null and b/error_handling.png differ
diff --git a/flexible_layout.mp4 b/flexible_layout.mp4
new file mode 100644 (file)
index 0000000..9bab9e6
Binary files /dev/null and b/flexible_layout.mp4 differ
diff --git a/minimal_visual_screensaver.conf b/minimal_visual_screensaver.conf
new file mode 100644 (file)
index 0000000..57fc7fc
--- /dev/null
@@ -0,0 +1,9 @@
+WIDTH=40
+HEIGHT=40
+ENTRY=1,1
+EXIT=24,24
+OUTPUT_FILE=maze.txt
+PERFECT=True
+VISUAL=True
+SCREENSAVER=True
+SEED=621