Skip to main content

Convert your text to a grayscale image and back.

Project description

Easily convert your text to grayscale images and vice versa.

With this tool you can encode text or plain text files to a grayscale image to be easily shared. Each pixel represents a single character’s decimal value. When decoding an image you can decode text straight to the console or to a plain text file.

Images use a PNG file extension. The image size will be automatically be set depending on the text length to be encoded.

Text should use a character encoding scheme using 8 bits or less until additional functionality is added to support UTF-8 (16 bit). If a character’s decimal value is greater than the limit (see below) the it will be divided by the limit and the new value used. When the character value equals the limit value the new value will be 1.

The limit value passed using either command line argument -l(–limit) specifies the decimal value limit for pixel values starting from 1. The default is 256 allowing for numbers from 0 to 255 (i.e. 8 bit pixels). If the limit value is greater than 8 bits then the value will still be wrapped around since the output image is grayscale.

Requirements

  • Python 3.x

  • Pillow (PIL fork)

Install

You can install text_to_image using pip or setup.py

  • Using pip

    $> pip3 install text_to_image
  • Using setup.py. First navigative to the root directory where setup.py is located then run

    $> python3 setup.py install

How to Use

Once installed you can either directly use the encode.py and decode.py file or import and use the relevant functions.

  • Using the encode.py

    $> python3 encode.py -t "Hello World!" image.png  # encodes given text
    $> python3 encode.py -f my-text-file.txt image.png  # encodes a text file
    $> python3 encode.py --help  # for more information on arguments
  • Using decode.py

    $> python3 decode.py image.png  # decodes a given image
    $> python3 decode.py -f my-text-file.txt image.png  # decodes image.png to the given text file
    $> python3 decode.py --help  # for more information on arguments
  • Importing

    import text_to_image
    
        encoded_image_path = text_to_image.encode("Hello World!", "image.png")
        encoded_image_path = text_to_image.encode_file("input_text_file.txt", "output_image.png")
    
        decoded_text = text_to_image.decode("encoded_image.png")
        decoded_file_path = text_to_image.decode_to_file("encoded_image.png", "output_text_file.txt")

Tests

To run tests, navigate to the root directory where setup.py is located and run

$> python3-m unittest discover tests -v

Another image example:

TODO:
  • Add custom image sizes.

  • Expand pixel value to allow for UTF-8 characters.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

text_to_image-0.0.5.tar.gz (6.3 kB view details)

Uploaded Source

File details

Details for the file text_to_image-0.0.5.tar.gz.

File metadata

File hashes

Hashes for text_to_image-0.0.5.tar.gz
Algorithm Hash digest
SHA256 e5484c94ec6c2143e3aee2a7e839e6060dd8eee948470b786272f27e2ba78947
MD5 a7677a4a77c8a560b3f9c80b0b42e231
BLAKE2b-256 1de2740b0270f1ca06ccdab62c599e0148732e16d056f42c7f8ea9d1d69d3412

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page