img2ascii 1.1.6

Image/Video to ASCII conversion

Image2ASCII

img2ascii is a library written in python which can convert image or video files to ASCII

Option list:

• -h or --help : To generate the help text
• -m or --mode : Select the mode of operation -- t for text, i for image, v for video and w for webcam input
• -c or --color : Optional parameter to select color mode. 0 - B/W, 1 - Grayscale and 2 - RGB. Default color mode is B/W
• -k or --kernel : Optional parameter to set the kernel size, default is 7px
• -d or --density : Optional parameter to set the ASCII text density on image, default is 0.3 units; Range - (0,1) (exclusive)
• -i or --ifile : Path to the input file for image and video modes
• -o or --ofile : Path to the output file for image and video modes
• -s or --cam_source : Camera to be used for webcam mode. Use 0,1,2,3... to select cameras connected to the PC. Default value is 0
• -f or --fancy : Fancy mode :). (Color mode defaults to RGB)

Installation:

• Direct install : - pip install img2ascii
• From Git :
  1. git clone https://github.com/gopaljigaur/img2ascii.git
  2. cd img2ascii
  3. python3 setup.py build
  4. python3 setup.py install

Usage :

• For text : img2ascii.py -m <mode>[t=text] -i <inputfile> -o <outputfile> -k <kernel_size>[optional] -d <text_density>[optional]
• For image : img2ascii.py -m <mode>[i=image] -c[color mode (optional)] -i <inputfile> -o <outputfile> -k <kernel_size>[optional] -d <text_density>[optional] -f <fancy_mode>[optional]
• For video : img2ascii.py -m <mode>[v=video] -c[color mode (optional)] -i <inputfile> -o <outputfile> -k <kernel_size>[optional] -d <text_density>[optional] -f <fancy_mode>[optional]
• For webcam : img2ascii.py -m <mode>[w=webcam] -c[color mode (optional)] -k <kernel_size>[optional] -d <text_density>[optional -s <source_camera (0,1,2...)>[optional] -f <fancy_mode>[optional]

Usage in python code:

• For image : from img2ascii import text_gen
  then text_gen.generate_ascii_t(str inputfile, str outputfile, int kernel [o], float density [o])
  
• For image : from img2ascii import image_gen
  then image_gen.generate_ascii_i(str inputfile, str outputfile, int color [o], int kernel [o], float density [o], bool fancy [o])
  
• For video : from img2ascii import video_gen
  then video_gen.generate_ascii_v(str inputfile, str outputfile, int color [o], int kernel [o], float density [o], bool fancy [o])
  
• For webcam : from img2ascii import image_gen
  then image_gen.generate_ascii_w(int color [o], int kernel [o], float density [o], int cam_source [o], str cam_name [o], bool fancy [o])

NOTE : Parameters followed by [o] are optional