Placeholders & Dithering

blurhash(int $width = 32, int $height = 32, int $componentsX = 4, int $componentsY = 3)

Generate compact placeholder images using DCT encoding. Produces a tiny representation of the image that can be decoded client-side for a blurred preview.

$placeholder = $image->blurHash();
echo $placeholder; // cached blurhash image URL

Parameters

$image->blurHash(width: 64, height: 64);
$image->blurHash(componentsX: 6, componentsY: 4); // more detail

As data URI

Inline the blurhash directly in HTML without a cache file:

$dataUri = $image->blurHash()->toDataUri();
// → data:image/png;base64,...

thumbhash(int $width = 32, int $height = 32)

Generate a compact placeholder image using the ThumbHash algorithm. ThumbHash preserves alpha and generally produces a more faithful preview at the same byte budget as BlurHash, while BlurHash has wider client-library adoption.

$placeholder = $image->thumbHash();
echo $placeholder; // cached thumbhash image URL

Parameters

Unlike BlurHash, ThumbHash does not expose basis-function component counts — the algorithm selects them internally from the source aspect ratio.

As data URI

$dataUri = $image->thumbHash()->toDataUri();
// → data:image/png;base64,...

dither(DitherAlgorithm $algorithm = DitherAlgorithm::Atkinson)

Reduce colors using error-diffusion dithering for an artistic or retro effect.

use Timber\Chainsaw\Enum\DitherAlgorithm;

$image->dither(); // Atkinson (default)
$image->dither(DitherAlgorithm::FloydSteinberg);