Skip to main content

A very compact representation of an image placeholder

Project description

thumbhash-py

A Python port of the thumbhash encoder by Evan Wallace

Installation

Install thumbhash with pip

pip install thumbhash-py

Optionally install with pillow support:

pip install thumbhash-py[pillow]

Usage

Encode a RGBA array to a ThumbHash

from thumbhash import rgba_to_thumb_hash


rgba = [100, 85, 15, 255, 100, 84, 32, 255,...]
width = 100
height = 75

thumb_hash = rgba_to_thumb_hash(rgba, width, height) # [86, 8, 10, 13, 128, 22, 234, 86, 111, 117, ...]

Open an image using pillow, scale down to max dimensions of 100x100 and encode to a ThumbHash

from thumbhash import image_to_thumb_hash

thumb_hash = image_to_thumb_hash('image.jpg') # [86, 8, 10, 13, 128, 22, 234, 86, 111, 117, ...]

Features

As of now this library only handles the conversion of images to hashes, not the reverse.

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

thumbhash-0.1.2.tar.gz (13.8 kB view hashes)

Uploaded Source

Built Distribution

thumbhash-0.1.2-py3-none-any.whl (5.1 kB view hashes)

Uploaded Python 3

Supported by

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