Metadata-Version: 2.1
Name: image2char
Version: 0.1.2
Summary: small tool to transfer image between cmd char
Home-page: https://github.com/cpak00/image2char
Author: cpak00
Author-email: cymcpak00@gmail.com
License: MIT Licence
Description: # image2char
        
        <!-- TOC -->
        
        - [image2char](#image2char)
            - [description](#description)
            - [console tool](#console-tool)
                - [install](#install)
                - [input args and get chars](#input-args-and-get-chars)
                - [help](#help)
            - [code](#code)
        
        <!-- /TOC -->
        
        ## description
        
        this module can change image to char[], can be printed at console beautiful
        
        effect:
        
        ![](https://raw.githubusercontent.com/cpak00/image2char/master/input1.jpg)
        -->
        ![](https://raw.githubusercontent.com/cpak00/image2char/master/output1.png)
        
        ![](https://raw.githubusercontent.com/cpak00/image2char/master/input2.png)
        -->
        ![](https://raw.githubusercontent.com/cpak00/image2char/master/output2.png)
        
        `this QR Code can even be recognized when density>=0.6`
        
        
        ## console tool
        
        right click the title bar of cmd, and choose properties, then you can change the size of the fonts in order to fully show the char image
        
        ### install
        ```shell
        pip install image2char
        or
        pip3 install image2char
        ```
        
        ### input args and get chars
        ```shell
        imagetochar -h
        
        imagetochar input1.jpg 
        
        imagetochar input2.png -d 0.6 -r -s 1 -c "█　" //this is QR Code
        
        imagetochar -u "https://raw.githubusercontent.com/cpak00/image2char/master/input1.jpg" -d 0.7 -w 300 -r //this is Url Image
        ```
        
        ### help
        ```
        usage: imagetochar.py [-h] [-d DENTISY] [-s SCALE] [-r] [-c CHARSET] [-u]
                             [-w WIDTH]
                             image
        
        welcome to imagetochar cmd tool 你可以使用这个工具将本地/网络的图片转成字符画
        
        positional arguments:
          image
        
        optional arguments:
          -h, --help            show this help message and exit
          -d DENTISY, --dentisy DENTISY
                                dentisy, 分辨率, 取值0-1 默认为0.5
          -s SCALE, --scale SCALE
                                scale, 字符集高宽比, 默认为2
          -r, --reversed        reversed, 是否翻转黑白
          -c CHARSET, --charset CHARSET
                                charset, 字符集, 默认使用经典ascii字符集
          -u, --url             是否使用url, 将image_path路径设定为url
          -w WIDTH, --width WIDTH
                                改变图片的初始宽度
        ```
        
        ## code
        
        ```python
        from image2char import tool
        from PIL import Image
        import logging
        
        img_path1 = 'image2char/input1.jpg'
        img_path2 = 'image2char/input2.png'
        
        if __name__ == '__main__':
            logging.basicConfig(level=logging.DEBUG)
        
            img1 = Image.open(img_path1)
            img2 = Image.open(img_path2)
            
            matrix = tool.to_chars(img1, density=0.5, scale=2, reversed=True)
            logging.info('matrix: %d, %d' % (len(matrix), len(matrix[0])))
            for i in range(len(matrix)):
                print(''.join(matrix[i]))
        
            char_list = '''█　'''
            scanner = tool.get_scanner(density=0.6, scale=1)
            # reversed=True: in windows console, the char is white
            scanner.scan(img2, reversed=True, char_list=char_list)
            scanner.print_result()
        ```
Keywords: image,char,transfer,cmd,shell
Platform: any
Description-Content-Type: text/markdown
