Ascii art generation

Project to generate art using Ascii characters
#hactoberfest2022

Author: siyapandeyvsp

Ascii_art/README.md

@@ -0,0 +1,30 @@
+# ascii-art
+
+## Description
+This Project will take an image and print out an [ASCII-art](https://en.wikipedia.org/wiki/ASCII_art).
+
+## About this Project
+This project uses [opencv](https://www.opencv.org) to process image and [numpy](https://numpy.org) to manipulate arrays. The Image is numerically coded for different threshold regions it comes under and for each coded regions , a symbol is used for printing it out in the stdout.
+
+## Usage
+Use the Script [make_art.py](https://github.com/Shiny-Akash/python-mini-projects/blob/ascii-art/projects/asciiart/make_art.py) .
+In the command line, Enter
+
+`python3 make_art.py [image_path]`
+
+Replace the `[image_path]` with the image you want to do ascii-art. By default it takes [sample_image.png](https://github.com/Shiny-Akash/python-mini-projects/blob/ascii-art/projects/asciiart/sample_image.png)
+
+## Customization
+There are two things you can customize in [make_art.py](https://github.com/Shiny-Akash/python-mini-projects/blob/ascii-art/projects/asciiart/make_art.py).
+
+* `symbols_list`
+* `threshold_list`
+
+Modify the threshold list to take **different threshold values** thereby changing the patterns in the printed image.
+Modify the symbols list to substitute **different symbols** in the coded patterns.
+
+## Sample
+Input Image :
+![input_image](sample_image.png)
+Output :
+![output_image](sample_output.png)

Ascii_art/make_art.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+
+import cv2
+import numpy as np
+
+import sys
+
+symbols_list = ["#", "-", "*", ".", "+", "o"]
+threshold_list = [0, 50, 100, 150, 200]
+
+def print_out_ascii(array):
+    """prints the coded image with symbols"""
+
+    for row in array:
+        for e in row:
+        	# select symbol based on the type of coding
+            print(symbols_list[int(e) % len(symbols_list)], end="")
+        print()
+
+
+def img_to_ascii(image):
+    """returns the numeric coded image"""
+
+    # resizing parameters
+    # adjust these parameters if the output doesn't fit to the screen
+    height, width = image.shape
+    new_width = int(width / 20) 
+    new_height = int(height / 40)
+
+    # resize image to fit the printing screen
+    resized_image = cv2.resize(image, (new_width, new_height),)
+
+    thresh_image = np.zeros(resized_image.shape)
+
+    for i, threshold in enumerate(threshold_list):
+        # assign corresponding values according to the index of threshold applied
+        thresh_image[resized_image > threshold] = i
+    return thresh_image
+
+
+if __name__ == "__main__":
+
+    if len(sys.argv) < 2:
+        print("Image Path not specified : Using sample_image.png\n")
+        image_path = "sample_image.png"  # default image path
+
+    if len(sys.argv) == 2:
+        print("Using {} as Image Path\n".format(sys.argv[1]))
+        image_path = sys.argv[1]
+
+    image = cv2.imread(image_path, 0)  # read image
+
+    ascii_art = img_to_ascii(image)
+    print_out_ascii(ascii_art)

Ascii_art/requirements.txt

@@ -0,0 +1,2 @@
+opencv-python==4.3.0.36
+numpy==1.19.1