Description

As you mentioned in reddit post, pictures of matrix can be broken due to browsers "smart" behaviour. This problem is on README too

Code

Not the code, only ask for use picture in README

Output

Will add picture in "Anything else?" section as I am not certain in posting picture here

Anything else?

Example:

Description

One "nice to have" feature could be the addition of matrices that use other character sets for rendering. One nice set could be ▖▗▘▝▀▄▌▐▚▞▙▛▜▟█, i.e. a 2x2 grid per character.

This could be accomplished by extracting all the character set dependent code into a subclass and leave an ABC that makes use of __getitem__, __setitem__, __init__, and render provided by the subclass.

Code

from dotmatrix import BlockMatrix

m = BlockMatrix(16, 8)

m.rectangle((0, 0), (15, 7))

print(m.render())

Output

▛▀▀▀▀▀▀▜
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▙▄▄▄▄▄▄▟

Anything else?

No response

Closes #2

What's the idea?

One "nice to have" feature could be the addition of matrices that use other character sets for rendering. One nice set could be ▖▗▘▝▀▄▌▐▚▞▙▛▜▟█, i.e. a 2x2 grid per character.

Code

from dotmatrix import BlockMatrix

m = BlockMatrix(16, 8)

m.rectangle((0, 0), (15, 7))

print(m.render())

Output

▛▀▀▀▀▀▀▜
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▙▄▄▄▄▄▄▟

from issue

How did I accomplish this?

To implement this I added the Display protocol/abstraction which describes all methods required for setting/getting pixel values and rendering said values to some useful output. The Braille logic has been moved to such a display (at dotmatrix.displays.Braille and remains the default display type. In addition to this I've also implemented a unicode block character display at dotmatrix.displays.Block.

Code

from dotmatrix import Matrix
from dotmatrix.displays import Block

m = Matrix(16, 16, display=Block)

m.rectangle((0, 0), (15, 15))
m.circle((7, 7), 7)

print(m.render())

Output

█▀▀██▀▀▀▀▀██▀▀▀█
█▄▀         ▀▄ █
█▀           ▀▄█
█             ██
█             ██
██           █ █
█ ▀▄▄     ▄▄▀  █
█▄▄▄▄█████▄▄▄▄▄█

Closes #2

What's the idea?

One "nice to have" feature could be the addition of matrices that use other character sets for rendering. One nice set could be ▖▗▘▝▀▄▌▐▚▞▙▛▜▟█, i.e. a 2x2 grid per character.

Code

from dotmatrix import BlockMatrix

m = BlockMatrix(16, 8)

m.rectangle((0, 0), (15, 7))

print(m.render())

Output

▛▀▀▀▀▀▀▜
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▌      ▐
▙▄▄▄▄▄▄▟

from issue

How did I accomplish this?

To implement this I added the Display protocol/abstraction which describes all methods required for setting/getting pixel values and rendering said values to some useful output. The Braille logic has been moved to such a display (at dotmatrix.displays.Braille and remains the default display type. In addition to this I've also implemented a unicode block character display at dotmatrix.displays.Block.

Code

from dotmatrix import Matrix
from dotmatrix.displays import Block

m = Matrix(16, 16, display=Block)

m.rectangle((0, 0), (15, 15))
m.circle((7, 7), 7)

print(m.render())

Output

█▀▀██▀▀▀▀▀██▀▀▀█
█▄▀         ▀▄ █
█▀           ▀▄█
█             ██
█             ██
██           █ █
█ ▀▄▄     ▄▄▀  █
█▄▄▄▄█████▄▄▄▄▄█

Description

It would be nice to be able to rotate/transpose/crop/shift/etc. any give matrix.

Code

from dotmatrix import Matrix

m = Matrix(5, 5)

print("Initial")
m.polygon((0, 0), (0, 4), (4, 4))
print(m.render())

print("Transposed")
m.transpose()
print(m.render())

Output

Initial
⡗⢄⠀
⠉⠉⠁
Transposed
⠙⢍⡇
⠀⠀⠁

Anything else?

No response

Description

An amazing feature would be the ability to render a given image onto a dotmatrix. And to make things prettier some sort of dithering, be it Floyd-Steinberg or Atkinson or something else entirely, would also be nice.

Code

import dotmatrix as dm

m = dm.Matrix(256, 256)

m.blit(
    "path/to/my/image",
    area=((63, 63), (191, 191)),  # The area to blit the image to.
    dither=dm.dither.Floyd        # The dithering algorithm to use.
)

print(m.render())

or

import dotmatrix as dm
from PIL import Image


m = dm.Matrix(256, 256)
img = Image.open("path/to/my/image")

m.blit(
    img,
    area=((63, 63), (191, 191)),  # The area to blit the image to.
    dither=dm.dither.Floyd        # The dithering algorithm to use.
)

print(m.render())

Output

No response

Anything else?

Example: DotArt by Garrett Albright

The latter example usage would require pillow as dependency. Thus it might be sensible to block this feature behind an "import guard" and add pillow as an extra-install-option, àla dotmatrix[images].