Styles#

Styles refer to the different image processing algorithms that are performed on input images. They affect how images look when viewed in the text form.

Procedure#

Although the different styles use algorithms that produce different results, there are many common, yet fundamental, steps involved in the entire process. Picharsso defines a BaseDrawer that abstracts this general procedure.

Initialization#

This step assigns values to the parameters for the algorithms.

Dimensions#

Picharsso provides control over the dimensions of the output text with the height and width parameters.

Consider the following image:

Here's what it should look like:

height = 32

terminal height

width = 32

terminal width

Resampling Filter#

There are instances when an input image must be scaled to an appropriate size before it can be used as input for an algorithm. During this resizing process, pixels must sampled/ resampled to generate the new, resized, image.

Picharsso uses the resampling filters that come with Pillow. The choice of the resampling filter is defined by the resample parameter.

Consider the following image:

Here's what it should look like:

resample = 'nearest'

'box'

'bilinear'

'hamming'

'bicubic'

'lanczos'

Normalization#

Pillow supports multiple image modes. For simplicity, the algorithms were designed to work on the RGB image mode. Hence, images must be converted appropriately.

Conversion#

This step lies at the heart of each style.

Resizing#

Before the image can be processed, it must be resized appropriately. The scale of the resizing depends on the processing algorithm.

Processing#

The resized image is processed into a text_matrix.

Formatting#

Before it can be displayed, the text_matrix must be formatted into a single string. The type of formatter used is defined by the mode parameter.

Varieties#

All the following styles are implemented using a drawer which inherits from the BaseDrawer.

Consider the following image:

Here's what it should look like:

Braille#

The Braille style is implemented using the BrailleDrawer.

Gradient#

The gradient style is implemented using the GradientDrawer.