Search documentation

Find a vivid-layer page or product.

Image Dithering

A configurable image dithering filter for limited-color, pixelated, and retro treatments.

pnpm dlx shadcn@latest add @vivid-layer/image-dithering
Source image

Customize

Size
2
Color Steps
2
Scale
1

API reference

The wrapper adds playback and runtime safeguards while preserving the complete Paper ImageDithering API. See the Paper Image Dithering reference for the full prop table and accepted ranges.

PropTypeDefaultDescription
imagestring | HTMLImageElementrequiredSupplies the source image processed by the dithering shader.
playback"auto" | "always" | "paused""auto"Controls motion policy. Auto pauses for reduced motion and while the shader is outside the viewport.
width / heightnumber | string"100%"Sets the canvas CSS dimensions. Size the parent element to establish the visible area.
maxPixelCountnumber2073600Caps the rendered pixel budget. Override only after measuring the target devices.

Credits

The rendering engine is Paper Shaders, distributed under the Apache License 2.0. The example image is Scott Webb's Banff landscape, released under CC0. vivid-layer supplies the adapter, playback and loading policies, documentation, and Registry packaging.