about summary refs log tree commit diff stats
path: root/README
diff options
context:
space:
mode:
authorAndinus <andinus@nand.sh>2021-11-03 16:42:30 +0530
committerAndinus <andinus@nand.sh>2021-11-03 16:42:30 +0530
commit846b64b766f7eccdd3696603bf44b54231f03fa6 (patch)
tree13d1979592ea096e291973eef1a2b1c18dc7398a /README
parent6acf653f443247a76fb767731eb2bdbc90bbb066 (diff)
downloadfornax-846b64b766f7eccdd3696603bf44b54231f03fa6.tar.gz
Document iteration grids
Diffstat (limited to 'README')
-rw-r--r--README43
1 files changed, 37 insertions, 6 deletions
diff --git a/README b/README
index cc0c2e0..b527d21 100644
--- a/README
+++ b/README
@@ -10,8 +10,10 @@
 Table of Contents
 ─────────────────
 
-1. Fornax Format
-2. Project Structure
+1. Documentation
+2. Fornax Format
+.. 1. Grids
+3. Project Structure
 
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -27,7 +29,14 @@ This collection includes:
   languages.
 
 
-1 Fornax Format
+1 Documentation
+═══════════════
+
+  Fornax parses /Fornax format/, generates a `PNG' for each iteration
+  which is later converted to a slideshow with `ffmpeg'.
+
+
+2 Fornax Format
 ═══════════════
 
   Fornax format is an intermediate output file generated after solving
@@ -45,11 +54,33 @@ This collection includes:
   single line.
 
   • Every iteration should be separated by a newline.
-  • If the iteration cells is not equal to `rows * columns' then it may
-    be ignored by the program that parses the file.
+
+  • If the iteration cells is not equal to `rows * columns' or `(rows *
+      columns) + 1' then it may be ignored by the program that parses
+      the file.
+
+  • Solved iteration must be preceded by `|' character. The program may
+    or may not use it while rendering the video.
+
+
+2.1 Grids
+─────────
+
+  A grid is printed for every iteration. Grids are composed of cells.
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━
+   Cell              Symbol
+  ──────────────────────────
+   Path              `.'
+   Blocked           `#'
+  ──────────────────────────
+   Visited           `-'
+   Current Position  `@'
+   Destination       `$'
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 
-2 Project Structure
+3 Project Structure
 ═══════════════════
 
   • Algorithms are located in `algorithms/' directory, sub-directory