def to_ascii_from_image(image,
name='image',
invert=True,
char_type=CharType.BRAILLE,
image_type=ImageType.DITHER):
"""
convert to text via the following steps:
1. fit image to terminal screen size
2. invert image if needed
3. convert image based on given ImageType
4. convert pixels in image to their given CharType equivalent
5. join the 2d image array into a single string
"""
image = Helper.fit_image_to_terminal(image, char_type == CharType.BRAILLE)
if invert:
image = ImageHelper.invert(image)
image = ImageHelper.convert_image(image, image_type)
text_array = convert_to_text(image, char_type)
ascii_text = setup_text_image(text_array)
if ImageHelper.DEBUG:
store_text(ascii_text, name)
return ascii_text
