ImageAsASCII Class¶

class ImageAsASCII:
    """Class to Convert RGB/GRAYSCALE Images to ASCII (Text) format."""

    def __init__(self, image_path=None, desired_width=90):
        """intializes an object of ImageAsASCII class. A user need to
        specify desired (ascii) image width and the path of RGB/Gray Image.

        Args:
            desired_width (int, optional): width of the desired output ASCII Image.
            image_path (str, optional):path of the input image. If None then conversion will not work.
        """

        if not image_path:
            raise ValueError

        self.ascii_str_map = [" ", *("*$+?.%;:,@")]
        self.ascii_image = ""
        self.image = Image.open(image_path).convert("L")

        desired_height = desired_width * self.image.height / self.image.width
        self.image = self.image.resize((ceil(desired_width), ceil(desired_height)))

    def map_to_ascii(self):
        """map each pixel of indvidual image to a respective ascii value from ascii_str_map.
        This is achieved by deviding each pixel to ca. 10 equal parts (//25) and then maped to respecive value.
        """

        str_container = ""  # a container to hold ascii charcters
        for pixel in self.image.getdata():
            str_container += self.ascii_str_map[pixel // 25]

        self.ascii_image = "#\t"  # Now transform the string container to column format.
        for i in range(0, len(str_container), self.image.width):
            self.ascii_image += (
                " ".join(str_container[i : i + self.image.width]) + "\n#\t"
            )