about summary refs log tree commit diff stats
path: root/README.org
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.org
parent6acf653f443247a76fb767731eb2bdbc90bbb066 (diff)
downloadfornax-846b64b766f7eccdd3696603bf44b54231f03fa6.tar.gz
Document iteration grids
Diffstat (limited to 'README.org')
-rw-r--r--README.org27
1 files changed, 25 insertions, 2 deletions
diff --git a/README.org b/README.org
index b2b6778..abd8028 100644
--- a/README.org
+++ b/README.org
@@ -12,6 +12,11 @@ This collection includes:
 - Algorithms: Various algorithms solved in several programming
   languages.
 
+* Documentation
+
+Fornax parses /Fornax format/, generates a ~PNG~ for each iteration which is
+later converted to a slideshow with ~ffmpeg~.
+
 * Fornax Format
 
 Fornax format is an intermediate output file generated after solving the
@@ -28,8 +33,26 @@ that is to be included in the final video. Since the number of rows and
 columns is known, the whole grid should be printed in a 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.
+
+** Grids
+
+A grid is printed for every iteration. Grids are composed of cells.
+
+| Cell             | Symbol |
+|------------------+--------|
+| Path             | ~.~      |
+| Blocked          | ~#~      |
+|------------------+--------|
+| Visited          | ~-~      |
+| Current Position | ~@~      |
+| Destination      | ~$~      |
 
 * Project Structure