From 8ef3734963d056b75be2db9549c346202ddc5fbb Mon Sep 17 00:00:00 2001
From: AeroAstroid <aeroastroid@gmail.com>
Date: Wed, 28 Sep 2022 13:46:45 -0300
Subject: [PATCH] First-pass charmap generator script

---
 examples/example_charmap_img.png | Bin 0 -> 224 bytes
 res/gen_charmap.py               | 119 +++++++++++++++++++++++++++++++
 2 files changed, 119 insertions(+)
 create mode 100644 examples/example_charmap_img.png
 create mode 100644 res/gen_charmap.py

diff --git a/examples/example_charmap_img.png b/examples/example_charmap_img.png
new file mode 100644
index 0000000000000000000000000000000000000000..8df4d307a65c23e47d59fd02a58b64d7725c7bd8
GIT binary patch
literal 224
zcmeAS@N?(olHy`uVBq!ia0y~yU<5K5!6ZWo=hV|c-f~YD$B>FSZ!akF9dZz1d$@l#
z?@EUSvrJYxgxIz^Eew!Zyej<xo64L;UCC?IJdUshI<E2%l{(5A*Q7QxaPj^m^KH9i
zFWY&(bCve}elkvNr}(L_25V-Wcm1S4<-BXDh56|}AN2QJJ-0RO=GFZgx!ace1wD^H
svv<;_DXRbLLLW3R^H~rk>R*3g?efaV=-K4M1avZkr>mdKI;Vst08T1a-v9sr

literal 0
HcmV?d00001

diff --git a/res/gen_charmap.py b/res/gen_charmap.py
new file mode 100644
index 0000000..7db0053
--- /dev/null
+++ b/res/gen_charmap.py
@@ -0,0 +1,119 @@
+#!/usr/bin/env python3
+from PIL import Image, UnidentifiedImageError
+
+CHAR_SIZE = 8
+CHARS_COL = 32
+CHARS_ROW = 32
+
+STD_IMG_W = CHARS_COL * CHAR_SIZE
+STD_IMG_H = CHARS_ROW * CHAR_SIZE
+
+HEADER = f"""
+-- File defining the character to pixel mapping
+
+WIDTH={CHAR_SIZE};
+DEPTH={CHARS_COL * CHARS_ROW * CHAR_SIZE};
+
+ADDRESS_RADIX=UNS;
+DATA_RADIX=BIN;
+
+CONTENT BEGIN
+
+"""
+
+def generate_from_img(f_name):
+    '''
+    Main routine for the program's function flow, taking in a file name 
+    corresponding to a 256x256 image as input (32x32 characters of 8x8 each)
+
+    The standard dimensions can be customized via the constants above
+    '''
+
+    try:
+        bit_img = Image.open(f_name)
+    except FileNotFoundError as e:
+        print(e)
+        return 1
+    except UnidentifiedImageError as e:
+        print(f"The file {f_name} does not correspond to an image!")
+        return 1
+    
+    img_h, img_w = bit_img.size
+
+    if img_h < STD_IMG_W or img_w < STD_IMG_H:
+        print(f"Image dimensions are too small (min {img_h}x{img_w})")
+        return 1
+    
+    bit_img = bit_img.crop((0, 0, STD_IMG_W, STD_IMG_H))
+    
+    if bit_img.mode != '1':
+        bit_img = bit_img.convert('1')
+    
+    full_matrix = []
+
+    last_distinct_line = -1
+    last_line_bits = 'xxxxxxxx'
+
+    for char_y in range(CHARS_ROW):
+        full_matrix.append([])
+
+        for char_x in range(CHARS_COL):
+            full_matrix[-1].append("")
+
+            for bit_y in range(8):
+                line_bits = ""
+
+                py = char_y * 8 + bit_y
+                
+                line_n = char_y * CHARS_COL * 8 + char_x * 8 + bit_y
+
+                for bit_x in range(8):
+                    px = char_x * 8 + bit_x
+                    line_bits += str(bit_img.getpixel((px, py)) // 255)
+                
+                distinct = last_line_bits != line_bits
+
+                if distinct:
+                    if last_distinct_line != -1:
+                        if last_distinct_line == line_n - 1:
+                            full_matrix[-1][-1] += (
+                                f"\t{line_n - 1}  :   {last_line_bits}\n")
+                        
+                        else:
+                            c_range = f"[{last_distinct_line}..{line_n-1}]"
+                            full_matrix[-1][-1] += (
+                                f"\t{c_range}  :   {last_line_bits}\n")
+                    
+                    last_line_bits = line_bits
+                    last_distinct_line = line_n
+                
+                if bit_y == 7:
+                    if distinct:
+                        full_matrix[-1][-1] += (
+                            f"\t{line_n}  :   {last_line_bits}\n")
+
+                    else:
+                        c_range = f"[{last_distinct_line}..{line_n}]"
+                        full_matrix[-1][-1] += (
+                            f"\t{c_range}  :   {last_line_bits}\n")
+                    
+                    last_distinct_line = -1
+                    last_line_bits = 'xxxxxxxx'
+    
+    full_matrix = "\n".join(["\n".join(row) for row in full_matrix])
+
+    with open('res/charmap.mif', 'w') as f:
+        f.write(HEADER + full_matrix + "\nEND")
+    
+    return 0
+
+
+if __name__ == '__main__':
+    f_name = input("File name for the image to use for charmap generation: ")
+
+    error_code = generate_from_img(f_name)
+
+    if error_code:
+        quit()
+    
+    print(f"Saved a charmap with {CHARS_COL * CHARS_ROW} characters")
\ No newline at end of file