srwiez/thumbhash

A brief description of your package

Maintainers

Details

github.com/SRWieZ/thumbhash

Source

Issues

Fund package maintenance!
SRWieZ

Installs: 40 778

Dependents: 9

Suggesters: 1

Security: 0

Stars: 138

Watchers: 4

Forks: 5

Open Issues: 0

v1.3.0 2024-10-16 06:10 UTC

Requires

  • php: ^7.3 || ^8.0

Requires (Dev)

MIT 3983c6f1aec32d8a037cc66175c0550f12c3f9e2

  • Eser DENIZ <srwiez.woop@gmail.com>

This package is auto-updated.

Last update: 2024-11-26 22:38:03 UTC

README

Tests Latest Stable Version

Thumbhash PHP is a PHP library for generating unique, human-readable identifiers from image files. It is inspired by Evan Wallace's Thumbhash algorithm and provides a PHP implementation of the algorithm.

Thumbhash is a very compact representation of a placeholder for an image. Store it inline with your data and show it while the real image is loading for a smoother loading experience. It's similar to BlurHash but with some advantages

Read more and test it here !

Installation

You can install Thumbhash PHP using Composer:

composer require srwiez/thumbhash

⚠️ I highly recommend to have Imagick extension installed on your computer. GD extension has only 7 bits of alpha channel resolution, and 127 is transparent, 0 opaque. While the library will still work, you may have different image between platforms. See on stackoverflow

Usage

To generate a thumbhash for an image file, you can use the Thumbhash\Thumbhash class:

Example to show a thumbhash image from a local file

use Thumbhash\Thumbhash;

$content = file_get_contents($url);

list($width, $height, $pixels) = extract_size_and_pixels_with_imagick($content);

$hash = Thumbhash::RGBAToHash($width, $height, $pixels);
$key = Thumbhash::convertHashToString($hash); // You can store this in your database as a string
$url = Thumbhash::toDataURL($hash);

echo '<img src="' . $url . '" />';

Credits

Thumbhash PHP was created by Eser DENIZ.

It is inspired by the javascript version of Evan Wallace's Thumbhash algorithm.

License

Thumbhash PHP is licensed under the MIT License. See LICENSE for more information.