Mandarinizer

A Python program that converts image files, video files or live webcam stream to pixel art consisting of Chinese characters.

A web version can be found on this branch.

龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 丿 丶 丶 太 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 蟲 龘 龘 龘 龘 龘 丶 丶 丶 大 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 龘 龘 龘 龘 龘 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 龘 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 丶 丶 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 丶 丶 龘 龘 龘 丶 龘 丿 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 丶 丶 龘 龘 丶 丶 龘 壵 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 丶 丶 龘 丶 丶 龘 掱 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 丶 丶 壵 丶 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 丶 丶 丶 丶 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 丶 丶 壵 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 尛 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 丶 龘 龘 龘 龘 丶 丶 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 

Above is a sample output of Mandarinizer logo

Prerequisites

If you only want to use player.py, you can skip this part.

However, in order to use mandarinizer.py, you need to have opencv-python installed. To install the package:

Linux

pip install opencv-python

macOS

Follow the instruction here.

Usage

mandarinizer.py

usage: mandarinizer.py [-h] [--version] [-inv] [-p] [-f] [-s] [-w WIDTH]
                       [-fps FRAMERATE] [-d {2,4,8,16}]
                       [-c CHARACTER [CHARACTER ...]] [-v VIDEO]
                       [-i IMAGE [IMAGE ...]] [-o OUT]

Mandarinize an image file, a video file or a webcam stream.

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -inv, --invert        invert the color of the frame
  -p, --preview         toggle preview
  -f, --flip            toggle the vertical flip of the frame
  -s, --space           add a space between every two characters
  -w WIDTH, --width WIDTH
                        specify the width of the output
  -fps FRAMERATE, --framerate FRAMERATE
                        specify the frames per second
  -d {2,4,8,16}, --depth {2,4,8,16}
                        specify the color depth
  -c CHARACTER [CHARACTER ...], --character CHARACTER [CHARACTER ...]
                        specify a list of characters by the order of indensity
  -v VIDEO, --video VIDEO
                        path to the video file
  -i IMAGE [IMAGE ...], --image IMAGE [IMAGE ...]
                        paths to the image files
  -o OUT, --out OUT     path to the ouput file

player.py

usage: player.py [-h] [-fps FRAMERATE] filename

positional arguments:
  filename              path to file

optional arguments:
  -h, --help            show this help message and exit
  -fps FRAMERATE, --framerate FRAMERATE
                        specify the frames per second

License

Mandarinizer is licensed under the MIT License.